Custom VICIdial Reports on GitHub

Introducing My New GitHub Repository for Custom VICIdial Reports

Hey there, fellow VICIdial enthusiasts!

I am thrilled to announce the launch of my latest GitHub repository, dedicated to creating custom reports for VICIdial. As a long-time user and developer in the VICIdial community, I understand the importance of having detailed and actionable data at your fingertips. This repository aims to enhance your call center’s efficiency and decision-making process by providing insightful reports tailored to your specific needs.

First Report: Area Code Call Breakdown

The first report available in this repository is the “Area Code Call Breakdown.” This report is designed to give you a comprehensive analysis of the number of calls made to each area code within a specified date range. Whether you are looking to optimize your outbound campaigns or ensure compliance with call regulations, this report will provide valuable insights into your call distribution patterns.

Understanding the New Spam Math for 2025

In light of recent changes to spam regulations, it is crucial to manage your Direct Inward Dial (DID) numbers effectively. According to the new guidelines for 2025, you should aim to keep the number of calls per DID below 50 calls per day. This report will help you achieve that by suggesting the optimal number of DIDs you should have for each area code based on the collected data and a six-day work week.

Here’s how the calculations work:

1. Total Calls to Area Code (per date range): This is the total number of calls made to a particular area code within your specified date range.
2. Daily Call Volume: Divide the total calls by the number of days in the date range to get the average daily call volume.
3. Required DIDs: To ensure each DID handles fewer than 50 calls per day, divide the daily call volume by 50 and round up to the nearest whole number.

For example, if you made 3,000 calls to area code 305 over a six-day period:

• Daily Call Volume: 3,000 calls / 6 days = 500 calls per day
• Required DIDs: 500 calls per day / 50 calls per DID per day = 10 DIDs

Exporting Data to CSV

To make the data even more accessible, this report includes the option to export your findings to a CSV file. This feature allows you to easily share the data with your team, analyze it in spreadsheet software, or integrate it with other systems for further processing.

Get Started Today

Ready to enhance your VICIdial reporting capabilities? Head over to my GitHub repository here to get started. You’ll find detailed instructions on how to set up and run the reports, as well as ongoing updates and new features.

Installation

Go to your “vicidial” directory on your web server. For ViciBox type “cd /srv/www/htdocs/vicidial” and for Redhat(Alma/Rocky/CentOS) type “cd /var/www/html/vicidial” and then clone the repo by typing:

git clone https://github.com/carpenox/Reports.git

Then browse to your server – https://yourserver.com/vicidial/Reports/did_report.php

Thats it, enjoy!

Stay tuned for more custom reports and features coming soon. If you have any suggestions or feedback, feel free to open an issue on GitHub or reach out to me directly on Discord: https://discord.gg/ymGZJvF6hK

Happy dialing!

Chris aka carpenox