Asterisk mit Xcellerate OPS verbinden: Anruferanzeige, Click-to-Call und Anrufprotokoll

Verbinden Sie Ihr eigenes Asterisk mit Xcellerate OPS: Eingehende Anrufe zeigen den passenden Kontakt, jeder Anruf landet in der CRM-Timeline, und Ihr Team ruft Kunden direkt aus OPS an. Für Admins von MSPs und Dienstleistern mit selbst betriebenem Asterisk (ab Version 16).

TL;DR

• OPS verbindet sich per AJAM über HTTPS mit Ihrem Asterisk, mit einem Manager-Benutzer, der nur die Adresse von OPS zulässt.
• Anruferanzeige, Click-to-Call (Ihr eigenes Telefon klingelt zuerst) und Anrufprotokoll in der CRM-Timeline.
• Optional: Aufzeichnungen aus einem geschützten HTTPS-Ordner und ein nächtlicher Abgleich mit Ihrer CDR-Datenbank.

Bevor Sie beginnen

• Sie sind Admin des OPS-Workspace, oder Ihre Rolle darf die Telefonie verwalten.
• Ein Asterisk-Admin, der http.conf, manager.conf und den Dialplan bearbeiten kann. Asterisk ab 16; das Dialplan-Snippet ist mit 18 und 20 getestet.
• OPS muss Ihr Asterisk über HTTPS erreichen. Eine nicht erreichbare Anlage lässt sich noch nicht verbinden.
• Die OPS-Adresse für Ihre Firewall, angezeigt auf der Telefonie-Seite als "Our address, for your firewall" (Unsere Adresse für Ihre Firewall).

Telefonie ist eine Basisfunktion in jedem Tarif.

Schritt 1: Asterisk vorbereiten

AJAM über HTTPS

In http.conf:

enabled = yes
tlsenable = yes
tlsbindaddr = 0.0.0.0:8089

Ein Manager-Benutzer für OPS

Legen Sie in manager.conf einen Benutzer mit langem Secret an, beschränkt auf die OPS-Adresse:

deny = 0.0.0.0/0.0.0.0
permit = <OPS-Adresse>/255.255.255.255
read = call,cdr,reporting,user
write = originate

Lassen Sie die OPS-Adresse in der Firewall zu diesem Port zu.

Optional: Aufzeichnungen und CDR

• Fügen Sie die OPS-Aufzeichnungsmakros (ops-recording und ops-hangup) aus dem veröffentlichten Dialplan-Snippet in Ihre eingehenden und ausgehenden Kontexte ein. Ändern Sie die Dateinamen nicht.
• Stellen Sie den Monitor-Ordner (/var/spool/asterisk/monitor) schreibgeschützt über HTTPS bereit, mit Basic Auth und IP-Allowlist.
• Für den Abgleich: Lesezugriff auf Ihre CDR-Datenbank, zum Beispiel mysql:host=…;dbname=asteriskcdrdb, Tabelle cdr.

OPS schaltet die Aufzeichnung nie selbst ein. Eine Ansage machen Sie im Dialplan, bevor die Aufzeichnung startet. Laden Sie Asterisk neu.

Schritt 2: Asterisk in OPS hinzufügen

Öffnen Sie Settings → Data and security → Telephony (Einstellungen → Daten und Sicherheit → Telefonie), klicken Sie auf Add a phone system (Telefonanlage hinzufügen), wählen Sie Asterisk und vergeben Sie einen Namen.

Die Seite Telefonie mit einer Auswahlliste für die Telefonanlage, einem Namensfeld und dem Hinweis, dass noch keine Telefonanlage verbunden ist.

Füllen Sie Asterisk address (https://pbx.example.com:8089), Manager user (AMI/AJAM), Manager secret aus. Für Aufzeichnungen: Recordings base URL, Recordings user, Recordings password. Für den Abgleich: CDR database DSN, CDR database user, CDR database password. Bei selbstsigniertem Zertifikat setzen Sie Accept this certificate (Dieses Zertifikat akzeptieren). Speichern.

Schritt 3: Testen, Nebenstellen zuordnen, aktivieren

1. Klicken Sie auf Test connection (Verbindung testen). Erwartet: "The PBX answered over AJAM." (Die Anlage hat über AJAM geantwortet) und "A recording source is configured." (Eine Aufzeichnungsquelle ist eingerichtet), sonst ein Hinweis.
2. Nebenstellen werden nicht importiert. Tippen Sie jede Nebenstelle ein und wählen Sie unter Belongs to (Gehört zu) die Person. Für eine Rufgruppe fügen Sie alle mit Add person (Person hinzufügen) hinzu.
3. Klicken Sie auf Enable (Aktivieren) und führen Sie einen Testanruf durch.

Was nach dem Verbinden passiert

• Eingehende Anrufe: OPS liest die Anrufereignisse in kurzen Intervallen. Unten rechts sehen Sie, wer anruft, mit Schaltflächen, um Kontakt oder Firma zu öffnen, ein mit der Nummer vorausgefülltes Ticket anzulegen oder die Nummer als Kontakt hinzuzufügen. Ein weiterverbundener Anruf bleibt ein Anruf.
• Click-to-Call: Mit eigener Nebenstelle (keine Rufgruppe) klingelt zuerst Ihr Telefon, dann der Kunde. OPS überträgt kein Audio. Danach halten Sie das Ergebnis fest.
• Protokoll: Jeder Anruf landet in der CRM-Timeline von Kontakt und Firma, verknüpft mit dem jüngsten offenen Deal. Nicht an Tickets. Unbekannte Nummern kommen in eine eigene Liste; OPS legt nie selbst Kontakte an.
• Verpasste Anrufe benachrichtigen die Person, deren Telefon klingelte, sonst den Deal-Owner.
• Aufzeichnungen werden nach dem Anruf abgerufen, dem richtigen Anruf zugeordnet und in OPS abgespielt, mit Protokoll, wer zugehört hat. Verpasste Anrufe werden nie abgerufen.
• Abgleich: Mit CDR-Datenbank ergänzt OPS jede Nacht.

Gut zu wissen

• Nur HTTPS: OPS sendet Manager-Zugangsdaten nie über einfaches HTTP.
• Aufzeichnungen holt OPS nur aus einem HTTPS-Ordner.
• Ausgehende Anrufe startet OPS im Kontext from-internal.
• Zweikanal-Aufzeichnung verdoppelt den Speicherbedarf, lässt Anrufzusammenfassungen aber Anrufer und Agent trennen. Anrufzusammenfassungen sind standardmäßig aus (KI-Einstellungen) und verbrauchen KI-Credits.
• OPS löscht keine Aufzeichnungen auf Ihrem Asterisk. Das Manager-Secret ist nach dem Speichern nicht mehr lesbar.

Fehlerbehebung

• "The base URL is not HTTPS." (Die Basis-URL ist kein HTTPS.) Stellen Sie den AJAM-Endpunkt hinter TLS.
• "The PBX did not answer over AJAM: …" (Die Anlage hat nicht über AJAM geantwortet.) Prüfen Sie, ob der Manager-Benutzer existiert, ob seine permit-Zeile die OPS-Adresse enthält und ob der Port offen ist.
• "No recording source is configured." (Keine Aufzeichnungsquelle eingerichtet.) Monitor-Ordner über geschütztes HTTPS bereitstellen und Dialplan-Snippet anwenden.
• Keine Aufzeichnungen, kein Fehler: Die Dateinamen im Dialplan wurden geändert.

Jetzt starten

Lassen Sie Ihr Asterisk mit CRM und Service Desk zusammenarbeiten. Kostenlos starten. Mehr zu den EU-Integrationen von OPS und zu Vertrieb und Abrechnung.