Asterisk Manager Interface

The Asterisk Manager Interface (AMI) is a TCP-based control protocol that allows external applications to monitor and control the Asterisk PBX. VICIdial uses AMI as its primary communication channel with Asterisk — sending commands to originate calls, transfer channels, monitor conferences, and retrieve real-time call status. AMI is the essential bridge between VICIdial’s web-based management layer and Asterisk’s telephony engine.

How It Works in VICIdial

AMI operates over a persistent TCP connection (typically port 5038) between VICIdial’s Perl daemon processes and the Asterisk server. VICIdial authenticates to AMI using credentials configured in Asterisk’s manager.conf file. Once connected, VICIdial sends AMI actions (commands) and receives events (notifications) in a text-based protocol.

Key AMI actions used by VICIdial include: Originate (place outbound calls from the hopper), Redirect (transfer calls between channels), Monitor (start/stop recording), ConfbridgeList (query conference participant status), and Hangup (disconnect calls). AMI events notify VICIdial about call state changes — when calls are answered, when agents connect, when transfers complete, and when calls hang up.

VICIdial’s AST_manager_send.pl and AST_manager_listen.pl processes maintain the AMI connection, processing thousands of actions and events per minute on busy servers. The real-time monitoring dashboard gets its data through AMI events.

Why It Matters

AMI is the nervous system of VICIdial — without a functioning AMI connection, VICIdial cannot place calls, monitor agents, or manage conferences. AMI connectivity issues immediately impact all call operations. Common problems include authentication failures (after Asterisk upgrades), connection timeouts (due to network issues), and event flooding (when high call volume overwhelms the AMI socket).

AMI security is also critical. The AMI port should never be exposed to the public internet, and AMI credentials should be strong and unique. Unauthorized AMI access could allow an attacker to originate calls, intercept audio, or disrupt operations. See the VICIdial setup guide for AMI security configuration best practices.