Schnittstelle und Netzwerk
Was Administratoren zum Einrichten brauchen. Die Beispiele verwenden 192.168.10.5 als CallerHub-Server, Port 8080 und den Platzhalter API-KEY.
Abfrage-URL für die Telefonanlage
Die Telefonanlage ruft bei jedem Anruf diese Adresse auf und erhält den Namen zurück. Jede Schnittstelle hat einen eigenen API-Key; CallerHub beantwortet die Anfrage mit den Datenquellen dieser Schnittstelle.
http://192.168.10.5:8080/lookup?apikey=API-KEY&number=040 66969000
→ Becker & Partner - Laura Becker (leer, wenn unbekannt)
Die passende Adresse je Anlage steht auf der Seite Telefonanlagen; „Anleitung kopieren“ in CallerHub liefert sie mit dem echten API-Key. Der Schlüssel kann statt im Parameter apikey auch im Header X-Api-Key stehen; dann erscheint er nicht in Proxy-Protokollen.
Antwortcodes
| Code | Bedeutung |
|---|---|
200 | Name gefunden (bei unbekannter Nummer leer) |
401 | API-Key bzw. Schlüssel falsch oder fehlend |
403 | IP-Adresse für diese Schnittstelle nicht erlaubt |
404 | unbekannter Pfad oder Modul ausgeschaltet |
405 | falsche HTTP-Methode |
429 | nach zu vielen falschen Schlüsseln vorübergehend gesperrt |
503 | keine Datenquelle bereit bzw. Telefonnummernliste noch nicht geladen |
Weitere Hilfe bei der Fehlersuche: Typische Fehler bei der Anbindung.
Netzwerkverbindungen und Ports
CallerHub baut nur die Verbindungen auf, die Sie einrichten. An den Anbieter sendet es keine Anruf- oder Personendaten; Verbindungen zu callerhub.de gibt es nur für die Update-Suche und, mit eigenem Lizenzschlüssel oder Testphase, für die Sperrliste und die Online-Prüfung der Lizenz.
| Verbindung | Richtung | Port (Beispiel) | Inhalt | Wann |
|---|---|---|---|---|
| Telefonanlage → CallerHub | eingehend | 8080 HTTP / 8443 HTTPS | Telefonnummer, optional angerufene Nummer und Benutzer, API-Key → Name, optional Link | je Anruf |
| CallerHub → SQL-Datenbank | ausgehend | 1433, 1521, 3306, 5432 | Anmeldung, SELECT | Liste im Intervall bzw. je Anruf |
| CallerHub → LDAP/AD | ausgehend | 389 / 636 | Anmeldung, Suche | im Intervall |
| CallerHub → Microsoft 365, EWS, REST | ausgehend | 443 | Token-Anfrage, Abruf der Kontakte | im Intervall bzw. je Anruf |
| CallerHub → SMTP / Webhook | ausgehend | 587 / 465 / 25, 443 | Störung und Behebung, Berichte; ohne Telefonnummern | bei Störung bzw. nach Plan |
| Browser / Überwachung → CallerHub | eingehend | wie Schnittstelle | Statistik, Anrufanalyse, Monitoring mit Zugangsschlüssel | bei Aufruf |
| Telefone → LDAP-Telefonbuch | eingehend | 389 / 636 | Namens- und Rückwärtssuche | je Suche |
| Live-Empfang Verbindungsdaten | eingehend oder ausgehend | 5100, 5101, 5038, 1080, 1012 bzw. 443 | Verbindungsdaten je Anruf | laufend bzw. im Abstand |
| CallerHub → callerhub.de | ausgehend | 443 | Abfrage der neuesten Version, Download der Programmdatei; mit eigenem Lizenzschlüssel die signierte Sperrliste der Lizenzen | bei „Nach Updates suchen“ bzw. Update; Sperrliste einmal täglich |
| CallerHub → STARFACE (REST) | ausgehend | 443 | Kontakte ins eigene STARFACE-Adressbuch | nachts, nach Neuladen, auf Knopfdruck |
| Mitel-Telefone → CallerHub | eingehend | HTTP, TFTP | Einstellungsdateien, Display-Seiten | beim Start des Telefons, bei Abruf |
| CallerHub → nuget.org | ausgehend | 443 | Download des Oracle-Treibers | nur wenn der Treiber fehlt und Sie bestätigen |
| Netzwerk-Discovery | ausgehend | u. a. 1433, 1521, 3306, 5432, 389, 636, 5060, 1012; UDP 1434, 1900 | Verbindungsversuch ohne Anmeldung | nur nach ausdrücklichem Start |
Weitere Schnittstellen
- Browser-Zugang: Statistik und Anrufanalyse im Browser, Weiterleitung zum CRM-Datensatz für CTI-Popups – mit eigenem Zugangsschlüssel.
- Monitoring: Nagios, Icinga, Checkmk, PRTG, Zabbix, Prometheus und Grafana – mit eigenem Monitoring-Schlüssel.
- Verbindungsdaten und Anrufereignisse von Telefonanlagen und eigenen Skripten.
- Plugins: eigene Erweiterungen, die bei jedem Anruf laufen.
Technische Details zu diesen Schnittstellen (Adressen und Parameter, Konsolenbefehle, Plugin- und Ereignis-Schnittstelle) erhalten Sie auf Anfrage beim Support: info@callerhub.de.