Asterisk Manager Interface (AMI)

In diesem Kapitel:

Das Asterisk Manager Interface (AMI) ist ein klassisches TCP-Protokoll auf Port 5038. Ein externes Programm verbindet sich, meldet sich mit Benutzername und Passwort an und kann ab dann:

  • Actions senden — z. B. Originate, Hangup, Redirect, MailboxCount, Command (CLI-Befehl ausführen). Asterisk antwortet synchron mit einer Response.

  • Events empfangen — ungefragt, asynchron: jeder neue Channel, jeder Bridge-Vorgang, jeder Hangup, jede Registrierung löst ein Event aus.

Das Protokoll ist zeilenbasiert mit Key: Value-Paaren, getrennt durch CR/LF, ein Paket endet mit einer Leerzeile. Für Monitoring-Skripte und Integrations-Werkzeuge reicht das völlig.

Für neue Anwendungen, die Gespräche aktiv steuern sollen, empfehlen wir heute ARI: REST-API plus WebSocket-Event-Stream, JSON statt zeilenbasiertem Text, sauberes Call-Control-Modell. AMI bleibt relevant für Monitoring, Alt-Anwendungen und kleine Werkzeuge, die einfach ein Event abgreifen wollen.

Die jeweils aktuelle Liste aller AMI-Actions und -Events steht in der offiziellen Dokumentation unter https://docs.asterisk.org/Latest_API/API_Documentation/AMI_Actions/ und im CLI über manager show commands bzw. manager show events.