CallerHub
DE
Download

STARFACE: Anrufername aus CRM, ERP oder SQL

Von sich aus kennt die STARFACE die Namen aus ihren eigenen Adressbüchern. Stehen Ihre Kunden in einem CRM, einem ERP oder einer Datenbank, braucht die Anlage bei jedem Anruf eine Abfrage oder einen Abgleich ins Adressbuch. Beides beschreibt diese Seite.

Wie die STARFACE zu einem Namen kommt

  • Adressbuch der Anlage: Kontakte, die in einem STARFACE-Adressbuch stehen, erscheinen als Name. Werden sie dort importiert oder von Hand gepflegt, entsteht eine zweite Datenhaltung, die aktuell bleiben muss.
  • Modul je Anruf: Die STARFACE hat keine eingebaute Namensabfrage per Web-Adresse. Ein Modul vom Typ Call-Processing kann bei jedem eingehenden Anruf eine Adresse aufrufen und die Antwort als Anrufernamen setzen.

Für das Modul brauchen Sie Administratorzugang zur STARFACE. Module importieren Sie unter Admin → Module → Modul-Library → Modul importieren (Anleitung von STARFACE). Eine STARFACE in der Cloud muss den abgefragten Dienst aus dem Internet erreichen; der Port wird dann in Ihrer Firewall an diesen Rechner weitergeleitet.

Mit CallerHub: Name bei jedem eingehenden Anruf

CallerHub liefert ein fertiges Modul mit: die Datei CallerHub_Interface_….sfm im Ordner Samples. Bei einem eingehenden Anruf fragt das Modul CallerHub nach dem Namen und zeigt die Antwort an. Die Anleitung wurde mit STARFACE 10.0.2.6 (Cloud) erprobt.

  1. In CallerHub unter Schnittstellen → Schnittstelle hinzufügen die STARFACE wählen, eine Bezeichnung eingeben und Anlegen klicken. Bei Erlaubte IP-Adressen den Absender der STARFACE eintragen, die abgefragten Datenquellen prüfen und Speichern und übernehmen.
  2. In der STARFACE unter Admin → Module → Modul-Library → Modul importieren die Datei aus dem Ordner Samples wählen.
  3. Im Modulmanager, Reiter Modul-Konfiguration, eine neue Konfiguration für das Modul CallerHub anlegen. Bei LOOKUP_URL die Adresse von CallerHub eintragen, z. B. https://callerhub.example.com:8080/lookup (endet auf /lookup, ohne Parameter), bei API_KEY den Schlüssel der Schnittstelle. Speichern und die Konfiguration aktiv setzen.
  4. Den Port von CallerHub (Vorgabe 8080) in der Firewall an den CallerHub-Rechner weiterleiten.
  5. Von einer Nummer anrufen, die im CRM gespeichert ist. Der Zugriff erscheint in CallerHub unter Letzte Zugriffe.
Schnittstellen · Telefonanlage
Karte Telefonanlage mit der Anleitung für die STARFACE.

„Anleitung kopieren“ auf der Karte liefert dieselbe Anleitung mit dem echten API-Key. Die Namen kommen aus allen Datenquellen, die für diese Schnittstelle gewählt sind, z. B. SQL-Datenbank, DATEV-Export oder Active Directory.

Ausgehende Anrufe, App und Web-Client: Adressbuch abgleichen

App, Web-Client und Anruflisten der STARFACE zeigen bei ausgehenden Anrufen nur Namen aus STARFACE-Adressbüchern. Dafür schreibt CallerHub die Kontakte Ihrer Datenquellen über die REST-Schnittstelle der STARFACE 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.
  • Verbindung von innen: CallerHub verbindet sich mit der Anlage; eine Freigabe von außen ist dafür nicht nötig. Ab STARFACE 10 mit OAuth.
  • Adressbuch anlegen: Ab STARFACE 10 legen Sie es unter Administration → Adressbuch → Verzeichniskonfiguration mit Schreibzugriff an, mit demselben Namen wie in CallerHub.

Anrufanalyse und Live-Anzeige

Tragen Sie im Modul zusätzlich EVENT_URL ein: dieselbe Adresse mit /event am Ende. Dann meldet das Modul alle Ereignisse eines Anrufs (Klingeln, Annahme, Auflegen, Weiterleitung) für Anrufanalyse, Statistik und Live-Anzeige. In CallerHub muss dafür die Stammnummer der Anlage eingetragen sein (z. B. +49 40 66969), sonst erkennt es Richtung und interne Anrufe nicht.

Rückwirkend geht es mit dem Export der Verbindungsdaten: Administration → Auswertung → Verbindungsdaten exportieren, die Datei output.csv in den Ordner der Schnittstelle legen.

Typische Fehler

BeobachtungUrsache und Abhilfe
Module Designer, Reiter Log File: ConnectTimeoutExceptionDie STARFACE erreicht CallerHub nicht. Adresse, Portweiterleitung und HTTPS prüfen.
Protokoll: status=401API-Key in der Modulkonfiguration falsch.
Protokoll: status=403Die IP-Adresse der STARFACE fehlt bei den erlaubten IP-Adressen; das Protokoll zeigt sie als ip=….
Protokoll: status=404Die Adresse endet nicht auf /lookup.
Keine Anfrage bei AnrufenDer Modultyp muss Call-Processing sein, die Konfiguration aktiv.
Alle Anrufe erscheinen als ausgehendStammnummer der Anlage in CallerHub eintragen.

Das Modul-Log der STARFACE kann Zugangsdaten enthalten. Prüfen Sie es vor der Weitergabe und entfernen Sie Kennwörter.

Häufige Fragen

Muss ich das STARFACE-Modul selbst bauen?

Nein. CallerHub liefert das Modul als Datei im Ordner Samples mit; Sie importieren es und tragen Adresse und API-Key ein. Zeigt der Import „Lizenz benötigt“, hilft der Support.

Funktioniert das mit der STARFACE Cloud?

Ja. Die Anleitung wurde mit STARFACE 10.0.2.6 in der Cloud erprobt. CallerHub braucht dann eine Adresse, die aus dem Internet erreichbar ist, und die erlaubten IP-Adressen begrenzen die Anfragen auf den Absender Ihrer STARFACE.

Werden die Kundendaten in die STARFACE kopiert?

Für die Namensabfrage nicht: Das Modul fragt bei jedem Anruf, CallerHub antwortet aus seiner Liste im Arbeitsspeicher. Nur der optionale Adressbuch-Abgleich schreibt Kontakte in ein eigenes STARFACE-Adressbuch.

Welche Datenquellen kann die STARFACE so abfragen?

Alle Datenquellen von CallerHub: SQL Server, Oracle, MySQL/MariaDB, PostgreSQL und andere ODBC-Datenbanken, CSV-Dateien wie den DATEV-Export, REST-APIs von CRM und ERP, LDAP/Active Directory, Microsoft 365 und Exchange. Die Grundversion erlaubt eine Datenquelle, 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.