CallerHub
DE
Download

Asterisk, FreePBX, VitalPBX und Issabel: Caller-ID-Lookup per HTTP

Asterisk setzt den Anrufernamen im Wählplan. Woher der Name kommt, bestimmen Sie: aus einer HTTP-Abfrage je Anruf, die ihn aus CRM, Datenbank oder Verzeichnis liefert.

Wie Asterisk einen Namen nachschlägt

  • Asterisk direkt: Im eingehenden Kontext ruft die Funktion CURL (Modul func_curl) eine Adresse auf; das Ergebnis wird in CALLERID(name) geschrieben, bevor das Telefon klingelt.
  • FreePBX und Issabel: Das Modul CallerID Lookup Sources nimmt eine HTTP-Quelle mit Host, Port, Pfad und Abfrage auf. Einzelheiten beschreibt die Dokumentation von Sangoma (englisch).
  • VitalPBX: eine CID-Lookup-Quelle (HTTP/HTTPS) in der eingehenden Route.

Wichtig ist eine kurze Zeitüberschreitung: Antwortet der Dienst nicht, soll der Anruf trotzdem sofort klingeln. Bei HTTPS muss Asterisk dem Zertifikat des Dienstes vertrauen (Stammzertifikat auf dem Asterisk-Server hinterlegen).

Mit CallerHub: die Adresse für Ihre Anlage

Legen Sie in CallerHub unter Schnittstellen → Schnittstelle hinzufügen eine Schnittstelle für Ihre Anlage an, tragen Sie bei Erlaubte IP-Adressen die Adresse des Asterisk-Servers ein und wählen Sie Speichern und übernehmen. „Anleitung kopieren“ liefert die vollständige Adresse mit dem echten API-Key. Die Beispiele verwenden 192.168.10.5 als CallerHub-Rechner und den Platzhalter API-KEY.

AnlageEinzutragende Abfrage
Asterisk / FreePBX (Wählplan)…/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})}
FreePBX / Issabel (CallerID Lookup Sources)Pfad /lookup, Abfrage format=text&apikey=…&number=[NUMBER]
VitalPBX (CID-Lookup-Quelle)…/lookup?apikey=…&number=[CIDNUM]

Beispiel Wählplan (FreePBX: extensions_custom.conf, Kontext from-pstn-custom o. ä.)

exten => _X.,1,Set(CURLOPT(httptimeout)=2)
 same => n,Set(CALLERID(name)=${CURL(http://192.168.10.5:8080/lookup?apikey=API-KEY&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})})})
 same => n,Goto(from-pstn,${EXTEN},1)

Danach den Wählplan neu laden (dialplan reload). Ist CallerHub nicht erreichbar, bleibt der Name nach 2 Sekunden leer und der Anruf läuft normal weiter. called übergibt die angerufene Nummer für die Statistik.

Anrufanalyse über AMI oder Master.csv

Für Erreichbarkeit und Service-Level, die Rückrufliste und die Live-Anzeige liest CallerHub die Verbindungsdaten:

  • Live über AMI: CallerHub verbindet sich mit Port 5038. In manager.conf einen Benutzer mit read = cdr anlegen, in cdr_manager.conf enabled = yes setzen.
  • Datei: Master.csv aus dem CDR-Modul von Asterisk, auch rückwirkend.
Anrufanalyse
Anrufanalyse der letzten 30 Tage mit Kennzahlen zu Anrufen, Erreichbarkeit, Service-Level, Rückrufquote und offenen Rückrufen.

Typische Fehler

BeobachtungUrsache und Abhilfe
Name bleibt leer, CallerHub zeigt keinen ZugriffDie Anfrage erreicht CallerHub nicht: Adresse, Port, Windows-Firewall und Firewalls zwischen den Netzen prüfen; vom Asterisk-Server aus mit curl testen. Ist func_curl geladen?
Protokoll: status=401 oder 403API-Key falsch bzw. Adresse des Asterisk-Servers nicht bei den erlaubten IP-Adressen. Hinter NAT weicht der Absender ab.
Zugriff kommt an, aber kein NameNummer unbekannt (mit „Nummer prüfen“ testen), falsches format oder die Zeitüberschreitung ist kürzer als die Antwortzeit.
Umlaute falschAntworten sind UTF-8; den Zeichensatz der Anlage prüfen.

Die Anleitungen für Asterisk, FreePBX, VitalPBX und Issabel beruhen auf veröffentlichten Schnittstellen und sind mit diesen Anlagen noch nicht geprüft. Gleichen Sie Platzhalter, Menüpfade und Einstellungsnamen mit der Dokumentation Ihrer Version ab.

Häufige Fragen

Welches Antwortformat erwartet Asterisk?

Reinen Text: nur den Namen, leer bei unbekannten Nummern. Das ist die Vorgabe von CallerHub für Asterisk, FreePBX, VitalPBX und Issabel; mit format lassen sich auch JSON oder XML wählen.

Bremst die Abfrage den Anruf?

CallerHub beantwortet Anrufe aus der Telefonnummernliste im Arbeitsspeicher; eine langsame Datenbank verzögert die Antwort dann nicht. Die Zeitüberschreitung im Wählplan begrenzt die Wartezeit zusätzlich, im Beispiel auf 2 Sekunden.

Kann ich mehrere Asterisk-Server anbinden?

Ja. Jede Anlage bekommt eine eigene Schnittstelle mit eigenem API-Key, eigenen erlaubten IP-Adressen und eigener Auswahl der Datenquellen. Die Grundversion erlaubt eine Schnittstelle, die Vollversion bis zu zehn.

Ausprobieren

Mit Ihren eigenen Daten testen.

Die Vollversion testen Sie 30 Tage: In CallerHub „Testphase anfordern …“ wählen, der Testschlüssel kommt per E-Mail. Der Einrichtungsassistent führt durch Datenquelle, Telefonanlage und Testabfrage. Danach arbeitet CallerHub als kostenlose Grundversion weiter, ohne dass Einstellungen oder Daten verloren gehen.