CallerHub
DE
Download

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

CodeBedeutung
200Name gefunden (bei unbekannter Nummer leer)
401API-Key bzw. Schlüssel falsch oder fehlend
403IP-Adresse für diese Schnittstelle nicht erlaubt
404unbekannter Pfad oder Modul ausgeschaltet
405falsche HTTP-Methode
429nach zu vielen falschen Schlüsseln vorübergehend gesperrt
503keine 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.

VerbindungRichtungPort (Beispiel)InhaltWann
Telefonanlage → CallerHubeingehend8080 HTTP / 8443 HTTPSTelefonnummer, optional angerufene Nummer und Benutzer, API-Key → Name, optional Linkje Anruf
CallerHub → SQL-Datenbankausgehend1433, 1521, 3306, 5432Anmeldung, SELECTListe im Intervall bzw. je Anruf
CallerHub → LDAP/ADausgehend389 / 636Anmeldung, Sucheim Intervall
CallerHub → Microsoft 365, EWS, RESTausgehend443Token-Anfrage, Abruf der Kontakteim Intervall bzw. je Anruf
CallerHub → SMTP / Webhookausgehend587 / 465 / 25, 443Störung und Behebung, Berichte; ohne Telefonnummernbei Störung bzw. nach Plan
Browser / Überwachung → CallerHubeingehendwie SchnittstelleStatistik, Anrufanalyse, Monitoring mit Zugangsschlüsselbei Aufruf
Telefone → LDAP-Telefonbucheingehend389 / 636Namens- und Rückwärtssucheje Suche
Live-Empfang Verbindungsdateneingehend oder ausgehend5100, 5101, 5038, 1080, 1012 bzw. 443Verbindungsdaten je Anruflaufend bzw. im Abstand
CallerHub → callerhub.deausgehend443Abfrage der neuesten Version, Download der Programmdatei; mit eigenem Lizenzschlüssel die signierte Sperrliste der Lizenzenbei „Nach Updates suchen“ bzw. Update; Sperrliste einmal täglich
CallerHub → STARFACE (REST)ausgehend443Kontakte ins eigene STARFACE-Adressbuchnachts, nach Neuladen, auf Knopfdruck
Mitel-Telefone → CallerHubeingehendHTTP, TFTPEinstellungsdateien, Display-Seitenbeim Start des Telefons, bei Abruf
CallerHub → nuget.orgausgehend443Download des Oracle-Treibersnur wenn der Treiber fehlt und Sie bestätigen
Netzwerk-Discoveryausgehendu. a. 1433, 1521, 3306, 5432, 389, 636, 5060, 1012; UDP 1434, 1900Verbindungsversuch ohne Anmeldungnur nach ausdrücklichem Start
Schema: STARFACE Cloud erreicht CallerHub über die Firewall per HTTPS 8443, CallerHub liest den SQL Server im eigenen Netz.
Beispiel A: STARFACE Cloud, Datenbank im eigenen Netz. Eingehend nur Port 8443 von der STARFACE.
Schema: 3CX oder Asterisk im eigenen Netz fragt CallerHub per HTTP 8080, CallerHub liest Active Directory per LDAPS und eine CSV-Datei per SMB.
Beispiel B: Telefonanlage im eigenen Netz mit Active Directory und CSV-Datei.

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.