Asterisk Manager Interface (AMI) Definición La AMI es un protocolo basado en TCP que permite a aplicaciones externas observar y controlar un sistema PBX Asterisk. En el ecosistema de VICIdial, es la vía principal que permite al sistema de gestión web de la plataforma comunicarse con las capacidades de telefonía de Asterisk. Implementación en VICIdial Arquitectura de conexión: VICIdial mantiene conexiones TCP persistentes (puerto 5038 por defecto) entre sus procesos daemon en Perl y los servidores Asterisk. La autenticación se realiza mediante credenciales almacenadas en el archivo de configuración manager.conf de Asterisk. La comunicación sigue un formato de protocolo basado en texto tanto para el envío de comandos como para la recepción de eventos. Funciones operativas clave: Originate — inicia llamadas salientes desde la cola del marcador. Redirect — transfiere llamadas entre canales de comunicación. Monitor — habilita/deshabilita la funcionalidad de grabación de llamadas. ConfbridgeList — recupera información de los participantes activos en una conferencia. Hangup — termina conexiones de llamada activas. Procesos de backend: dos procesos Perl críticos gestionan las operaciones de AMI: AST_manager_send.pl maneja el envío de comandos, mientras que AST_manager_listen.pl procesa las notificaciones entrantes. Juntos gestionan miles de operaciones por minuto en momentos de alta actividad. La interfaz de monitoreo en tiempo real obtiene su información de estado directamente a través de los flujos de eventos de AMI. Por qué importa Criticidad del sistema: la AMI es el "sistema nervioso" de VICIdial — sin una conexión AMI funcional, VICIdial no puede realizar llamadas ni gestionar la actividad de los agentes. Cualquier interrupción de conectividad detiene de inmediato toda la operación de marcación. Problemas comunes: Fallas de autenticación tras actualizaciones de Asterisk. Timeouts de conexión por problemas de infraestructura de red. Saturación de eventos cuando el volumen de llamadas supera la capacidad del socket. Consideraciones de seguridad: el puerto de AMI requiere aislamiento de red estricto y nunca debería ser accesible desde internet. Es esencial usar credenciales fuertes y únicas, ya que un acceso no autorizado podría permitir abuso en la originación de llamadas, interceptación de audio o interrupción operativa. Conceptos relacionados Asterisk Asterisk Gateway Interface (AGI) VICIdial Cluster