Telefonanlagen und Anbindungen
CallerHub bindet Telefonanlagen auf vier Wegen an: per HTTP-Abfrage je Anruf, als LDAP-Telefonbuch, über exportierte Telefonbücher und – für die Anrufanalyse – über Verbindungsdaten.
Schritt-für-Schritt-Anleitungen: STARFACE · 3CX · Asterisk/FreePBX · Yealink/Snom · Mitel 100 · FRITZ!Box · alle Lösungen
Namensabfrage per HTTP
Jede Telefonanlage wird als eigene Schnittstelle mit eigenem API-Key und eigenen erlaubten IP-Adressen angebunden. Die Grundversion erlaubt eine Schnittstelle, die Vollversion bis zu zehn (mehr mit Sonderlizenz). Alle Anlagen nutzen denselben Port; CallerHub erkennt sie an ihrem API-Key.
| Anlage bzw. Profil | Antwortformat | Beispiel-Adresse | Einrichtung | Stand |
|---|---|---|---|---|
| STARFACE | Text | …/lookup?number= + Header X-Api-Key | über ein Modul der STARFACE; Beispielmodul CallerHub_Interface_v49.sfm liegt bei | geprüft |
| 3CX | JSON | …/lookup?format=json&apikey=…&number=[Number] | CRM-Vorlage, die CallerHub erzeugt („3CX-Vorlage …“) | Tester gesucht |
| Asterisk / FreePBX | Text | …/lookup?apikey=…&called=${EXTEN}&number=${URIENCODE(${CALLERID(num)})} | Wählplan mit CURL (Modul func_curl) | Tester gesucht |
| VitalPBX | Text | …/lookup?apikey=…&number=[CIDNUM] | CID-Lookup-Quelle in der eingehenden Route | Tester gesucht |
| Issabel (auch FreePBX) | Text | Pfad /lookup, Abfrage format=text&apikey=…&number=[NUMBER] | CallerID Lookup Sources | Tester gesucht |
| Yealink / Fanvil | XML-Telefonbuch | …/lookup?format=yealink&apikey=…&number=#SEARCH | Remote-Telefonbuch am Telefon oder per Provisionierung | Tester gesucht |
| Snom | XML-Telefonbuch | …/lookup?format=snom&apikey=…&number=#SEARCH | XML-Telefonbuch am Telefon | Tester gesucht |
| Allgemein (HTTP) | Text, JSON, XML | …/lookup?format=json&apikey=…&number=03023125017 | jede Anlage, die bei einem Anruf eine Adresse per HTTP GET abrufen kann | allgemein |
Geprüft sind die STARFACE-Anbindung, die CSTA-Anbindung von Mitel 100, Aastra und OpenCom, die Mitel-Telefone 6800/6900 und die FRITZ!Box. Die Anleitungen für die übrigen Anlagen beruhen auf veröffentlichten Schnittstellen; gleichen Sie Platzhalter, Menüpfade und Einstellungsnamen mit der Dokumentation Ihrer Version ab.
Ihr System ist noch nicht geprüft? Werden Sie Pilotkunde – 12 Monate Vollversion kostenlos.
Eine Karte je Telefonanlage
Auf der Seite Schnittstellen hat jede Anlage eine eigene Karte mit Bezeichnung, Zustand der letzten Anfrage, API-Key, erlaubten IP-Adressen und den abgefragten Datenquellen. „Anleitung kopieren“ liefert die Einrichtungsanleitung für die gewählte Anlage mit dem echten API-Key.


Beispiel Asterisk / FreePBX
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)
Beispiel Yealink (Provisionierung)
remote_phonebook.data.1.url = http://192.168.10.5:8080/lookup?format=yealink&apikey=API-KEY&number=#SEARCH
remote_phonebook.data.1.name = CallerHub
features.remote_phonebook.enable = 1
STARFACE-Modul
Die STARFACE hat keine eingebaute Namensabfrage per Web-Adresse; ein Modul im Module Designer fragt CallerHub bei jedem eingehenden Anruf nach dem Namen. Dafür importieren Sie Samples\CallerHub_Interface_v49.sfm; dieses Modul beherrscht die Namensabfrage. Ein erweitertes Modul meldet außerdem alle Ereignisse eines Anrufs (Klingeln, Annahme, Auflegen, Weiterleitung) für Anrufanalyse, Statistik und Live-Anzeige; Details auf Anfrage beim Support. Anonyme Anrufe werden nicht abgefragt.
LDAP-Telefonbuch für Anlagen ohne HTTP-Abfrage
Viele Telefonanlagen und Tischtelefone fragen keine Web-Adresse ab, sondern ein LDAP-Verzeichnis. Dafür stellt das Modul Telefonbuch ein schreibgeschütztes LDAPv3-Verzeichnis bereit (Port 389, mit LDAPS 636). Die Rückwärtssuche bei eingehenden Anrufen fragt alle aktiven Datenquellen ab, einschließlich Regeln, Sperr- und VIP-Liste.
Typische Geräte: Unify OpenScape Business, Auerswald COMtrexx/COMpact, Avaya J100 an IP Office, Yeastar P-Series, innovaphone (Reverse Lookup), Ascom IP-DECT, Grandstream UCM, pascom, Gigaset, Yealink sowie die Mitel-100-Familie (Mitel 112, 130, 150).

Server: Name oder IP-Adresse des CallerHub-Rechners, Port 389 (636 mit LDAPS)
Base DN: ou=callerhub
Namensfilter: (|(cn=%)(sn=%))
Nummernfilter: (|(telephoneNumber=%)(mobile=%))
Anzeige-Attribut: cn Nummern-Attribut: telephoneNumber
Schreibversuche werden abgelehnt, StartTLS wird nicht unterstützt. Die LDAP-Anbindung der Mitel-100-Familie ist mit CallerHub geprüft.
Telefonbuch-Export und FRITZ!Box
Cloud-Anlagen wie Microsoft Teams, Zoom, NFON oder Placetel und die FRITZ!Box verwenden eigene Kontaktlisten. CallerHub exportiert dafür die Einträge aller Telefonnummernlisten (nach Regeln, ohne gesperrte Nummern).
| Format | Verwendung |
|---|---|
| FRITZ!Box (XML) | FRITZ!Box: Telefonie → Telefonbuch → Wiederherstellen. Die Anzahl der Einträge ist je nach Modell begrenzt. |
| vCard 3.0 (.vcf) | Outlook, Auerswald, Gigaset und viele Cloud-Anlagen |
| CSV | Excel sowie Import in Cloud-Anlagen (z. B. Zoom, NFON, Placetel) |
| Yealink (XML) | Remote-Telefonbuch für Yealink und kompatible Telefone |
Telefone mit Remote-Telefonbuch laden die Liste auch direkt: /phonebook?format=yealink&key=ZUGANGSSCHLUESSEL (Formate yealink, fritzbox, vcard, csv). Für die Anrufanalyse liest CallerHub den FRITZ!Box-Anrufmonitor auf Port 1012.
STARFACE-Adressbuch abgleichen
App, Web-Client und Anruflisten der STARFACE zeigen bei ausgehenden Anrufen nur Namen aus STARFACE-Adressbüchern. CallerHub schreibt deshalb die Kontakte der Telefonnummernlisten über die STARFACE-REST-Schnittstelle in ein eigenes Adressbuch – nachts zur eingestellten Uhrzeit, nach jedem Neuladen der Datenquellen und auf Knopfdruck.
- Nur im eigenen Adressbuch: CallerHub legt nur dort an, ändert und löscht nur dort. Ist eine Quelle leer oder um mehr als die Hälfte geschrumpft, löscht es nichts.
- Ohne Freigabe von außen: Die Verbindung geht von CallerHub zur Anlage; ab STARFACE 10 mit OAuth.
- Große Bestände in Etappen: Höchstmengen je Lauf und für das ganze Adressbuch, Auswahl der Datenquellen.

Mitel-Telefone einrichten (6800/6900)
Das Modul Telefon-Provisionierung stellt Mitel-Telefonen ihre Einstellungen per HTTP und TFTP bereit – Nebenstelle, SIP-Zugang, Tasten und Seiten – und zeigt am Display Anrufinfo, CRM-Suche und eine Teamseite.
- Telefone als Tabelle: MAC, Modell, Nebenstelle, Name; die Spalte Zustand zeigt, wann das Telefon zuletzt seine Datei geholt hat.
- Tasten für alle: Besetztlampe, Kurzwahl, eigene Mailbox, Funktionen oder neue Seite – per Ziehen sortiert.
- Teamseite: Softkey „Team“ zeigt Kollegen mit Zustand (im Gespräch, klingelt, frei); Auswahl wählt.
Die STARFACE-Cloud beantwortet Besetztlampen-Abos von Fremdtelefonen nicht; Kollegen-Tasten lassen sich dann als Kurzwahl anlegen, die Teamseite zeigt den Zustand trotzdem.
Verbindungsdaten für die Anrufanalyse
Die Anrufanalyse benötigt die Verbindungsdaten (CDR) der Telefonanlage. Diese gelangen als Datei, live über eine Verbindung oder per API zu CallerHub. Bis zu fünf Live-Empfänger lassen sich einrichten.
| Quelle | Weg | Einstellung in der Telefonanlage |
|---|---|---|
| Asterisk / FreePBX | Datei Master.csv oder live über AMI (CallerHub verbindet sich, Port 5038) | manager.conf: Benutzer mit read = cdr; cdr_manager.conf: enabled = yes |
| STARFACE | Datei output.csv | Admin → Auswertung → Verbindungsdaten exportieren |
| 3CX (v18/v20) | CDR-Socket aktiv (CallerHub wartet, z. B. Port 5100) oder passiv; CSV-Export | Admin → Einstellungen → CDR |
| 3CX V20 (Cloud oder lokal) | API: CallerHub ruft XAPI ab | Integrationen → API: Client mit XAPI-Zugriff |
| Microsoft Teams Telefonie | API: Microsoft Graph, Berechtigung CallRecords.Read.All | App-Registrierung in Microsoft Entra ID |
| Webex Calling | API: analytics.webexapis.com, Scope spark-admin:calling_cdr_read | Control Hub: Rolle „Detailed Call History API access“ |
| Mitel MiVoice Office 400 | SMDR im Format PC5, CallerHub verbindet sich (Port 1080) | Ausgabe der Verbindungsdaten über TCP |
| Unify OpenScape Business | Gebührendaten per LAN, CallerHub wartet (z. B. Port 5101) | TCP-Client an CallerHub-Adresse:Port |
| innovaphone | TCP oder HTTP /cdr | Gateway → CDR0 |
| FRITZ!Box | Anrufmonitor, CallerHub verbindet sich (Port 1012) | einmalig #96*5* an einem Telefon wählen |
| Placetel | HTTP /event | Notify-API mit der Adresse von CallerHub |
| sipgate.io | HTTP /event | URL für eingehende und ausgehende Anrufe |
| Beliebige Anlage oder Skript | HTTP oder CSV-Datei im Ordner CallData | Details auf Anfrage beim Support |
Einrichtung in fünf Schritten
- Unter Schnittstellen eine Schnittstelle hinzufügen, die Telefonanlage wählen und eine Bezeichnung eingeben.
- Unter „Erlaubte IP-Adressen“ die Adresse der Anlage bzw. das Netz der Telefone eintragen, z. B.
192.168.10.20oder192.168.20.0/24. - Die abgefragten Datenquellen prüfen und „Speichern und übernehmen“ wählen.
- Im Browser eines Rechners im selben Netz testen:
http://192.168.10.5:8080/lookup?apikey=API-KEY&number=040 66969000liefert den Namen. - Die Anlage nach der Anleitung einrichten und einen Testanruf führen. Der Zugriff erscheint auf der Startseite unter „Letzte Zugriffe“.

Typische Fehler bei der Anbindung
| Symptom | Ursache und Abhilfe |
|---|---|
| Kein Eintrag unter „Letzte Zugriffe“, Status „Wartet auf Anfragen“ | Die Anfrage erreicht CallerHub nicht. Adresse in der Anlage (IP, Port, http/https), Windows-Firewall und Firewalls zwischen den Netzen prüfen. |
status=401 | API-Key falsch oder fehlend. Die Anleitung erneut kopieren; ein neu erzeugter Schlüssel muss auch in der Anlage geändert werden. |
status=403 | Die Absenderadresse steht nicht in den erlaubten IP-Adressen. Hinter NAT oder Reverse Proxy weicht der Absender ab. |
status=429 | Zu viele falsche Schlüssel von dieser Adresse. Das Ende der Sperre (Vorgabe 5 Minuten) abwarten. |
| Anfrage kommt an, aber kein Name | Nummer unbekannt, falsches format für die Anlage oder Zeitüberschreitung der Anlage kürzer als die Antwortzeit. |
| HTTPS schlägt fehl | Die Anlage vertraut dem Zertifikat nicht oder der Zertifikatsname passt nicht. Stammzertifikat in die Anlage importieren. |
| Umlaute falsch oder Name abgeschnitten | Antworten sind UTF-8; Zeichensatz der Anlage prüfen. Maximale Namenslänge unter Administration → Erweitert einstellen. |
Bleibt die Ursache unklar, zeichnet „Fehleranalyse → Erweiterte Aufzeichnung starten …“ jede Anfrage mit allen Headern auf (Schlüssel maskiert). Der eingebaute Telefonanlagen-Simulator testet eine Einrichtung, ohne dass eine echte Anlage anruft.