Before agents can log in to vicidial.php , you must have a working VICIdial installation with Asterisk properly configured. The web server (Apache or Nginx) must have PHP version 7.x or 8.x (depending on your VICIdial build) with MySQL or MariaDB connectivity to the VICIdial database. Recent VICIdial development updates in 2025 and 2026 have focused heavily on PHP8 compatibility, with numerous patches applied to keep the AGC stable on modern PHP versions.
For organizations seeking to customize or modify the AGC beyond its default configuration, several approaches are available.
When agc/vicidial.php malfunctions, it usually halts call center operations. Here are the most frequent issues and how to resolve them. 1. White Screen or "File Not Found" agc vicidial.php
The script evolved. It grew "hooks" and "flags." It became the central hub where hundreds of developers contributed patches back to the community.
A common mistake is creating users in the admin interface but neglecting to properly assign phone IDs and passwords. If you have created users, remote users, and campaigns in the VICIdial admin but receive "Login incorrect" errors when accessing http://your-server/agc/vicidial.php , the issue is almost always related to missing or mismatched phone credentials. Before agents can log in to vicidial
The path agc/vicidial.php refers to the web page that agents log into to make and receive calls. The letters "agc" historically stand for (Asterisk Graphical User Interface Client), which was the original project name before it evolved into the modern Vicidial suite.
While vicidial.php is a physical file on your server, you should rarely edit its source code directly. Instead, its behavior is controlled through the under Campaigns > Detail View . 1. Agent User Interface Options For organizations seeking to customize or modify the
Proper DNS and SSL certificates are essential if agents will connect from remote offices. Firewall rules should allow HTTP/HTTPS, RTP, and SIP traffic. Agents' softphones or physical phones must be able to register correctly with the Asterisk server before they can successfully log into the AGC.
This API handles backend automation tasks such as lead injection, report retrieval, campaign control, DNC checks, and callback scheduling. It does not require an active agent session.
Add to /etc/asterisk/extensions_custom.conf :
Enables 1-9 keyboard shortcuts for lightning-fast call dispositioning.