CallerHub – Hilfe

Was CallerHub tut

Ruft jemand an, fragt Ihre Telefonanlage CallerHub: „Wer ist +49 711 1234567?“ CallerHub sucht die Telefonnummer in Ihren Datenquellen (CRM, ERP, CSV-Datei, Active Directory, Microsoft 365, Exchange, REST-API) und antwortet in wenigen Millisekunden mit dem Namen. Die Telefonanlage zeigt ihn am Telefon an.

Schnellstart

1. Kopieren Sie den Programmordner CallerHub auf den Server, z. B. nach C:\CallerHub (siehe Installation).
2. Starten Sie CallerHub.exe. Beim ersten Start öffnet sich der Einrichtungsassistent.
3. Schritt 2: Übernehmen Sie das Beispiel-Telefonbuch Samples\customers.csv (oder wählen Sie eine eigene CSV-Datei; für andere Aufbauten wie einen DATEV-Export verwenden Sie später Spalten zuordnen). Schritt 3: Wählen Sie die Telefonanlage und tragen Sie den Port (z. B. 8080) und die IP-Adresse der Telefonanlage (z. B. 192.168.10.20) ein. Schritt 4: Führen Sie eine Testabfrage mit 030 1234560 aus – das Ergebnis lautet „Testkunde GmbH - Frau Beispiel“.
4. Tragen Sie die angezeigte Adresse und den API-Key in der Telefonanlage ein (Anleitung je Telefonanlage unter Schnittstellen → Telefonanlage, siehe Telefonanlagen einrichten).
5. Später: Legen Sie auf der Seite Datenquellen mit Datenquelle hinzufügen die echte Datenquelle an (z. B. SQL Server), klicken Sie auf Verbindung testen und dann auf Speichern und übernehmen. Wie Sie die passende Abfrage finden, steht unter Abfrage für die eigene Datenbank finden.

Installation (nur der Ordner CallerHub)

CallerHub benötigt weder einen Installer noch eine .NET-Installation: CallerHub.exe enthält die .NET-10-Laufzeit; die Datenbanktreiber liegen im Unterordner Drivers. Es genügt der Programmordner CallerHub aus der Lieferung. Alles, was das Programm schreibt, speichert es in Unterordnern dieses Ordners.

Voraussetzungen

Ordner und Dateien

Ist der Programmordner nicht beschreibbar (z. B. unter C:\Program Files ohne Rechte), weicht CallerHub nach %LOCALAPPDATA%\CallerHub aus und zeigt dies im Systemzustand an. Empfehlung: Verwenden Sie einen eigenen Ordner mit Schreibrecht für den Dienstbenutzer, z. B. C:\CallerHub oder D:\Dienste\CallerHub.

Schritte

1. Kopieren Sie den Programmordner nach C:\CallerHub (ZIP-Archiv entpacken oder einrichten.cmd aus der Lieferung ausführen). Wählen Sie bei einem ZIP-Archiv vorher in den Dateieigenschaften „Zulassen“ oder führen Sie in PowerShell aus: Get-ChildItem -Recurse C:\CallerHub | Unblock-File. Das Programm ist nicht signiert; Windows SmartScreen kann beim ersten Start eine Warnung anzeigen.
2. Starten Sie CallerHub.exe → Assistent. Ohne Assistent: Wählen Sie unter Datenquellen „Erste Datenquelle hinzufügen“, richten Sie unter Schnittstellen die Telefonanlage ein und klicken Sie auf Speichern und übernehmen.
3. Port öffnen: Administration → Systemzustand zeigt eine fehlende Port-Reservierung oder Firewall-Regel mit einer Schaltfläche zum Beheben an (Rückfrage nach Administratorrechten).
4. Optional (erweiterter Modus, Edition Full): Administration → Betrieb → Als Dienst installieren (läuft ohne Anmeldung, Dienstname CallerHub).

Update auf eine neuere Version (ab 3.0.0.0)

• Beenden Sie CallerHub bzw. stoppen Sie den Dienst, kopieren Sie den neuen Ordnerinhalt in den bisherigen Programmordner und starten Sie CallerHub bzw. den Dienst wieder. Einstellungen, Protokolle und Statistik bleiben erhalten.
• Kopieren Sie den vollständigen Ordnerinhalt einschließlich des Unterordners Drivers: Der Oracle-Treiber und die nativen Bibliotheken liegen jetzt dort statt direkt neben CallerHub.exe. Reste früherer Versionen – der Ordner native und eine Datei Oracle.ManagedDataAccess.dll direkt neben CallerHub.exe – werden nicht mehr benötigt; Sie können sie löschen, sobald CallerHub beendet ist.
• Das Beispiel-Telefonbuch heißt jetzt Samples\customers.csv (bisher kunden.csv). Einstellungen, die noch auf kunden.csv verweisen, verwenden automatisch die neue Datei.
• Ersetzungen für den Anzeigenamen verwenden jetzt das Semikolon als Trennzeichen (search;replace), wie die Sperrliste und die VIP-Liste. Vorhandene Zeilen mit => funktionieren weiterhin.

Deinstallation

Entfernen Sie den Dienst (Administration → Betrieb → Dienst entfernen), schalten Sie Mit Windows-Anmeldung starten (minimiert) aus, beenden Sie das Programm (Menü → Beenden (Schnittstelle stoppt) oder Infobereich → Beenden) und löschen Sie den Ordner. Optional entfernen Sie die Firewall-Regel CallerHub, die URL-Reservierung (netsh http delete urlacl url=http://+:8080/) und das HTTPS-Zertifikat (netsh http delete sslcert ipport=0.0.0.0:8443).

Wo Daten liegen – und wie Administratoren das prüfen

Zusage: CallerHub speichert Daten ausschließlich im eigenen Programmordner (Unterordner Logs, Statistics, Backups, Help, Temp und die Datei CallerHub.settings.xml) und im Arbeitsspeicher des laufenden Prozesses. Es legt keine Datenbank an und schreibt nicht in Ihre Datenquellen. Alles lässt sich unter Administration → Datenschutz (Übersicht) und mit Menü → Ordner öffnen → Programmordner einsehen.

Prüfschritte für Administratoren

1. Dateizugriffe: Starten Sie Sysinternals Process Monitor, setzen Sie die Filter Process Name is CallerHub.exe und Operation is WriteFile, führen Sie einige Testanrufe durch und speichern Sie einmal. Alle Pfade liegen im Programmordner (Ausnahme: der Rückfallordner %LOCALAPPDATA%\CallerHub, falls der Programmordner nicht beschreibbar ist – das meldet der Systemzustand).
2. Geöffnete Dateien: handle.exe -p CallerHub.exe (Sysinternals) oder Ressourcenmonitor → CPU → Zugeordnete Handles → Suche nach „CallerHub“.
3. Netzverbindungen: PowerShell Get-NetTCPConnection -OwningProcess (Get-Process CallerHub).Id; ältere Systeme: netstat -ano | findstr <PID>. Erwartet: der eigene Port von CallerHub (lauschend), Verbindungen zu den eingetragenen Datenquellen und, bei Benachrichtigungen, zum SMTP-Server bzw. Webhook. Discovery-Verbindungen erscheinen nur nach einem ausdrücklichen Start.
4. Registry und Windows-Objekte: reg query HKCU\Software\Microsoft\Windows\CurrentVersion\Run /v CallerHub, sc.exe query CallerHub, netsh http show urlacl, netsh http show sslcert, Get-NetFirewallRule -DisplayName CallerHub.
5. Keine Datenbank: CallerHub öffnet Datenquellen mit dem eingetragenen Benutzer nur lesend (SELECT, LDAP-Suche, GET). Empfehlung: Legen Sie einen Datenbankbenutzer nur mit Leserecht auf die benötigten Tabellen bzw. Sichten an; dann ist Schreiben technisch ausgeschlossen.
6. Aufbewahrung: CallerHub löscht ältere Dateien in Logs und Statistics gemäß den Einstellungen beim Start der Schnittstelle und danach einmal täglich (beim ersten Zugriff eines Tages). Prüfen: Get-ChildItem C:\CallerHub\Logs | Sort-Object LastWriteTime | Select-Object -First 3.

Datenschutz (DSGVO) und EU-Rechtsrahmen

Dieser Abschnitt ist eine technische Beschreibung und keine Rechtsberatung. Ob und auf welcher Rechtsgrundlage die Verarbeitung zulässig ist, beurteilt der Verantwortliche – im Zweifel gemeinsam mit dem Datenschutzbeauftragten. Rechtslage und Auslegung können sich ändern; prüfen Sie den aktuellen Stand.

Aktuelle Einstellungen anzeigen … auf derselben Karte zeigt die gespeicherte Einstellungsdatei, in der alle Passwörter, Schlüssel und Zugangsdaten durch *** ersetzt sind, zusammen mit dem Verschlüsselungsstatus (z. B. „Verschlüsselung: Kennwörter und API-Keys verschlüsselt (Windows DPAPI).“). So prüfen Sie, was gespeichert ist, ohne die Datei zu öffnen.

Wo personenbezogene Daten verarbeitet werden

Bezug zu Vorschriften

Hinweis zum KI-Assistenten: CallerHub ruft keine KI-Schnittstelle auf. CallerHub anonymisiert den Text vor dem Kopieren (Telefonnummern maskiert, E-Mail-Adressen ersetzt, IP-Adressen gekürzt, Passwörter und Schlüssel entfernt) und zeigt ihn im Dialog zur Prüfung an. Sie fügen ihn selbst in den Chat ein; dafür gelten die Bedingungen Ihres Chat-Zugangs.

Datenwege je Einstellung

Die Kachel Datenfluss kompakt auf der Startseite und ihre Schaltfläche Details … zeigen die Wege für die aktuellen Einstellungen (auch vor dem Speichern); die vollständige Grafik steht auch als Kachel Datenfluss ausführlich zur Verfügung, die Sie mit Drucken … drucken, z. B. für die Systemdokumentation. Die folgenden Beispiele zeigen typische Aufbauten; Pfeil = Richtung des Verbindungsaufbaus.

A · STARFACE Cloud, Datenbank im eigenen Netz

B · Telefonanlage im eigenen Netz, Active Directory und CSV

C · Cloud-Quellen, Benachrichtigungen, Browser und Überwachung

Alle Verbindungen

Oberfläche und Menü

Die Abbildungen zeigen Beispieldaten (Testnummern, IP-Adressen aus den Dokumentationsbereichen 192.0.2.0/24, 198.51.100.0/24 und 203.0.113.0/24, erzeugte Statistik). Schriftarten können unter Windows leicht abweichen.

Startseite (Dashboard)

Es gibt keinen Reiter „Start“: Ein Klick auf das CallerHub-Logo oder den Namen in der Titelleiste zeigt die Startseite. Daneben liegen die Reiter Schnittstellen, Datenquellen, Statistik, Anrufanalyse (nur mit dem Modul) und Administration. Bei ungespeicherten Änderungen erscheint unten eine kontrastreiche Leiste mit Verwerfen und Speichern und übernehmen; ohne Änderungen ist die Leiste ausgeblendet. Meldungen erscheinen in einem eigenen Dialog von CallerHub ohne Systemton (Strg+C kopiert den Text). Maximiert füllt das Fenster den Arbeitsbereich seines Bildschirms und lässt die Taskleiste frei.

Die Startseite ist ein Dashboard aus Kacheln in zwei Spalten: links eine breite, rechts eine schmale. In einem Fenster schmaler als etwa 1100 px folgen die Kacheln der rechten Spalte unter der linken Spalte; ist das Fenster niedrig, lässt sich die Seite scrollen.

Anpassen … oben auf der Startseite öffnet den Bereich Kacheln anzeigen: Ein Kästchen je Kachel blendet sie ein oder aus, Standard wiederherstellen stellt die obige Anordnung wieder her, und Fertig schließt den Bereich. Solange der Bereich offen ist, trägt jede Kachel in der Mitte ihres oberen Rands einen Griff ⠿: Ziehen Sie daran, um die Kachel an eine andere Stelle oder in die andere Spalte zu verschieben; eine Linie zeigt, wo sie landet. CallerHub speichert die Anordnung sofort – Speichern und übernehmen ist nicht nötig.

• Statusanzeige rechts oben: Läuft (grün), Wartet auf Anfragen (grün: die Schnittstelle läuft, aber seit dem Start hat noch keine Telefonanlage angefragt), Datenfehler (orange: die Schnittstelle läuft, eine Datenquelle meldet einen Fehler), Fehler (rot), Gestoppt, Nicht eingerichtet. Ein Klick zeigt Ursache und Vorschlag.
• Systemzustand oben (im erweiterten Modus mit Starten, Stoppen, Neu laden, Cache leeren): Kurzfassung der Ampel aus der Administration; ein Klick öffnet die Details.

Menü

Die Schaltfläche ☰ links oben öffnet das Menü. Seine Punkte sind nach Aufgaben gruppiert (Einstellungen, Betrieb, Ansicht, Hilfe) und durch Linien getrennt; in dieser Hilfe bezieht sich „Menü → …“ darauf.

Befehlssuche (Strg+K)

Strg+K öffnet ein Suchfeld über alle Seiten, Karten und Aktionen. Beispiele: https → HTTPS-Assistent, block → Sperrliste, plugin → Plugins, port → Server (Port und Start). Die Pfeiltasten wählen einen Eintrag, Enter springt hin.

Eingaben werden sofort geprüft

Leere Felder zeigen ein graues Beispiel (z. B. „z. B. dc01.firma.local“). Ungültige Eingaben färben das Feld rot; der Tooltip nennt den Grund, z. B. „'192.168.10' ist keine IP-Adresse. Beispiel: 192.168.10.20 oder 203.0.113.0/28“. Speichern springt zum ersten fehlerhaften Feld und markiert alle fehlenden Felder derselben Funktion. Das Mausrad verändert keine Auswahllisten und Zahlenfelder; es scrollt die Seite. Eingeklappte Karten öffnen sich mit der Tabulatortaste, nicht jedoch, wenn sich eine Schaltfläche selbst deaktiviert.

Beenden

Das Schließen des Fensters lässt die Schnittstelle im Infobereich weiterlaufen. Menü → Beenden (Schnittstelle stoppt) bzw. Infobereich → Beenden stoppt Schnittstelle, Zeitgeber, Plugins und alle Hintergrundaufgaben und beendet den Prozess vollständig; danach lässt sich der Programmordner löschen oder ersetzen.

Einfacher und erweiterter Modus

Im einfachen Modus (Standard) zeigt jede Seite nur, was für den Betrieb nötig ist. Erweiterte Einstellungen anzeigen (Menügruppe Ansicht oder der gleichnamige Schalter in der Speicherleiste) blendet die übrigen Optionen ein; die Wahl wird sofort gespeichert. Ausgeblendete Werte bleiben wirksam. Der erweiterte Modus gehört zur Vollversion und zur Testversion.

Sprachen

Englisch (Standard) und Deutsch sind eingebaut. Weitere Sprachen liegen als Textdateien im Ordner Languages des Programmordners (z. B. lang_fr.txt, lang_ru.txt, lang_zh.txt). Jede Datei lang_xx.txt erscheint nach einem Neustart automatisch im Untermenü Sprache / Language (Menügruppe Ansicht). Das Untermenü trägt die Überschrift „Select Language“ und listet zuerst Englisch, dann Deutsch und die übrigen Sprachen in alphabetischer Reihenfolge, jeweils mit Flagge und englischem Namen in Klammern, z. B. „Deutsch (German)“. Den Ordner öffnen Sie über Menü → Ordner öffnen → Sprachen.

Eine neue Sprache (oder Darstellung) wird nach einem Neustart des Programms wirksam. CallerHub fragt im Dialog „Select Language“ – auf Englisch und in der gewählten Sprache –, ob Sie Jetzt neu starten oder Später neu starten möchten. Sprachen, die von rechts nach links geschrieben werden (z. B. Arabisch oder Hebräisch), werden von rechts nach links angezeigt.

• Neue Sprache: Kopieren Sie eine vorhandene Datei (z. B. nach lang_es.txt), passen Sie die Kopfzeilen # Language: (Name im Menü), # Culture: (Datums- und Zahlenformat, z. B. es-ES), # Source: en und optional # Font: an und übersetzen Sie in jeder Zeile den Text rechts vom Tabulator. Der englische Text links ist der Schlüssel und bleibt unverändert; Platzhalter wie {0} und \n bleiben erhalten. Webadressen, Pfade, Dateinamen und technische Bezeichnungen werden nicht übersetzt. Speichern Sie die Datei als UTF-8. Einzelheiten stehen in Languages\README.txt.
• Fehlt eine Übersetzung, erscheint der englische Text.
• lang_de.txt enthält die deutschen Texte (links Englisch, rechts Deutsch); Änderungen rechts verbessern die deutsche Anzeige.
• Die Hilfe gibt es derzeit nur auf Englisch; die deutsche Hilfe folgt, sobald der englische Text feststeht. Alle Sprachen öffnen die englische Hilfe.

Französisch, Russisch und Chinesisch sind maschinell übersetzt und sollten vor einem Einsatz bei Kunden von Muttersprachlern geprüft werden. Chinesisch verwendet die Windows-Schrift Microsoft YaHei UI.

Kacheln der Startseite

Anpassen … rechts oben auf der Startseite schaltet Kacheln ein und aus und verschiebt sie (am Griff ⠿ ziehen). In Version 3.0 hinzugekommene Kacheln:

• Statistik: Anfragen der letzten 7 Tage – Balken je Tag (dunkel: Treffer) und der Link Ausführliche Statistik …. Mit Administration → Modul: Statistik → Nicht als Menüpunkt, sondern als Kachel auf der Seite CallerHub zeigen verschwindet der Reiter Statistik, und diese Kachel wird eingeschaltet.
• Protokoll (kompakt, live) – die neuesten 12 Informations-, Warn- und Fehlerzeilen, aktualisiert sich jede Sekunde; ohne Schaltflächen für Suche, Neu laden, Ordner oder Details (die vollständige Protokollansicht liegt im Menü). Zugriffe stehen unter „Letzte Zugriffe“, nicht hier.

Administration und Systemzustand

Alles Technische liegt auf der Seite Administration. Das Suchfeld mit der Lupe oben filtert bereits während der Eingabe: Nur Karten, deren Titel, Beschreibung, Beschriftungen oder Optionen den Text enthalten, bleiben sichtbar und geöffnet (z. B. port, e-mail, plugin; Esc leert die Suche). Eingeklappte Karten zeigen zur Orientierung ein großes Symbol. Ganz oben steht der Systemzustand (auch oben auf der Startseite): alle Dienste, Rechte und sonstigen Belange als Ampel. Er wird beim Start, nach dem Speichern, mit „Erneut prüfen“ und alle 5 Minuten geprüft.

Bei einer unvollständigen oder ungültigen Einstellung zeigt der Systemzustand einen Eintrag wie „Datenquelle 'CRM' unvollständig – übersprungen“, „Schnittstelle unvollständig“ oder „Modul unvollständig – nicht aktiv“ mit der Schaltfläche Öffnen: Sie öffnet die betroffene Seite und Karte und umrahmt das Feld rot. Nach dem Speichern umrahmt CallerHub zudem alle Felder mit einem Problem in der geöffneten Karte.

Prüfungen des Systemzustands

Der Systemzustand prüft alle 5 Minuten und nach dem Speichern; die Anzeige aktualisiert sich an Ort und Stelle ohne Flackern. Einträge mit einer Schaltfläche lassen sich direkt beheben:

Aktionen, die Administratorrechte erfordern, kann CallerHub nicht allein ausführen: Windows zeigt eine Bestätigung (UAC). Auf Servern ohne lokales Administratorkonto bitten Sie Ihre IT, die Aktion auszuführen oder die Firewall-Regel anzulegen (siehe Firewall-Beispiele).

Weitere Karten

Im einfachen Modus zeigt die Seite die Karten Systemzustand, Server, Benachrichtigungen, Lizenz, Module und Datenschutz, gefolgt von der Karte Weitere Einstellungen mit der Schaltfläche Erweiterte Einstellungen anzeigen. Der erweiterte Modus ergänzt die übrigen Karten (siehe Einfacher und erweiterter Modus).

• Server: Port, HTTPS, automatischer Start, Start bei der Windows-Anmeldung und (erweiterter Modus) vertrauenswürdige Reverse Proxys für alle Schnittstellen, dazu Starten und Stoppen. Alle Telefonanlagen nutzen denselben Port; CallerHub erkennt sie an ihrem API-Key.
• Benachrichtigungen: E-Mail und Webhook bei Störungen (siehe Benachrichtigungen).
• Lizenz: Lizenzschlüssel eingeben und prüfen (siehe Lizenzschlüssel).
• Module: Funktionen ein- und ausschalten. Für jedes eingeschaltete Modul mit Einstellungen erscheint eine Karte Modul: … – Statistik, Anrufanalyse, Anzeigename, Sperr- und VIP-Liste (globale Regeln), Benachrichtigungen, Browser-Zugang, Plugins, Netzwerk-Discovery.
• Datenschutz: Speicherorte nach den aktuellen Einstellungen und Aktuelle Einstellungen anzeigen … (siehe Datenschutz).
• Betrieb (erweiterter Modus): fünf Abschnitte mit kurzer Erklärung – Windows-Dienst, HTTPS, Windows-Ereignisprotokoll, Fehleranalyse, Einstellungen sichern (siehe Betrieb).
• Sicherheit (erweiterter Modus): siehe Sicherheit und Standards.
• Erweitert (erweiterter Modus): Ländervorwahl, Namenslänge, Zwischenspeicher, Protokoll.

Datenquellen mit Beispielwerten

Bei einer neuen Installation ist noch keine Datenquelle angelegt; die Seite Datenquellen zeigt dann nur Erste Datenquelle hinzufügen. Jede Datenquelle ist eine eigene Karte; eingeklappt zeigt sie Art, Ziel und Zustand. Ein Klick auf eine Karte öffnet sie (die übrigen schließen sich). Die Kopfzeile der geöffneten Karte enthält Bezeichnung, Abfragen (aktiv), den Zustand, Verbindung testen (bei einer CSV-Datei CSV-Datei prüfen), Auf und Ab (Reihenfolge der Abfragen) sowie Entfernen. Um die Reihenfolge zu ändern, können Sie eine Karte auch an ihrer Kopfzeile an eine andere Stelle ziehen. Darunter folgen die Schritte: Schritt 1: Verbindung, Schritt 2: Telefonnummernliste (nicht bei CSV-Dateien) und im erweiterten Modus Schritt 3: Anzeige und Link (optional) sowie Schritt 4: Regeln dieser Datenquelle (optional). Der Zähler oben zeigt, wie viele Datenquellen vorhanden sind, z. B. „2 von 10“. Möglich sind höchstens 10 Datenquellen (die Grundversion erlaubt eine); mehr sind mit einer Sonderlizenz möglich (callerhub.de). Datenquelle hinzufügen oben fragt zuerst nach der Art der Quelle (z. B. Microsoft SQL Server, Oracle, CSV-Datei, REST-API, LDAP) und der Bezeichnung; danach öffnet sich die neue Karte. Die Art lässt sich im Feld Quelle von Schritt 1 nur ändern, solange keine Verbindungsdaten eingetragen sind; für eine andere Art legen Sie eine neue Datenquelle an. Es erscheinen nur die passenden Felder. Beim Speichern werden alle fehlenden Pflichtfelder einer Datenquelle gemeinsam markiert. Verbindung testen prüft die Werte im Formular (auch ungespeichert), Speichern und übernehmen aktiviert sie. Alle Beispielwerte unten sind erfunden und dienen als Muster.

Felder für alle Quellen

Microsoft SQL Server

-- Number list (the column aliases nummer, anzeigename, rang, land and id are essential):
SELECT c.phone AS nummer, c.company + ' - ' + c.name AS anzeigename, 0 AS rang, c.country AS land, c.id AS id
FROM dbo.contacts c WHERE c.phone IS NOT NULL

Oracle

MySQL / MariaDB, PostgreSQL, andere ODBC-Datenbanken

Die Treibernamen hängen von der installierten Version ab; die Auswahlliste zeigt die auf diesem Computer installierten 64-Bit-Treiber.

CSV-Datei (auch DATEV-, Excel- und CRM-Export)

Standardformat (ohne Zuordnung): UTF-8, Semikolon, keine Kopfzeile, Zeilen, die mit # beginnen, werden ignoriert.

# Phone number;Display name;Country (optional);Link (optional)
030 1234560;Testkunde GmbH - Frau Beispiel;DE;https://crm.example.com/kontakt/1001
+41 44 123 45 67;Beispiel AG Zürich;;
044 765 43 21;Muster Treuhand AG;CH;

Spalten zuordnen liest CSV-Dateien mit beliebigem Aufbau, z. B. einen Export der Debitoren/Kreditoren aus DATEV, eine Excel-Liste oder einen CRM-Export. Beim ersten Öffnen schlägt CallerHub anhand der Spaltennamen eine Zuordnung vor (Telefon, Mobil, Firma, Vorname/Nachname, Land, Konto); Vorschlag wiederholt das, Standardformat entfernt die Zuordnung. Die Vorschau zeigt die ersten Zeilen der Datei und das Ergebnis.

"EXTF";700;16;"Debitoren/Kreditoren";…          ← DATEV header line, skipped
"Konto";"Name (Adressatentyp Unternehmen)";"Name (Adressatentyp natürl. Person)";"Vorname (Adressatentyp natürl. Person)";"Land";"Telefon";"Mobil"
10001;"Müller und Söhne GmbH";"";"";"DE";"0711 4561230";""
10002;"";"Schäfer";"Jürgen";"AT";"01 5551234";"0664 1234567"

Ergebnis mit dem Vorschlag: 0711 4561230 → „Müller und Söhne GmbH“, +43 664 1234567 → „Jürgen Schäfer“. Felder in Anführungszeichen dürfen Trennzeichen, verdoppelte Anführungszeichen und Zeilenumbrüche enthalten. Wird der Export regelmäßig an dieselbe Stelle geschrieben, übernimmt CallerHub die Änderungen automatisch.

Spaltennamen und Aufbau eines DATEV-Exports hängen von Programm, Version und Exporteinstellungen ab. Das Beispiel ist nachgebaut und wurde nicht mit einem echten DATEV-Export geprüft; kontrollieren Sie die Vorschau im Dialog. CallerHub liest nur die exportierte Datei und greift nicht auf DATEV selbst zu.

REST-API (HubSpot, Salesforce, Pipedrive, SuiteCRM, SugarCRM, Zoho, Odoo, SAP, Dynamics 365, eigene API)

Die REST-Vorlagen (HubSpot, Salesforce, SuiteCRM, SugarCRM, Zoho CRM, Odoo, SAP S/4HANA, Microsoft Dynamics 365, Business Central online, Finance & Supply Chain, Infor ION API, bexio, HERO, Clio, Jobber) sind Beispiele und wurden nicht mit echten Konten geprüft; für ServiceTitan gibt es keine Vorlage, weil dessen Kontaktschnittstelle keine Namen liefert; die Anmeldeverfahren wurden mit einem Testserver geprüft. Gleichen Sie Feldnamen und API-Versionen mit der Dokumentation des Anbieters ab. Für Oracle NetSuite gibt es noch keine Vorlage, weil dessen Anmeldung ein JWT-Zertifikat erfordert.

LDAP / Active Directory

Microsoft 365 (Graph)

Exchange (EWS)

Microsoft hat angekündigt, EWS in Exchange Online abzuschalten; verwenden Sie für Microsoft 365 stattdessen die Quelle „Microsoft 365 (Graph)“. Prüfen Sie den aktuellen Stand bei Microsoft.

Telefonnummernliste und Direktabfrage

Telefonnummernliste (empfohlen): lädt alle Telefonnummern beim Start und im Intervall; jeder Anruf wird aus dem Arbeitsspeicher beantwortet. Schlägt eine Aktualisierung fehl, bleibt die bisherige Liste aktiv.

Direktabfrage bei jedem Anruf: Parameter (in allen Datenbanken gleich geschrieben; CallerHub übersetzt sie in @name bzw. ?):

Telefonnummern werden vereinheitlicht: Leerzeichen, Bindestriche, Schrägstriche, Klammern und „(0)“ werden entfernt; + und 00 kennzeichnen internationale Telefonnummern. Das SQL-Feld hebt Schlüsselwörter, Zeichenketten, Zahlen, Kommentare und Parameter farbig hervor; Mit KI entwerfen bereitet eine Frage für den Chat vor.

Lesebenutzer CALLERHUB anlegen (Oracle, SQL Server)

SQL-Assistent: Schritt 2 einer Datenbankquelle enthält die Schaltfläche SQL-Assistent …. Er liest den Datenbankkatalog (nur lesend, ändert nichts), schlägt Tabellen mit Spalten für Telefonnummer und Name vor (vorausgewählt: die wahrscheinlichsten, mit Anzahl der Einträge), baut die Abfrage für die Telefonnummernliste (schließt dabei auch gelöschte oder inaktive Datensätze aus, sofern eine passende Spalte vorhanden ist) und zeigt eine Vorschau der ersten Zeilen. Nach Übernehmen zeigt er ein Skript für einen auf die gewählten Tabellen beschränkten Lesebenutzer (SQL Server, Oracle, MySQL/MariaDB, PostgreSQL), das Sie dem Datenbankadministrator übergeben. Viele CRM- und ERP-Systeme führen Telefonnummern in einer eigenen Kommunikationstabelle (eine Zeile je Telefonnummer, Faxnummer oder E-Mail-Adresse). Der Assistent erkennt solche Tabellen und schlägt eine verknüpfte Abfrage vor: Er verbindet die Tabelle über ihre Schlüsselspalten – auch über Zwischentabellen – mit den Tabellen der Firmen- und Personennamen (LEFT JOIN, wo eine Person optional ist) und ergänzt einen Kommentar, wenn eine Spalte Telefon, Fax und E-Mail unterscheidet, sodass Sie danach filtern können.

CallerHub braucht nur Leserechte auf die Tabellen oder Sichten, aus denen die SQL-Abfrage liest. Verwenden Sie kein Verwaltungskonto (z. B. SYSTEM oder sa): Ein eigenes Konto begrenzt die Rechte, und eine Kontosperre trifft nicht die Datenbankverwaltung. CallerHub schlägt deshalb den Benutzer CALLERHUB vor.

Alle Namen unten sind Beispiele: Schema bzw. Datenbank CRM, Tabellen KONTAKTE und FIRMEN, Container ORCLPDB1. Ersetzen Sie sie durch die Namen Ihres Systems, und lassen Sie die Befehle vom Datenbankadministrator prüfen und ausführen.

Oracle

Melden Sie sich als DBA am Dienst der Datenbank an, die das Schema enthält. Bei einer Container-Datenbank (CDB) ist das die Pluggable Database, nicht der Root (CDB$ROOT).

-- container database only: switch to the correct PDB
ALTER SESSION SET CONTAINER = ORCLPDB1;

CREATE USER CALLERHUB IDENTIFIED BY "Secure#Password1";
GRANT CREATE SESSION TO CALLERHUB;

-- read only (READ from Oracle 12c; older versions: SELECT)
GRANT READ ON CRM.KONTAKTE TO CALLERHUB;
GRANT READ ON CRM.FIRMEN   TO CALLERHUB;

Optional legen Sie ein eigenes Profil an, damit das Passwort nicht nach der Standardfrist abläuft (sonst ORA-28001). Ob das zu Ihren Sicherheitsvorgaben passt, entscheidet der Administrator:

CREATE PROFILE CALLERHUB_PROFILE LIMIT
  PASSWORD_LIFE_TIME    UNLIMITED
  FAILED_LOGIN_ATTEMPTS 10
  PASSWORD_LOCK_TIME    1/24;   -- locked for 1 hour after 10 failed attempts
ALTER USER CALLERHUB PROFILE CALLERHUB_PROFILE;

Prüfen (angemeldet als CALLERHUB): SELECT COUNT(*) FROM CRM.KONTAKTE;

Microsoft SQL Server

SQL-Anmeldungen setzen den gemischten Modus voraus (Servereigenschaften → Sicherheit → „SQL Server- und Windows-Authentifizierungsmodus“). Alternativ verwenden Sie die Windows-Anmeldung mit dem Dienstkonto von CallerHub (siehe unten).

USE master;
CREATE LOGIN CALLERHUB WITH PASSWORD = N'Secure#Password1',
       CHECK_POLICY = ON, CHECK_EXPIRATION = OFF;

USE CRM;
CREATE USER CALLERHUB FOR LOGIN CALLERHUB;

-- read only the tables needed ...
GRANT SELECT ON dbo.KONTAKTE TO CALLERHUB;
GRANT SELECT ON dbo.FIRMEN   TO CALLERHUB;
-- ... or read all tables of the database
-- ALTER ROLE db_datareader ADD MEMBER CALLERHUB;

Prüfen: EXECUTE AS LOGIN = 'CALLERHUB'; SELECT TOP 1 * FROM dbo.KONTAKTE; REVERT;

Windows-Anmeldung statt Passwort: CREATE LOGIN [COMPANY\svc-callerhub] FROM WINDOWS;, dann CREATE USER und GRANT wie oben mit diesem Namen; betreiben Sie CallerHub als Dienst unter diesem Konto, und wählen Sie in der Karte Datenbank Windows-Anmeldung.

Schutz vor Kontosperre

Lehnt die Datenbank die Anmeldung ab (Oracle ORA-01017/ORA-28000, SQL Server 18456, MySQL/MariaDB 1045, PostgreSQL 28P01), unternimmt CallerHub keine weiteren automatischen Anmeldeversuche – weder bei der Aktualisierung der Telefonnummernliste noch bei der Direktabfrage je Anruf. Die Leiste Datenquelle zeigt dann „Angehalten“ mit dem Grund, ebenso Systemzustand und Benachrichtigungen. Die Pause endet, sobald die Zugangsdaten geändert und gespeichert werden oder Verbindung testen erfolgreich ist.

Abfrage für die eigene Datenbank finden (Oracle, SQL Server)

Am schnellsten geht es mit dem SQL-Assistent … in Schritt 2 (siehe oben). Die folgenden Schritte beschreiben den manuellen Weg, z. B. wenn der Assistent keine passende Tabelle findet.

Gibt es für Ihr CRM oder ERP keine fertige Vorlage, ermitteln Sie Tabellen und Spalten in vier Schritten selbst. Alle Abfragen lesen nur. Am besten führen Sie sie als Lesebenutzer CALLERHUB in SQL Developer bzw. sqlplus (Oracle) oder SQL Server Management Studio aus. Die Namen CRM, CUSTOMERS und CONTACTS sowie alle Spaltennamen sind Beispiele.

1. Spalten mit Telefonnummer, Name und Land suchen

Oracle:

SELECT owner, table_name, column_name, data_type
  FROM all_tab_columns
 WHERE owner NOT IN ('SYS', 'SYSTEM', 'XDB', 'MDSYS', 'CTXSYS', 'ORDSYS', 'OLAPSYS', 'WMSYS')
   AND REGEXP_LIKE(column_name, 'TEL|PHON|FON|MOBIL|HANDY|NAME|FIRMA|COMPANY|LAND|COUNTRY|LKZ', 'i')
 ORDER BY owner, table_name, column_id;

Microsoft SQL Server (in der richtigen Datenbank ausführen, z. B. nach USE CRM;):

SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME, DATA_TYPE
  FROM INFORMATION_SCHEMA.COLUMNS
 WHERE COLUMN_NAME LIKE '%tel%'   OR COLUMN_NAME LIKE '%phon%' OR COLUMN_NAME LIKE '%fon%'
    OR COLUMN_NAME LIKE '%mobil%' OR COLUMN_NAME LIKE '%handy%'
    OR COLUMN_NAME LIKE '%name%'  OR COLUMN_NAME LIKE '%firma%' OR COLUMN_NAME LIKE '%company%'
    OR COLUMN_NAME LIKE '%land%'  OR COLUMN_NAME LIKE '%country%'
 ORDER BY TABLE_SCHEMA, TABLE_NAME, ORDINAL_POSITION;

Kandidaten sind Tabellen mit mehreren Treffern, z. B. CUSTOMERS mit PHONE, MOBILE, COMPANY_NAME und COUNTRY. Bei Oracle zeigt SELECT table_name, num_rows FROM all_tables WHERE owner = 'CRM' ORDER BY num_rows DESC NULLS LAST; die größten Tabellen.

2. Eine bekannte Telefonnummer suchen

Helfen die Spaltennamen nicht weiter, suchen Sie eine bekannte Telefonnummer, z. B. die eigene Zentrale. Verwenden Sie nur die letzten Ziffern (4567890), weil die Schreibweise abweicht. Die folgende Abfrage erzeugt je Textspalte eine Prüfabfrage. Kopieren Sie die Ausgabe, entfernen Sie das letzte UNION ALL, und führen Sie sie aus; das Ergebnis nennt Tabelle und Spalte mit Treffern.

Oracle:

SELECT 'SELECT ''' || owner || '.' || table_name || '.' || column_name || ''' AS location, COUNT(*) AS hits FROM '
       || owner || '.' || table_name || ' WHERE ' || column_name || ' LIKE ''%4567890%'' HAVING COUNT(*) > 0 UNION ALL'
  FROM all_tab_columns
 WHERE owner = 'CRM' AND data_type IN ('VARCHAR2', 'NVARCHAR2', 'CHAR', 'NCHAR');

Microsoft SQL Server:

SELECT 'SELECT ''' + TABLE_SCHEMA + '.' + TABLE_NAME + '.' + COLUMN_NAME + ''' AS location, COUNT(*) AS hits FROM ['
       + TABLE_SCHEMA + '].[' + TABLE_NAME + '] WHERE [' + COLUMN_NAME + '] LIKE ''%4567890%'' HAVING COUNT(*) > 0 UNION ALL'
  FROM INFORMATION_SCHEMA.COLUMNS
 WHERE TABLE_SCHEMA = 'dbo' AND DATA_TYPE IN ('varchar', 'nvarchar', 'char', 'nchar');

Begrenzen Sie die Suche bei großen Datenbanken auf ein Schema oder einzelne Tabellen, sonst dauert sie lange.

3. Inhalte ansehen

-- Oracle (12c and later; older versions: WHERE ROWNUM <= 20)
SELECT customer_no, company_name, company_name2, phone, mobile, country FROM crm.customers FETCH FIRST 20 ROWS ONLY;
-- SQL Server
SELECT TOP 20 customer_no, company_name, company_name2, phone, mobile, country FROM dbo.customers;

Prüfen Sie: Welche Spalte enthält den Namen, der am Telefon erscheinen soll? Stehen Ansprechpartner in einer eigenen Tabelle? Stehen die Telefonnummern in einer eigenen Kommunikationstabelle (dafür schlägt der SQL-Assistent … eine verknüpfte Abfrage vor)? Enthält country einen ISO-Code (DE), einen Namen oder eine Vorwahl? Die Schreibweise der Telefonnummern ist gleichgültig; CallerHub vereinheitlicht sie.

4. Abfrage für die Telefonnummernliste ableiten

CallerHub erwartet die Spalten nummer (Telefonnummer) und anzeigename (Anzeigename), optional rang (Rang), land (Land), id und link (siehe Telefonnummernliste). Diese Aliasse sind feste Namen und stehen auch über dem SQL-Feld; nur die Tabellen- und Spaltennamen nach SELECT und FROM hängen von Ihrer Datenbank ab. CallerHub akzeptiert auch die englischen Aliasse displayname, country und rank. Jede Spalte mit Telefonnummern ergibt einen Teil; UNION ALL verbindet die Teile.

Oracle:

SELECT c.phone AS nummer, c.company_name AS anzeigename, 0 AS rang, c.country AS land, c.customer_no AS id
  FROM crm.customers c WHERE c.phone IS NOT NULL
UNION ALL
SELECT c.mobile, c.company_name, 0, c.country, c.customer_no
  FROM crm.customers c WHERE c.mobile IS NOT NULL
UNION ALL
SELECT p.phone, c.company_name || ' - ' || p.first_name || ' ' || p.last_name, 1, c.country, c.customer_no
  FROM crm.contacts p JOIN crm.customers c ON c.customer_no = p.customer_no
 WHERE p.phone IS NOT NULL

Microsoft SQL Server:

SELECT c.phone AS nummer, c.company_name AS anzeigename, 0 AS rang, c.country AS land, c.customer_no AS id
  FROM dbo.customers c WHERE c.phone <> ''
UNION ALL
SELECT c.mobile, c.company_name, 0, c.country, c.customer_no
  FROM dbo.customers c WHERE c.mobile <> ''
UNION ALL
SELECT p.phone, CONCAT(c.company_name, ' - ', p.first_name, ' ', p.last_name), 1, c.country, c.customer_no
  FROM dbo.contacts p JOIN dbo.customers c ON c.customer_no = p.customer_no
 WHERE p.phone <> ''

• rang 0 für Firmen, 1 für Ansprechpartner: Steht dieselbe Telefonnummer bei beiden (z. B. die Zentrale), gewinnt die Firma.
• Tragen Sie die Abfrage unter Datenquellen → Schritt 2: Telefonnummernliste ein. Verbindung testen lädt die ganze Liste und meldet die Anzahl; danach Speichern und übernehmen.
• Geben Sie dem Lesebenutzer Leserechte auf die verwendeten Tabellen (siehe Lesebenutzer).

Direktabfrage (nur bei Bedarf)

Bei sehr großen Tabellen kann CallerHub die Datenbank bei jedem Anruf mit Parametern abfragen (siehe Direktabfrage). Weil die Datenbank Telefonnummern in beliebiger Schreibweise enthält, vergleichen Sie nur die Ziffern:

-- Oracle
SELECT company_name AS anzeigename FROM crm.customers
 WHERE REGEXP_REPLACE(phone, '[^0-9]', '') IN (:num_national, :num_digits, '00' || :num_digits)
-- SQL Server
SELECT TOP 1 company_name AS anzeigename FROM dbo.customers
 WHERE REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(phone, ' ', ''), '-', ''), '/', ''), '(', ''), ')', ''), '+', '')
       IN (:num_national, :num_digits, '00' + :num_digits)

Eine Funktion auf der Spalte verhindert die Nutzung des Index; bei großen Tabellen wird die Abfrage langsam. Besser ist eine Sicht oder Spalte mit bereits vereinheitlichter Telefonnummer – oder die Telefonnummernliste.

Vorlagen für CRM- und ERP-Systeme

Vorlage (Karte Telefonnummernliste) setzt SQL bzw. eine Definition für die gewählte Quelle ein. Beim Wechsel der Quelle wird eine unveränderte Vorlage automatisch ersetzt; eigenes SQL bleibt erhalten.

Außer Infor COM wurde keine Vorlage mit einer echten Installation des jeweiligen Systems geprüft. Tabellen-, Spalten- und Feldnamen beruhen auf veröffentlichten Datenmodellen und können je nach Version und Anpassung abweichen. Prüfen Sie sie vor dem Einsatz mit Verbindung testen und einer Testabfrage.

Mehrere Datenquellen

• Legen Sie in der festen Leiste der Seite Datenquellen mit Datenquelle hinzufügen bis zu 10 Quellen an (der Zähler zeigt z. B. „2 von 10“; mehr mit einer Sonderlizenz, siehe callerhub.de), z. B. „CRM“ (SQL Server) und „Telefonbuch“ (Active Directory). Jede Quelle hat eine eigene Verbindung, Abfrage und einen eigenen Abfragemodus.
• Die Quellen werden in der angezeigten Reihenfolge abgefragt; die erste Quelle mit Treffer liefert den Namen. Die Schaltflächen nach oben und nach unten im Kopf der geöffneten Karte ändern die Reihenfolge; alternativ ziehen Sie eine Karte an ihrem Kopf an eine andere Position. Danach Speichern und übernehmen.
• Welche Quellen eine Telefonanlage abfragt, legt ihre Schnittstelle fest: Schnittstellen → Telefonanlage → Abgefragte Datenquellen (Vorgabe: alle, auch später hinzugefügte).
• Fällt eine Quelle aus, liefern die anderen weiter. Findet keine Quelle die Telefonnummer und ist eine Quelle gestört, antwortet CallerHub mit 503, damit der Ausfall nicht als „unbekannt“ zwischengespeichert wird. Die Statusanzeige zeigt „Datenfehler“ mit dem Namen der Quelle.
• Die Spalte Quelle in Protokoll und Status zeigt, woher der Name kam, z. B. Liste/CRM; mit Plugin z. B. Liste/CRM/Plugin.

Länder und Vorwahlen

Nationale Telefonnummern (z. B. 044 123 45 67) brauchen eine Ländervorwahl. Liefert die Liste eine Spalte land (bzw. country) oder die CSV-Datei eine dritte Spalte, gilt die Ländervorwahl je Zeile. Die Ländervorwahl unter Administration → Erweitert (Beispiel 49) gilt nur, wenn das Land fehlt oder unbekannt ist.

• Telefonnummern mit + oder 00 sind bereits international.
• Die Verkehrsausscheidungsziffer wird je Land berücksichtigt: meist 0; keine z. B. in Italien (die führende 0 bleibt Teil der Telefonnummer), Spanien, Portugal, Griechenland, Dänemark, Norwegen, Luxemburg, Polen und Tschechien; 1 in Nordamerika, 06 in Ungarn, 8 in Russland und Kasachstan.
• Unbekannte Landangaben meldet das Protokoll als Warnung mit Beispielen und Anzahl.

Die Regeln decken gängige Länder ab; prüfen Sie Sonderfälle (z. B. Änderungen von Nummernplänen) mit einer Testabfrage.

Zwischenspeicher

Die Telefonnummern liegen nur im Arbeitsspeicher des laufenden Programms – nicht in einer Datenbank und nicht in einer Datei. Nach dem Beenden oder Stoppen sind sie weg und werden beim nächsten Start neu geladen.

Neu laden lädt die Listen sofort neu; Cache leeren verwirft zusätzlich die Ergebnisse der Direktabfrage. Während des Ladens bleibt die bisherige Liste aktiv.

Schnittstellen und Telefonanlagen

Auf der Seite Schnittstellen wird jede Telefonanlage (bzw. jedes Telefon mit Telefonbuch-Abfrage) als eigene Schnittstelle angebunden, jede als eigene Karte. Höchstens 10 Schnittstellen sind möglich – der Zähler oben zeigt z. B. „1 von 10“; die Edition Basic erlaubt eine, mehr sind mit einer Sonderlizenz möglich (callerhub.de). Wie bei den Datenquellen lassen sich die Karten der Schnittstellen an ihrem Kopf ziehen, um die Reihenfolge zu ändern. Alle Schnittstellen teilen Port und HTTPS (Administration › Server; die Zeile oben auf der Seite zeigt die Adresse und verweist dorthin); CallerHub erkennt die anfragende Anlage an ihrem API-Key. Je Schnittstelle gelten eigene erlaubte IP-Adressen und eine eigene Auswahl der abgefragten Datenquellen. Eine neue Installation beginnt ohne Schnittstelle: Die Karte Erste Schnittstelle hinzufügen öffnet die Auswahl der Telefonanlage. Bis dahin beantwortet CallerHub Anfragen mit 503 „Keine Schnittstelle eingerichtet“.

Anleitung anzeigen (Link rechts in der Karte) öffnet die Einrichtungsanleitung für die gewählte Telefonanlage. Alle Anleitungen folgen denselben Schritten: 1. Adresse (die URL, unter der CallerHub antwortet), 2. In der Telefonanlage eintragen (wohin die Adresse gehört), 3. Antwort (was die Telefonanlage erhält), 4. Test (im Browser, dann mit einem Anruf) und, sofern vorhanden, Optional: Anrufanalyse (wie Anrufdaten zu CallerHub gelangen).

Nur die STARFACE-Anbindung ist im Einsatz erprobt. Die Anleitungen für 3CX, Asterisk/FreePBX, VitalPBX, Issabel, Yealink/Fanvil und Snom beruhen auf veröffentlichten Schnittstellen; gleichen Sie Platzhalter, Menüpfade und Einstellungsnamen mit der Dokumentation Ihrer Version ab.

Telefonanlagen einrichten

Bevor Sie beginnen

• Mindestens eine Datenquelle ist bereit (Zustand „Bereit“ auf der Startseite), und eine Testabfrage mit einer bekannten Nummer liefert den erwarteten Namen.
• Netzwerk: Die Telefonanlage (bzw. die Telefone) erreicht den CallerHub-Rechner über den Port (Vorgabe 8080, HTTPS z. B. 8443). Die Windows-Firewall lässt den Port zu; Administration → Systemzustand bietet eine Schaltfläche für die Firewall-Regel.
• Bekannte Adressen: die IP-Adresse der Telefonanlage bzw. das Netz der Telefone, für Erlaubte IP-Adressen.
• Administratorzugang zur Weboberfläche der Telefonanlage bzw. zur Provisionierung der Telefone.
• CallerHub läuft nur an einer Stelle – entweder als Dienst oder im Programmfenster (siehe Windows-Dienst).

So funktioniert die Abfrage

Bei jedem eingehenden Anruf ruft die Telefonanlage eine Adresse von CallerHub auf und erhält den Namen. Parameter von /lookup:

Antworten: 200 mit dem Namen (leer, wenn unbekannt), 401 API-Key falsch oder fehlend, 403 IP-Adresse für diese Schnittstelle nicht erlaubt, 429 nach zu vielen falschen Schlüsseln vorübergehend gesperrt, 503 keine Datenquelle bereit. /health liefert OK ohne Schlüssel (Prüfung der Erreichbarkeit).

Ablauf

Für jede Anlage gilt derselbe Ablauf. Die Beispiele verwenden 192.168.10.5 als Server von CallerHub, Port 8080 und den Platzhalter API-KEY; die vollständige Adresse mit dem echten Schlüssel liefert Anleitung kopieren.

1. Schnittstellen → Hinzufügen (bei einer neuen Installation Erste Schnittstelle hinzufügen), Telefonanlage wählen, Bezeichnung eingeben.
2. Erlaubte IP-Adressen: die IP-Adresse der Anlage bzw. der Telefone eintragen (z. B. 192.168.10.20 oder 192.168.20.0/24 für ein Telefonnetz).
3. Abgefragte Datenquellen prüfen, dann Speichern und übernehmen.
4. Im Browser eines Rechners im selben Netz testen: http://192.168.10.5:8080/lookup?apikey=API-KEY&number=030 1234560 liefert den Namen (leer, wenn unbekannt). 401 = Schlüssel falsch, 403 = IP-Adresse nicht erlaubt.
5. Die Anlage wie unten beschrieben einrichten und einen Testanruf führen. Die Leiste zeigt danach „Anfrage hh:mm“; die Startseite listet den Zugriff unter Letzte Zugriffe.

STARFACE

Die STARFACE hat keine eingebaute Namensabfrage per Web-Adresse; sie fragt CallerHub über ein Modul ab. Bei einem eingehenden Anruf ruft das Modul die Adresse von CallerHub auf und zeigt die Antwort (Text) als Anrufernamen an.

1. Adresse und API-Key: http://192.168.10.5:8080/lookup?number=<number>, API-Key als Header X-Api-Key oder Parameter apikey. Test im Browser: http://192.168.10.5:8080/lookup?number=07114567890&apikey=API-KEY.
2. Modul anlegen: In der Weboberfläche der STARFACE Admin → Module → Modul-Library; im Module Designer eine Funktion für eingehende Anrufe mit den Bausteinen CreateHttpUrlWithParams, HttpRequest (GET), ReadFromStream (UTF-8) und SetCallerId (Name = Antwort) anlegen. Bildschirmfotos dieser Bausteine zeigt das STARFACE-Wiki: Webservices aus dem Modulsystem ansteuern.
3. Oder ein fertiges Modul importieren: Admin → Module → Modul-Library → Modul importieren, die Datei .sfm wählen, eine Modulkonfiguration mit Adresse und API-Key anlegen und aktivieren. Bildschirmfotos: Import von neuen Modulen.
4. Einen Testanruf von einer im CRM gespeicherten Nummer führen. Der Zugriff erscheint in CallerHub unter Letzte Zugriffe.

Als Vorlage liegt das Beispielmodul Samples\CRM-Lookup_v3.sfm bei; Aufbau und Einschränkungen beschreibt der Abschnitt STARFACE-Beispielmodul. CallerHub zeigt diese Anleitung mit dem echten API-Key auch unter Schnittstellen → Telefonanlage → Anleitung.

3CX

1. In der Karte Telefonanlage „3CX (CRM-Vorlage)“ wählen, Speichern und übernehmen klicken, dann 3CX-Vorlage … speichern. Die Datei enthält Adresse und API-Key.
2. In der 3CX-Verwaltungskonsole unter Integrationen → CRM (Menüpfad je nach Version) die Vorlage hochladen und CallerHub als CRM auswählen.
3. Die Suche nach Telefonnummern einschalten. 3CX fragt mit format=json und erhält name, phone und – falls hinterlegt – die url des Datensatzes.

Asterisk / FreePBX

1. Voraussetzung: Das Modul func_curl ist geladen (asterisk -rx "module show like curl").
2. Im eingehenden Kontext (FreePBX: /etc/asterisk/extensions_custom.conf, Kontext from-pstn-custom o. ä.) vor dem Wählen den Namen setzen:

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)

• Wählplan neu laden: asterisk -rx "dialplan reload". Ist CallerHub nicht erreichbar, bleibt der Name nach 2 Sekunden leer.
• Bei HTTPS muss Asterisk dem Zertifikat vertrauen (Stammzertifikat auf dem Asterisk-Server hinterlegen).

Yealink / Fanvil (Remote-Telefonbuch)

1. Weboberfläche des Telefons: Telefonbuch → Remote-Telefonbuch, Adresse http://192.168.10.5:8080/lookup?format=yealink&apikey=API-KEY&number=#SEARCH, Name CallerHub.
2. Unter Funktionen bzw. Telefonbuch die Namenssuche für eingehende Anrufe im Remote-Telefonbuch einschalten (Bezeichnung je nach Firmware).
3. Für viele Telefone per 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

Erlaubte IP-Adressen: das Netz der Telefone, z. B. 192.168.20.0/24.

Snom

1. Weboberfläche bzw. Provisionierung: Adresse des XML-Telefonbuchs http://192.168.10.5:8080/lookup?format=snom&apikey=API-KEY&number=#SEARCH.
2. Die Suche für eingehende Anrufe im XML-Telefonbuch einschalten; Einstellungsnamen und Platzhalter mit der Snom-Dokumentation Ihrer Firmware abgleichen.

Andere Anlagen (allgemein)

Jede Anlage, die bei einem Anruf eine Adresse per HTTP GET abrufen kann, lässt sich anbinden. format= wählt die Antwort: text (nur der Name), json oder xml. Optional ergänzen &called= (angerufene Nummer) und &user= (Benutzer) die Statistik. Beispiel für einen Test mit curl:

curl -H "X-Api-Key: API-KEY" "http://192.168.10.5:8080/lookup?format=json&number=%2B49301234560"

Anlagen ohne HTTP-Abfrage

Unify OpenScape Business, Auerswald, Avaya IP Office, Gigaset und viele Tischtelefone lösen Namen über LDAP auf; Cloud-Anlagen (Teams, Zoom, NFON, Placetel …) und die FRITZ!Box verwenden eigene Kontaktlisten. Verwenden Sie für diese das Modul Telefonbuch (LDAP-Telefonbuch oder Export).

Typische Fehler bei der Anbindung

Bleibt die Ursache unklar: ☰ → Fehleranalyse → Erweiterte Aufzeichnung starten …, einen Testanruf führen und die Aufzeichnung prüfen oder sie in einem Diagnosepaket senden. Die Aufzeichnung enthält jede Anfrage mit allen Headern und Parametern (Schlüssel maskiert).

Telefonbuch: LDAP, Export und FRITZ!Box (Modul)

Viele Telefonanlagen und Tischtelefone rufen keine Web-Adresse auf, sondern fragen ein LDAP-Verzeichnis ab – etwa Unify OpenScape Business, Auerswald COMtrexx/COMpact (als LDAP-Proxy für ihre Telefone), Avaya J100 an IP Office, Yeastar P-Series, innovaphone (Reverse Lookup), Ascom IP-DECT, Grandstream UCM und pascom sowie Telefone von Yealink, Snom, Gigaset, Fanvil und Grandstream. Cloud-Anlagen (Microsoft Teams, Zoom, RingCentral, Webex, NFON, Placetel) und die FRITZ!Box zeigen Namen nur aus ihren eigenen Kontaktlisten. Das Modul Telefonbuch (LDAP und Export) deckt beides ab. Schalten Sie es unter Administration → Module ein; die Karte Telefonbuch erscheint auf der Seite Schnittstellen.

LDAP-Telefonbuch

• Nur Lesen (LDAPv3): Anmeldung, Suche, Abmeldung. Schreibversuche werden abgelehnt.
• Rückwärtssuche: Sucht das Telefon nach einer Nummer (z. B. (telephoneNumber=07111234567)), fragt CallerHub alle aktiven Datenquellen – auch Direktabfragen – mit Regeln, Sperrliste und VIP-Liste ab. Die Nummer darf national, mit +49 oder 0049 geschrieben sein.
• Namenssuche (Telefonbuch am Telefon, z. B. (|(cn=Mül*)(sn=Mül*))) und Suchen mit Platzhaltern nutzen die Telefonnummernlisten im Arbeitsspeicher; Quellen mit Direktabfrage lassen sich nicht nach Namen durchsuchen.
• Einträge: uid (internationale Nummer), cn/sn/displayName (Anzeigename), telephoneNumber (national und E.164), labeledURI (Link zum Datensatz), objectClass inetOrgPerson. Höchstens 200 Einträge je Suche.
• Abfragen erscheinen in Protokoll und Statistik mit der Schnittstelle LDAP.

Die Karte zeigt zu jedem Gerät die einzutragenden Werte. Allgemein gilt:

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
Rückwärtssuche bei eingehenden Anrufen: ein

Die Bezeichnungen der Felder und der Platzhalter (%, %s oder *) unterscheiden sich je nach Hersteller und Firmware; ziehen Sie das Handbuch des Geräts heran. Yealink: Weboberfläche Directory → LDAP. Bei Telefonanlagen (Unify, Auerswald, Avaya) wird CallerHub als externes LDAP-Verzeichnis der Anlage eingetragen; die Anlage gibt die Namen an ihre Telefone weiter.

Mitel-100-Familie (Mitel 112, 130, 150; früher Aastra OpenCom 100)

Diese Anlagen fragen keine Web-Adresse ab, können aber je Firma ein externes LDAP-Verzeichnis einbinden. Einstellungen in der Web-Konsole der Anlage (Release 12.1, mit CallerHub noch nicht getestet):

1. Telefonie → Erweitert → Firmen → (Ihre Firma) → LDAP-Server: Status ein, Server = Name oder IP-Adresse des CallerHub-Rechners, Port 389, Benutzername und Kennwort wie in der Karte von CallerHub, BaseDN ou=callerhub.
2. Doppelter Telefonbucheintrag: LDAP + zentral verwenden behält die Einträge des zentralen Telefonbuchs. Rufnummer: mit transparent beginnen; erscheint kein Name, konvertieren versuchen. Cache löschen: z. B. 60 Minuten.
3. User Manager → Benutzergruppen: Telefonbuch: LDAP verwenden für die betroffenen Gruppen ankreuzen.
4. In CallerHub die IP-Adresse der Anlage unter Erlaubte IP-Adressen eintragen und die Firewall-Regel anlegen (Systemzustand).

Ob die Anlage den LDAP-Namen bei eingehenden Anrufen oder nur in der Telefonbuchsuche anzeigt, hängt vom Release ab; prüfen Sie das mit einem Testanruf.

Telefonbuch exportieren

Die Schaltflächen der Karte speichern die Einträge der Telefonnummernlisten (nach Regeln, ohne gesperrte Nummern) als Datei. Voraussetzung: Die Schnittstelle läuft.

Telefone mit Remote-Telefonbuch können die Liste auch direkt laden (Modul Browser-Zugang, Zugangsschlüssel aus Administration → Browser-Zugang):

http://192.168.10.5:8080/phonebook?format=yealink&key=ZUGANGSSCHLUESSEL
(format: yealink, fritzbox, vcard, csv)

FRITZ!Box

• Namen bei eingehenden Anrufen: Die FRITZ!Box fragt keine externe Adresse ab. Exportieren Sie das Telefonbuch als FRITZ!Box-XML und importieren Sie es (siehe oben); nach Änderungen im CRM erneut exportieren.
• Anrufanalyse: Tragen Sie unter Administration → Modul: Anrufanalyse die Adresse der FRITZ!Box ein (z. B. fritz.box). CallerHub liest den Anrufmonitor (Port 1012) und schreibt jeden beendeten Anruf in CallData\FRITZ!Box\fritzbox-YYYY-MM.csv. Schalten Sie den Anrufmonitor einmalig an einem angeschlossenen Telefon mit #96*5* ein (#96*4* schaltet ihn aus). Bei einem Verbindungsabbruch verbindet CallerHub alle 30 Sekunden neu.

STARFACE-Beispielmodul

Das Beispiel „CRM-Lookup“ zeigt, wie ein Modul für CallerHub im Module Designer der STARFACE aussehen kann. Es ergänzt die allgemeine Anleitung unter Telefonanlagen einrichten.

Einschränkungen des Beispiels Samples\CRM-Lookup_v3.sfm:

• nur als Vorlage zum Nachschlagen gedacht, auf keiner STARFACE getestet und nicht von STARFACE geprüft;
• Bausteinnamen aus einem STARFACE-Export (Version 10); Menü- und Feldbezeichnungen können je nach Version abweichen;
• nach dem Import zeigt die STARFACE einen Lizenzhinweis;
• nur eingehende Anrufe; anonyme Anrufe werden nicht abgefragt.

1. Voraussetzungen

• CallerHub läuft und ist von der STARFACE erreichbar (siehe Firewall).
• Die Adresse (z. B. https://lookup.company.com:8443/lookup) und der API-Key liegen vor (Schnittstellen → Telefonanlage).
• Test im Browser: https://lookup.company.com:8443/lookup?number=07114567890&apikey=API-KEY liefert einen Namen.

2. Modul anlegen

1. Den Module Designer öffnen und ein neues Modul anlegen. Name: CRM-Lookup, Hersteller: z. B. Ihr Firmenname.
2. Den Reiter Einstellungen mit dem Textfeld GUI_LOOKUP_URL (STRING) und dem Passwortfeld GUI_API_KEY (STRING) anlegen.
3. Die Funktion lookupCaller anlegen.

3. Bausteine in lookupCaller

Statt des Parameters apikey kann der Schlüssel als Header X-Api-Key gesendet werden (eine zweite Map als httpHeaders bei HttpRequest). Header erscheinen nicht in Proxy- oder Firewall-Protokollen.

4. Einstiegspunkt, Instanz, Test

1. Einen Einstiegspunkt für eingehende Anrufe mit dem Ziel lookupCaller anlegen; das Modul speichern.
2. Eine Instanz anlegen, URL und API-Key eintragen und unter „Log-Datei“ vorübergehend INFO wählen.
3. Von einer Telefonnummer anrufen, die im CRM gepflegt ist. Die Anfrage erscheint in CallerHub mit Absender-IP, angerufener Telefonnummer und Ergebnis. Kommt keine Anfrage an, prüfen Sie Adresse, Firewall und erlaubte IP-Adressen. Kommt eine Anfrage an, erscheint aber kein Name, prüfen Sie das Modul-Log und die Bedingung in Schritt 12.

Schnittstelle (HTTP)

GET /lookup?number=+4930123456                  Header X-Api-Key: <Schlüssel>  (oder Parameter apikey)
  → 200, Text: "Musterfirma AG - Frau Beispiel"   (leer, wenn unbekannt)
GET /lookup?number=…&called=201&user=zentrale    optionale Angaben für die Statistik
GET /lookup?number=…&format=json               → {"found":true,"name":"…","phone":"+4930123456","url":"…","source":"CRM"}
GET /lookup?number=…&format=xml                → <lookup found="true"><name>…</name><phone>…</phone></lookup>
GET /lookup?number=…&format=yealink|snom       → XML-Telefonbuch
GET /health                                      → OK (Verfügbarkeitsprüfung, zählt nicht in der Statistik)
GET /stats, /stats/data                          Statistik im Browser (Modul Browser-Zugang)
GET /open?number=…&key=…                        Weiterleitung zum CRM-Datensatz
GET /metrics, /status                            Monitoring (Prometheus-Text bzw. JSON)

Jede Schnittstelle hat einen eigenen API-Key; CallerHub beantwortet die Anfrage mit den Datenquellen dieser Schnittstelle. Fehlercodes: 401 falscher Schlüssel, 403 IP nicht erlaubt (allgemein oder für diese Schnittstelle), 404 unbekannter Pfad oder Modul ausgeschaltet, 405 falsche Methode, 503 Telefonnummernliste nicht bereit, Datenquellenfehler oder keine Datenquelle eingerichtet.

Konsolenbefehle

Rückgabewerte: 0 = Erfolg, 1 = Laufzeitfehler, 2 = Bedien- oder Konfigurationsfehler.

Anzeigename, Sperr- und VIP-Liste

Modul „Anzeigename, Sperr- und VIP-Liste“. Die Regeln gibt es zweimal, beide ergänzen sich:

• Global (Administration → Modul: Anzeigename, Sperr- und VIP-Liste): gilt für alle Datenquellen und Schnittstellen.
• Je Datenquelle (erweiterter Modus, Datenquellen → Anzeigename, Sperr- und VIP-Liste): gilt nur für die gewählte Quelle.

Reihenfolge bei jedem Anruf

1. Globale Sperrliste: Steht die Nummer darin, endet die Suche.
2. Die Datenquellen der Schnittstelle nacheinander: zuerst die Sperrliste der Quelle, dann die Abfrage; die erste Quelle mit Treffer liefert den Namen.
3. Ersetzungen der Quelle mit Treffer, danach die globalen Ersetzungen.
4. VIP-Liste der Quelle mit Treffer, sonst die globale VIP-Liste.
5. Zuletzt die Plugins.

Statistik

• Zeitraum: heute, gestern, letzte 7/30 Tage, dieser/letzter Monat, dieses Jahr oder frei. Bis 2 Tage nach Stunden, bis 92 Tage nach Tagen, darüber nach Monaten.
• Auswerten nach: alle Anfragen, angerufene Telefonnummer, Benutzer, IP-Adresse, Datenquelle (Trefferquote je Quelle), Schnittstelle (je Telefonanlage) oder Anrufer (Top-Anrufer, Telefonnummer maskiert, Name nur bei eingeschalteter Option).
• Wochentag × Stunde: Wärmebild der Anfragen; zeigt Stoßzeiten.
• Exportieren speichert Diagramm und Tabelle als CSV-Datei.
• Im Browser (Leiste über der Auswertung): Ist der Browser-Zugang eingerichtet, öffnet Im Browser öffnen die Seite /stats. Sonst richtet Im Browser bereitstellen … ihn ein (schaltet das Modul ein, erzeugt einen Zugangsschlüssel, öffnet die Karte Administration → Modul: Browser-Zugang); prüfen Sie danach die erlaubten IP-Adressen und klicken Sie auf Speichern und übernehmen.

Gespeichert werden je Anfrage: Zeit, IP-Adresse, Status, Treffer, Dauer, Quelle, Schnittstelle, angerufene Telefonnummer, Benutzer, maskierte Telefonnummer und ein nicht umkehrbares Kürzel (für Top-Anrufer). Die vollständige Telefonnummer speichert CallerHub nicht.

Anrufanalyse (Modul)

Das Modul Anrufanalyse wertet alle Anrufe aus den Verbindungsdaten (CDR) der Telefonanlage aus – auch Anrufe, bei denen CallerHub nicht gefragt wurde. Nach dem Einschalten unter Administration → Module erscheinen der Reiter Anrufanalyse und die Karte Administration → Modul: Anrufanalyse.

Um das Programmmenü kurz zu halten, wählen Sie Administration → Modul: Anrufanalyse → Nicht im Menü zeigen. Die Anrufanalyse ist dann nur im Browser unter /calls erreichbar.

Die Auswertungen folgen üblichen Berichten der Gesprächsdatenerfassung und des Contact-Centers (z. B. ProCall Analytics): Erreichbarkeit, Wartezeiten, Service-Level, Rückrufquote und Verteilung über Wochentage und Stunden.

Verbindungsdaten bereitstellen

Die Telefonanlage legt ihre Verbindungsdaten als CSV-Datei in den Ordner CallData im Programmordner (einen anderen Ordner stellen Sie unter Modul: Anrufanalyse ein). Ein Unterordner je Anlage (z. B. CallData\Head office) ordnet die Anrufe einer Schnittstelle zu. CallerHub liest den Ordner bei jedem Aufruf der Seite und mit Aktualisieren; die Dateien verändert CallerHub nicht.

• Asterisk / FreePBX: Kopieren Sie die Datei /var/log/asterisk/cdr-csv/Master.csv regelmäßig in den Ordner (z. B. per Freigabe oder geplanter Aufgabe). CallerHub erkennt den Aufbau automatisch.
• STARFACE: in der Weboberfläche Admin → Auswertung → Verbindungsdaten exportieren (je Benutzer oder Gruppe, Zeitraum wählbar); legen Sie die Datei output.csv in den Ordner. CallerHub erkennt den Aufbau (Spalten callid, starttime, linktime, incoming, answered, duration, login …) und fasst die Rufschritte eines Anrufs (z. B. Gruppe, dann Benutzer) zusammen. Wartezeit: Beginn bis Annahme; Nebenstelle: der Benutzer, der angenommen hat. Laut STARFACE-Wiki erfolgt der Export von Hand.
• 3CX und andere: Exportieren Sie die Anrufliste bzw. den Anrufbericht als CSV (Menüpfad je nach Version). CallerHub erkennt Spalten mit Namen wie Start, Direction, From, To, Extension, Answered/Status, Wait, Duration (Sekunden oder hh:mm:ss).
• FRITZ!Box: live über den Anrufmonitor, siehe FRITZ!Box.
• Ohne Spalte Direction unterscheidet CallerHub nach der Länge der Rufnummer: Nebenstellen haben höchstens so viele Ziffern wie unter Nebenstellen bis (Ziffern) eingestellt (Vorgabe 4).

Start;Direction;From;To;Extension;Answered;Wait;Duration
2026-10-16 09:12:05;incoming;+49711456789;200;201;yes;8;00:03:41
2026-10-16 09:15:40;incoming;+4930123456;200;;no;35;0

Live-Empfang (ohne Datei)

Viele Telefonanlagen melden jeden Anruf, sobald er endet. CallerHub schreibt die Anrufe dann selbst in den Ordner (ein Unterordner je Schnittstelle bzw. Empfänger, eine Datei je Monat, gleiche Spalten wie oben), sodass die Anrufanalyse keinen Export benötigt:

Empfänger richten Sie in der Karte Administration → Modul: Anrufanalyse unter Live-Empfang ein (bis zu 5): Empfänger hinzufügen … fragt zuerst nach der Telefonanlage; Port und Richtung sind vorausgefüllt. Wartet CallerHub, tragen Sie die IP-Adresse der Telefonanlage als zugelassenen Absender ein (Pflicht; andere Absender weist CallerHub ab). Datensatz prüfen liest eine eingefügte Beispielzeile und zeigt, wie CallerHub sie speichert – nützlich, bevor die Telefonanlage angeschlossen ist. Den Zustand jedes Empfängers (wartet, verbunden, Anzahl der Anrufe, Fehler) zeigt CallerHub unter der Liste und im Systemzustand.

Verbindungsdaten per API (3CX V20, Microsoft Teams, Webex Calling)

Cloud-Telefonanlagen speichern die Verbindungsdaten selbst. Mit einem Empfänger der Art CallerHub holt die Daten per API ab holt CallerHub neue Anrufe im eingestellten Abstand ab (Feld Abstand (min), Vorgabe 15 bzw. 30) und schreibt sie in die Anrufanalyse. CallerHub merkt sich den Zeitpunkt des letzten Abrufs, sodass nach einem Neustart nichts verloren geht oder doppelt zählt; der erste Abruf holt die letzten 24 Stunden. Datensatz prüfen im Empfänger-Dialog führt einen Probeabruf aus, ohne sich etwas zu merken.

Wählen Sie den Abstand nicht kürzer als nötig: Cloud-Dienste begrenzen die Zahl der Anfragen. Tokens von Integrationen laufen ab; einen fehlgeschlagenen Abruf zeigen die Karte, der Systemzustand und das Monitoring (call_data_receivers_error). CallerHub speichert den geheimen Schlüssel verschlüsselt.

Anrufe an /event melden

…/event?apikey=API-KEY&event=incoming&callid=4711&number=07111234567&called=0711999200
…/event?apikey=API-KEY&event=answered&callid=4711&extension=201
…/event?apikey=API-KEY&event=ended&callid=4711&duration=95

Ereignisse mit derselben callid (auch callId, call_id) bilden einen Anruf: Wartezeit vom Beginn bis zur Annahme, Dauer aus duration oder aus der Zeit bis zum Ende. Ohne Anruf-ID verknüpfen Nummer und Nebenstelle die Ereignisse. Ein einzelnes Ereignis ended oder missed mit duration und answered=1|0 genügt ebenfalls. Mit POST nimmt CallerHub auch Formulardaten und JSON-Objekte an.

Verbindungsdaten per HTTP (/cdr)

POST /cdr?apikey=API-KEY&format=3cx (oder mitel, openscape, callerhub) nimmt eine oder mehrere Zeilen an; innovaphone-XML erkennt CallerHub automatisch (auch als Parameter msg). CallerHub ordnet die Anrufe der Schnittstelle des API-Keys zu.

Die Verbindungsdaten enthalten vollständige Telefonnummern. Sie bleiben im angegebenen Ordner; CallerHub speichert keine Kopie. Halten Sie die Aufbewahrungsdauer im Verzeichnis von Verarbeitungstätigkeiten fest.

Testdaten

Zum Ausprobieren zeigen beide Auswertungen erfundene Daten, solange noch keine echten Daten vorliegen:

• Administration → Modul: Statistik → Testdaten anzeigen, solange keine echten Anfragen vorliegen
• Administration → Modul: Anrufanalyse → Testdaten anzeigen, solange keine Verbindungsdaten vorliegen

CallerHub kennzeichnet Testdaten („Testdaten“ in Orange) und speichert sie nicht. Sobald die erste echte Anfrage bzw. die erste Datei mit Verbindungsdaten vorliegt, zeigt CallerHub nur noch echte Daten.

Browser-Zugang

Modul „Browser-Zugang“, Karte Administration → Modul: Browser-Zugang. Alle Funktionen nutzen einen eigenen Zugangsschlüssel (getrennt vom API-Key) und optional eigene IP-Freigaben.

Statistik im Browser (/stats)

Gleiche Auswertung wie im Programm, auch auf dem Smartphone. Adresse: http://callerhub:8080/stats; Zugangsschlüssel eingeben, „Auf diesem Gerät merken“ ist optional. Die Seite lädt keine externen Inhalte.

Anrufanalyse im Browser (/calls)

Mit den Modulen Browser-Zugang und Anrufanalyse zeigt http://callerhub:8080/calls die Anrufanalyse mit demselben Zugangsschlüssel: Zeitraum, Richtung, Auswertung, Kennzahlen, Verlauf und Tabelle. Auch dort erscheinen Testdaten, solange keine Verbindungsdaten vorliegen. Die Statistikseite verweist auf die Anrufanalyse und umgekehrt.

CRM-Link (/open)

Für CTI-Popups: http://callerhub:8080/open?number=07114567890&key=ACCESS-KEY leitet zum Datensatz weiter (Link je Quelle, siehe Datenquellen).

Das Monitoring (/metrics, /status, /check, /prtg) ist seit Version 3.0 ein eigenes Modul: siehe Monitoring. CallerHub übernimmt Einstellungen früherer Versionen automatisch.

Über HTTP wird der Schlüssel unverschlüsselt übertragen. Bieten Sie den Browser-Zugang nur im internen Netz oder über HTTPS an.

Monitoring (Nagios, Icinga, Checkmk, PRTG, Zabbix, Prometheus, Grafana)

Modul Monitoring (Vollversion), Karte Administration → Modul: Monitoring. Überwachungssysteme fragen CallerHub über HTTP(S) am Port der Schnittstelle ab. Sie wählen, welche Kennzahlen CallerHub liefert; jede Adresse benötigt den Zugangsschlüssel (Parameter key, Header X-Monitoring-Key oder Authorization: Bearer …) und ist optional nur von den erlaubten IP-Adressen aus erreichbar.

curl "http://callerhub:8080/check?key=KEY"
CALLERHUB OK - 2/2 data sources ready, 1146 requests | sources_ready=2;;;0;2 answered=1146c unknown=212c rejected=0c errors=0c avg_ms=4ms;500;2000

Wählbare Kennzahlen

Über HTTP wird der Schlüssel unverschlüsselt übertragen. Nutzen Sie HTTPS oder das interne Netz und tragen Sie die Adresse des Überwachungsservers unter Erlaubte IP-Adressen ein. Auch die Regel der Windows-Firewall muss diese Adresse zulassen; der Systemzustand zeigt eine Abweichung an und bietet Regel anpassen an (siehe Prüfungen des Systemzustands).

Benachrichtigungen

Modul „Benachrichtigungen“, Karte Administration → Modul: Benachrichtigungen. Meldet Störung und Behebung – ohne Telefonnummern. Die Karte hat drei Abschnitte; Störungsmeldungen und geplante Berichte arbeiten unabhängig voneinander.

Kanal je Ereignis: Für jedes der beiden Ereignisse (Datenquellen-Fehler, keine Anfragen) wählen die Kontrollkästchen E-Mail und Webhook neben dem Feld, wie gemeldet wird – über einen Kanal, über beide oder gar nicht. Ein Kontrollkästchen steht nur zur Verfügung, wenn der Kanal selbst eingeschaltet und vollständig ist. Das Modul zeigt nur dann „aktiv“, wenn mindestens ein Kanal vollständig ist und die Schnittstelle läuft.

Die Netzwerk-Discovery findet auch Mailserver (Ports 587, 465, 25); Verwenden trägt Server, Port und Verschlüsselung hier ein. Beim Speichern werden alle fehlenden Felder der E-Mail-Einstellungen gemeinsam markiert. Testnachricht senden prüft die Werte im Formular, ohne zu speichern. Welche Webhook-Adresse Teams bzw. Slack erwartet (z. B. Workflows bzw. Incoming Webhooks), hängt vom jeweiligen Dienst ab; lesen Sie dazu dessen Dokumentation.

Geplante Berichte

Karte Administration → Modul: Benachrichtigungen, Liste Geplante Berichte (Vollversion). Jede Zeile ist ein Bericht; Bericht hinzufügen … legt einen an, der Stift in der Zeile bearbeitet ihn, der Papierkorb entfernt ihn. Bis zu 20 Berichte, jeweils mit:

Per E-Mail kommt der Bericht als PDF mit den Kennzahlen im Text; Teams und Slack erhalten die Kennzahlen als Nachricht; JSON erhält die Kennzahlen und das PDF als Base64 (pdfBase64). Jedes PDF hat oben rechts das Logo, Seitenzahlen und die Fußzeile „(c) Simon Bernhard - CallerHub.de“ (mit Rebranding Ihre eigene). Jetzt senden (Vorperiode) im Berichtsdialog sendet den Bericht sofort, um die Einstellungen zu prüfen. Berichte werden gesendet, während die Schnittstelle läuft; gesendete Zeiträume merkt sich CallerHub in Statistics\report-last.txt, sodass nach einem Neustart nichts doppelt gesendet wird. Der Ausdruck des Datenflusses hat dasselbe Logo und dieselbe Fußzeile.

Für Sprachen mit nicht lateinischer Schrift (z. B. Russisch, Chinesisch, Arabisch, Hindi) wird das PDF auf Englisch erstellt.

Anrufereignisse

Modul Anrufereignisse weitergeben (Vollversion), Karte Administration → Modul: Anrufereignisse weitergeben. CallerHub gibt Anrufe an andere Systeme weiter – an ein CRM, das Anrufe protokolliert (z. B. Infor CRM), an ein Ticketsystem, eine Zeiterfassung oder ein eigenes Skript. Jede Aktion legt fest, welche Ereignisse sie verarbeitet und wohin sie gehen; bis zu 10 Aktionen.

Ereignisse

Die Buchstaben I, O, R und C sind dieselben wie bei ProCall, sodass vorhandene CRM-Befehle weiter funktionieren.

Ereignisse an /event melden

Die Telefonanlage (oder ein beliebiges anderes System) meldet ein Ereignis mit dem API-Schlüssel einer Schnittstelle; es gelten die erlaubten IP-Adressen dieser Schnittstelle:

http://192.168.10.5:8080/event?apikey=API-KEY&event=outgoing&number=07111234567&extension=201

Parameter: event (oder type, direction: auch die Buchstaben I, O, R, C, A, E), number (Gegenstelle), called (eigene Nummer), extension, user, name (optional). CallerHub akzeptiert GET und POST mit Formulardaten (application/x-www-form-urlencoded); die Antwort lautet 200 OK. Ereignisse zählen in der Statistik nicht als Abfragen.

Aktionen

Aktion hinzufügen … öffnet die Aktion: Wählen Sie zuerst den Typ, dann optional eine typische Vorlage dieses Typs (z. B. Infor CRM); Bearbeiten und testen … öffnet die Aktion mit allen Feldern und einer Schaltfläche Test senden, die sie sofort mit Beispielwerten ausführt und genau anzeigt, was gesendet wurde.

Platzhalter: {event}, {direction}, {number}, {numberE164} (+497111234567), {numberNational} (07111234567), {numberDigits}, {extension} (Nebenstelle, sonst eigene Nummer), {called}, {user}, {name}, {id}, {link} (gefundener Datensatz; CallerHub sucht die Nummer nur nach, wenn eine Aktion diese verwendet), {interface}, {time}, {date}, {clock}. CallerHub bereinigt die Werte vor dem Einsetzen: Nummern behalten nur Ziffern und +, Texte verlieren Anführungszeichen, Trennzeichen und Steuerzeichen; in Adressen werden Werte URL-kodiert, in JSON maskiert.

Beispiel: Infor CRM

Vorlage Infor CRM – direkt an den Server: Server crm-server (durch Namen oder Adresse des CRM-Servers ersetzen), Port 4921, Format Benutzer|Kennwort|Text, Ereignisse eingehend, ausgehend, verpasst und umgeleitet, Text:

CTIPG0C1RegisterCall "application=CTIPTEST" "callNumber={numberE164}" "targetNumber={extension}" "direction={direction}"

Testen Sie mit der Anwendung CTIPTEST und ändern Sie sie danach in CTIPROD. Das CRM ordnet den Anruf über die Nebenstelle (targetNumber) dem Benutzer zu. Die Vorlage Infor CRM – remoteCmd.exe aufrufen ruft stattdessen das vorhandene Programm mit demselben Befehl auf.

Betrieb

• Aktionen laufen im Hintergrund; die Antwort an die Telefonanlage wartet nie auf sie. Ist ein Ziel nicht erreichbar, versucht CallerHub es nach 2 und nach 10 Sekunden erneut; die Karte und der Systemzustand zeigen gesendete und fehlgeschlagene Ereignisse sowie den letzten Fehler.
• Das Textprotokoll von remoteCmd.exe ist unverschlüsselt und hat keine Antwort: Verwenden Sie es nur im internen Netz und geben Sie den Port auf dem CRM-Server nur für den CallerHub-Rechner frei.
• Die erweiterte Aufzeichnung (Fehleranalyse) enthält jedes gesendete Ereignis.

Module

Der Kern – Telefonnummer annehmen, Datenquellen abfragen, Namen liefern – ist immer aktiv. Jede Modulkarte in der Administration zeigt ihren Zustand in der Titelzeile (z. B. „Läuft · 2 aktive Aktionen“, „Unvollständig“, „Fehler“). Alles Weitere lässt sich unter Administration → Module ein- und ausschalten; Änderungen wirken nach dem Speichern. Die Einstellungen eines eingeschalteten Moduls stehen in der Karte Modul: … darunter. Ausgeschaltete Module erscheinen nicht in der Oberfläche, ihre Adressen antworten mit 404.

Rebranding für Wiederverkäufer

Modul Rebranding, Karte Administration → Modul: Rebranding. Wiederverkäufer liefern CallerHub unter eigenem Namen aus. Das Modul erfordert eine Sonderlizenz mit dem Merkmal modul:rebranding; es ist nicht Teil der Vollversion oder von „alle Module“. Tragen Sie sie als zweite Lizenz unter Administration → Lizenz ein (siehe Grundversion und Vollversion, Lizenzschlüssel).

Bewusst unverändert bleiben: Lizenztexte und Lizenzschlüssel (sie bleiben die von CallerHub), die Hilfe, der Name des Windows-Dienstes CallerHub und die Programmdateien. „Über“ zeigt Ihre Angaben und „Basiert auf CallerHub (c) 2026 - Simon Bernhard“. Änderungen wirken nach Speichern und übernehmen; der Fenstertitel folgt sofort.

Plugins

Plugins erweitern die Antwort an die Telefonanlage, hängen z. B. „außerhalb der Geschäftszeit“ an den Namen an oder zeigen bei unbekannten Anrufern das Land an. Sie erhalten bewusst wenige Rechte, können aber, was Einstellungen nicht können: beliebige Logik je Anruf ausführen.

Sicherheit

• Plugins laufen in einem eigenen Prozess. Unter Windows startet CallerHub ihn in einem AppContainer (kein Netzwerk, keine Registrierung, Dateien nur im Programmordner lesbar) und in einem Windows-Job (nur ein Prozess, höchstens 512 MB Arbeitsspeicher, keine Fenster, endet mit CallerHub).
• Steht der AppContainer nicht zur Verfügung, läuft der Plugin-Prozess nur im Windows-Job; die Plugin-Karte und das Protokoll melden „Abschottung eingeschränkt“.
• Alle Plugins zusammen benötigen höchstens 300 ms je Anruf; dauert es länger, beendet CallerHub den Plugin-Prozess, beantwortet den Anruf ohne Plugin-Ergebnis und lässt die Plugins angehalten, bis sie mit „Neu laden“ oder beim nächsten Start wieder geladen werden.
• Plugins sehen nur: Telefonnummer (E.164 und national), Land, angerufene Telefonnummer, gefundenen Namen, Quelle, VIP, Ortszeit. Keine Passwörter, keine Einstellungen anderer Bereiche.
• Das Modul „Plugins“ ist standardmäßig aus; jedes Plugin muss zusätzlich einzeln eingeschaltet werden.

Installieren Sie Plugins nur aus vertrauenswürdiger Quelle und schützen Sie den Ordner Plugins vor Schreibzugriff. Unter Linux/Mono (nur für Tests) gibt es keine Abschottung.

Beispiel-Plugins (Plugins\CallerHub.Sample.dll)

Einstellungen der Plugins (Feld unter der Liste):

[beispiel.geschaeftszeiten]
zeiten=08:00-17:00
tage=1-5
hinweis= (after hours)

Eigenes Plugin schreiben

' MeinPlugin.vb – class library for netstandard2.0 with a reference to Plugins\CallerHub.Plugins.dll, compile with the .NET SDK:
'   dotnet new classlib -lang VB -f netstandard2.0 -n MeinPlugin   (add the reference, replace the file)
'   dotnet build -c Release
Imports System.Collections.Generic
Imports CallerHub.Plugins

Public NotInheritable Class ZentralePlugin
    Implements ICallerHubPlugin

    Private suffix As String = " (Zentrale)"

    Public ReadOnly Property id As String Implements ICallerHubPlugin.id
        Get
            Return "firma.zentrale"
        End Get
    End Property
    Public ReadOnly Property name As String Implements ICallerHubPlugin.name
        Get
            Return "Mark main office"
        End Get
    End Property
    Public ReadOnly Property description As String Implements ICallerHubPlugin.description
        Get
            Return "Appends a note to calls to the main office (called number 200)."
        End Get
    End Property
    Public ReadOnly Property settingsExample As String Implements ICallerHubPlugin.settingsExample
        Get
            Return "hinweis= (Zentrale)"
        End Get
    End Property

    Public Sub configure(settings As IDictionary(Of String, String)) Implements ICallerHubPlugin.configure
        Dim value As String = Nothing
        If settings.TryGetValue("hinweis", value) Then suffix = value
    End Sub

    Public Function process(callInfo As PluginCall) As PluginResult Implements ICallerHubPlugin.process
        ' Nothing = change nothing
        If callInfo.calledNumber <> "200" OrElse String.IsNullOrEmpty(callInfo.displayName) Then Return Nothing
        Return New PluginResult With {.displayName = callInfo.displayName & suffix, .note = "Zentrale"}
    End Function
End Class

Kopieren Sie die DLL nach Plugins, klicken Sie unter Administration → Modul: Plugins auf „Neu laden“, schalten Sie das Plugin ein und speichern Sie. Felder von PluginCall: phoneNumberE164, phoneNumberNational, countryIso, countryCode, calledNumber, displayName, sourceLabel, found, isVip, localTime. Der vollständige Quelltext der Beispiele (C#, Projekt CallerHub.Sample.csproj) liegt im Quellcode unter plugins\beispiele.

KI-Assistent (Chat)

CallerHub nutzt den Claude-Chat im Browser – keine API, kein Schlüssel, keine automatische Übermittlung. Ablauf: CallerHub stellt eine Frage mit Kontext zusammen, macht persönliche Angaben unkenntlich, zeigt sie zur Prüfung und Bearbeitung an, kopiert sie in die Zwischenablage und öffnet https://claude.ai/new. Fügen Sie sie dort ein (Strg+V) und senden Sie sie ab.

Anonymisiert werden: Telefonnummern (letzte Ziffern durch **** ersetzt), E-Mail-Adressen (<E-Mail>), IPv4-Adressen (192.168.x.x), Passwörter und Schlüssel. Prüfen Sie den Text vor dem Absenden trotzdem.

KI-Antworten können falsch sein. Prüfen Sie SQL und Einstellungen vor dem Einsatz mit Verbindung testen und einer Testabfrage.

Netzwerk-Discovery

Findet Datenbanken, Verzeichnisse und Telefonanlagen im Netz und prüft die eingetragenen Dienste – auch externe wie Cloud-CRM, Microsoft 365 oder den SMTP-Server. Damit die Suche in klaren Grenzen bleibt, gilt:

• Das Modul Netzwerk-Discovery ist standardmäßig aus; ist es eingeschaltet, erscheint im Systemzustand ein gelber Hinweis.
• Eine Suche läuft nur nach Klick auf Suche starten und Bestätigung; jede Suche wird protokolliert.
• Nur Verbindungsaufbau (TCP) bzw. Standardanfragen (SQL Server Browser UDP 1434, SSDP UDP 1900) – keine Anmeldung, keine Passwörter.
• Höchstens 1.024 Adressen je Suche, Netzbereiche /22 bis /32, Zeitlimit 400 ms je Versuch, „Abbrechen“ jederzeit.

Ergebnisse erscheinen bereits während der Suche in der Liste. Verwenden übernimmt das ausgewählte Ergebnis: Eine Datenquelle öffnet den Dialog Neue Datenquelle mit vorausgewähltem passendem Typ und Namen, danach werden Server und Port eingetragen; ein Mailserver geht an die Benachrichtigungen; Asterisk AMI und Mitel SMDR legen einen Empfänger der Anrufanalyse an; eine FRITZ!Box wird zum Anrufmonitor. Zugangsdaten ergänzen Sie selbst.

Suchen Sie nur in eigenen Netzen oder mit Erlaubnis. Portsuchen können von Sicherheitssystemen (IDS/IPS) gemeldet werden; informieren Sie vorher die IT-Sicherheit.

Firewall-Beispiele

Grundregel: eingehend nur der Port von CallerHub (Beispiel 8443, HTTPS) und nur von den IP-Adressen der Telefonanlage; ausgehend nur zu den Datenquellen. Alle Beispiele verwenden Dokumentationsadressen: Telefonanlage/Cloud 203.0.113.10, öffentliche Adresse der Firewall 198.51.100.10, CallerHub-Server 192.168.10.5, Datenbank 192.168.10.30.

1 · OPNsense / pfSense

1. Firewall → Aliases: STARFACE_Cloud (Host: 203.0.113.10), CALLERHUB (Host: 192.168.10.5).
2. Firewall → NAT → Port Forward (neuere OPNsense-Versionen ggf. „Destination NAT“), „+“: Interface WAN, Protocol TCP, Source STARFACE_Cloud (über „Advanced“), Destination WAN address, Port 8443, Redirect target CALLERHUB / 8443, Description CallerHub, Filter rule association „Add associated filter rule“.
3. Speichern, Apply changes. Prüfen Sie unter Firewall → Log Files → Live View (Filter Port 8443) mit einem Testanruf.

2 · Sophos Firewall (SFOS)

1. Hosts and services → IP host: STARFACE_Cloud = 203.0.113.10, CallerHub = 192.168.10.5; Services: CallerHub-8443 = TCP 8443.
2. Rules and policies → NAT rules → Add NAT rule (bzw. der Assistent „Server access assistant (DNAT)“): Original source STARFACE_Cloud, Original destination die WAN-Adresse, Original service CallerHub-8443, Translated destination CallerHub.
3. Rules and policies → Firewall rules: Regel WAN → LAN, Quelle STARFACE_Cloud, Ziel CallerHub, Dienst CallerHub-8443, Aktion Accept, Protokollierung an.

3 · Fortinet FortiGate (FortiOS, CLI)

config firewall address
    edit "STARFACE_Cloud"
        set subnet 203.0.113.10 255.255.255.255
    next
end
config firewall vip
    edit "CallerHub-VIP"
        set extintf "wan1"
        set extip 198.51.100.10
        set mappedip "192.168.10.5"
        set portforward enable
        set extport 8443
        set mappedport 8443
    next
end
config firewall service custom
    edit "CallerHub-8443"
        set tcp-portrange 8443
    next
end
config firewall policy
    edit 0
        set name "STARFACE-zu-CallerHub"
        set srcintf "wan1"
        set dstintf "internal"
        set srcaddr "STARFACE_Cloud"
        set dstaddr "CallerHub-VIP"
        set service "CallerHub-8443"
        set schedule "always"
        set action accept
        set logtraffic all
    next
end

In der Weboberfläche entspricht das Policy & Objects → Virtual IPs und Firewall Policy. Passen Sie die Schnittstellennamen (wan1, internal) an Ihr Gerät an.

4 · AWS (CallerHub auf EC2)

# inbound: only the phone system on port 8443
aws ec2 authorize-security-group-ingress --group-id sg-0aaa1111bbbb2222c \
    --protocol tcp --port 8443 --cidr 203.0.113.10/32
# database (e.g. RDS SQL Server) only from the CallerHub security group
aws ec2 authorize-security-group-ingress --group-id sg-0ddd3333eeee4444f \
    --protocol tcp --port 1433 --source-group sg-0aaa1111bbbb2222c

Konsole: EC2 → Security Groups → Inbound rules → Edit inbound rules. Beschränken Sie bei Bedarf die ausgehenden Regeln auf die Ports der Datenquellen.

5 · Microsoft Azure (Network Security Group)

az network nsg rule create --resource-group rg-telefonie --nsg-name nsg-callerhub \
    --name Allow-Telefonanlage-8443 --priority 310 --direction Inbound --access Allow \
    --protocol Tcp --source-address-prefixes 203.0.113.10/32 --source-port-ranges '*' \
    --destination-address-prefixes '*' --destination-port-ranges 8443

Portal: Netzwerksicherheitsgruppe → Eingangssicherheitsregeln → Hinzufügen. Geben Sie zusätzlich die Windows-Firewall auf der VM frei (siehe Windows).

Menüpfade und Befehle beziehen sich auf aktuelle Versionen der Hersteller und können abweichen. Gleichen Sie sie mit der Herstellerdokumentation ab und prüfen Sie die Änderung mit einem Testanruf. Wird statt NAT ein Reverse Proxy verwendet, tragen Sie dessen IP unter Administration → Server → Vertrauenswürdige Reverse Proxys ein (erweiterter Modus).

Windows-Einstellungen (neue und alte Versionen)

CallerHub bietet alle Schritte im Systemzustand als Schaltfläche an (Rückfrage nach Administratorrechten). Für Skripte und Gruppenrichtlinien stehen hier die Befehle; Port 8443, Benutzer FIRMA\svc-callerhub und die Adressen sind Beispiele.

Windows Server 2016/2019/2022/2025, Windows 10/11 (PowerShell als Administrator)

# Firewall-Regel (nur von der Telefonanlage)
New-NetFirewallRule -DisplayName "CallerHub" -Direction Inbound -Protocol TCP -LocalPort 8443 `
    -RemoteAddress 203.0.113.10 -Action Allow -Profile Domain,Private
# URL-Reservierung für den Benutzer bzw. Dienst
netsh http add urlacl url=https://+:8443/ user="FIRMA\svc-callerhub"
# Zertifikat binden (Fingerabdruck aus der Zertifikatsverwaltung, Computerkonto)
netsh http add sslcert ipport=0.0.0.0:8443 certhash=<Fingerabdruck> appid={6b1e1c0a-4f6e-4d3a-9c55-2f7a8e0b6a11}
# Windows-Dienst (alternativ: Administration → Betrieb → Installieren)
New-Service -Name CallerHub -DisplayName CallerHub -BinaryPathName '"C:\CallerHub\CallerHub.exe"' -StartupType Automatic
Start-Service CallerHub
# Prüfen
Get-NetFirewallRule -DisplayName CallerHub | Get-NetFirewallAddressFilter
Get-Service CallerHub

Ältere Systeme: Windows Server 2012 / 2012 R2 (cmd als Administrator)

netsh advfirewall firewall add rule name="CallerHub" dir=in action=allow protocol=TCP localport=8443 remoteip=203.0.113.10
netsh http add urlacl url=https://+:8443/ user="FIRMA\svc-callerhub"
netsh http add sslcert ipport=0.0.0.0:8443 certhash=<Fingerabdruck> appid={6b1e1c0a-4f6e-4d3a-9c55-2f7a8e0b6a11}
sc.exe create CallerHub binPath= "C:\CallerHub\CallerHub.exe" start= auto DisplayName= "CallerHub"
sc.exe start CallerHub

Windows Server 2012 und 2012 R2 erhalten Sicherheitsupdates nur noch über kostenpflichtige Erweiterungen (den aktuellen Stand bitte bei Microsoft prüfen). Windows 7, 8.1 und Server 2008 R2 werden von .NET 10 und damit von CallerHub 3.0 nicht mehr unterstützt. Verwenden Sie für den Dauerbetrieb ein aktuelles System.

Dienstkonto und Rechte

• Empfohlen: virtuelles Dienstkonto NT SERVICE\CallerHub (Auswahl unter Administration → Sicherheit; gilt beim Einrichten des Dienstes). Beim Einrichten des Dienstes gibt CallerHub diesem Konto Schreibrecht auf den Programmordner (und auf eigene Ordner für Protokoll, Statistik und Verbindungsdaten) sowie die Adresse der Schnittstelle in http.sys. Nach einer Änderung von Port oder HTTPS den Dienst entfernen und neu einrichten.
• Alternativ ein eigenes Konto (z. B. FIRMA\svc-callerhub, nötig bei Windows-Anmeldung an SQL Server bzw. LDAP mit einem Benutzerkonto statt des Computerkontos); LocalSystem nur, wenn nichts anderes möglich ist (der Systemzustand warnt).
• icacls "C:\CallerHub" /grant "FIRMA\svc-callerhub:(OI)(CI)M" gibt Änderungsrecht auf den Ordner.
• Dienst und Oberfläche nicht gleichzeitig auf demselben Port betreiben (der Systemzustand meldet das).

Linux

CallerHub ist ein Windows-Programm (.NET 10, Windows Forms) und läuft nicht unter Linux. Für die automatischen Tests lässt sich derselbe Quellcode mit Mono übersetzen; dieser Betrieb ist nicht für den Produktivbetrieb gedacht (kein Windows-Dienst, keine DPAPI-Verschlüsselung, keine URL-Reservierung, kein Ereignisprotokoll, keine Plugin-Abschottung).

Häufiger ist Linux auf der Gegenseite: Datenbank, Telefonanlage (Asterisk/FreePBX) oder Verzeichnis. Beispiele, mit denen CallerHub (192.168.10.5) dort zugreifen darf:

# ufw (Ubuntu/Debian): PostgreSQL nur für CallerHub
sudo ufw allow from 192.168.10.5 to any port 5432 proto tcp
# firewalld (RHEL, Rocky, Alma, SUSE): MariaDB nur für CallerHub
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.10.5" port port="3306" protocol="tcp" accept'
sudo firewall-cmd --reload
# nftables (Tabelle inet filter, Kette input vorhanden)
sudo nft add rule inet filter input ip saddr 192.168.10.5 tcp dport 5432 accept
# iptables (ältere Systeme)
sudo iptables -A INPUT -p tcp -s 192.168.10.5 --dport 5432 -j ACCEPT

• PostgreSQL: listen_addresses in postgresql.conf passend setzen, in pg_hba.conf z. B. host odoo odoo_ro 192.168.10.5/32 scram-sha-256, danach neu laden.
• MariaDB/MySQL: bind-address in der Serverkonfiguration prüfen; Benutzer nur mit Leserecht: CREATE USER 'crm_leser'@'192.168.10.5' IDENTIFIED BY '…'; GRANT SELECT ON suitecrm.* TO 'crm_leser'@'192.168.10.5';
• Asterisk: Ausgehend muss die Telefonanlage CallerHub auf Port 8080/8443 erreichen; für HTTPS muss Asterisk dem Zertifikat vertrauen.

Sicherheit und Standards

Die Karte Administration → Sicherheit fasst alle Entscheidungen zusammen, die der Betreiber treffen muss; der Systemzustand zeigt offene Empfehlungen.

Weitere Schutzmaßnahmen im Programm

• Vergleich von Schlüsseln ohne Zeitunterschiede (SHA-256); Antworten mit Sicherheits-Headern (CSP, X-Frame-Options, nosniff, no-store); die JSON-Ausgabe maskiert < > &.
• Höchstens 8 gleichzeitige Direktabfragen je Datenquelle, Schutzschalter nach 5 Fehlern in Folge (30 Sekunden), Schutz vor Kontosperre bei Datenbank, LDAP, Exchange und REST.
• Folgeseiten einer REST-API nur vom selben Server und ohne Wechsel auf http; Antworten höchstens 100 MB; Retry-After wird beachtet.
• Plugins in einem eigenen Prozess mit minimalen Rechten; Protokoll ohne Schlüssel und Passwörter, Telefonnummern maskiert.
• Der Systemzustand meldet: Dienstkonto mit vollen Rechten, veraltete TLS-Versionen (SSL 3.0, TLS 1.0/1.1) bei HTTPS, fehlende Signatur der Programmdatei, nicht lesbare Schlüssel, Netzlaufwerke, die der Dienst nicht sieht.

Lieferkette

• Fremdpakete mit festen Versionen und Prüfsummen (packages.lock.json); der Build prüft sie auf bekannte Schwachstellen.
• Jede Lieferung enthält eine Stückliste der Fremdpakete (SBOM.cdx.json, CycloneDX 1.5) und SHA-256-Prüfsummen (SHA256SUMS.txt). Prüfen: tools\lieferung\lieferung.cmd pruefen <Ordner> <Ordner>\SHA256SUMS.txt.
• Digitale Signatur (Authenticode, SHA-256): Der Build signiert CallerHub.exe und die Beispiel-Plugins mit dem Code-Signing-Zertifikat von CallerHub (ausgestellt von der eigenen Zertifizierungsstelle CallerHub Root CA). CallerHub selbst vertraut dieser Signatur ohne weitere Schritte (z. B. für Nur Plugins mit gültiger digitaler Signatur laden); Über CallerHub und der Systemzustand zeigen die Signatur an. Für Windows selbst (Anzeige des Herausgebers, Richtlinien) führen Sie zertifikat-vertrauen.cmd im Programmordner als Administrator aus oder verteilen CallerHub-Root-CA.cer (Vertrauenswürdige Stammzertifizierungsstellen) und CallerHub-Codesignatur.cer (Vertrauenswürdige Herausgeber) per Gruppenrichtlinie. SmartScreen kann bei heruntergeladenen Dateien weiterhin warnen, bis ein Zertifikat einer öffentlichen Zertifizierungsstelle verwendet wird. Alternativ mit einem eigenen Zertifikat signieren: tools\signieren\signieren.cmd.
• Schwachstellen bitte vertraulich melden (siehe SECURITY.md).

Eigene Sicherheitstests

Bezug zu Standards

CallerHub ist nicht zertifiziert. Die folgenden Standards dienen als Maßstab; der Abgleich und die offenen Punkte stehen in doc/sicherheitstests.md.

Technischer Hintergrund für Administratoren

Aufbau

• Eine Programmdatei (CallerHub.exe, .NET 10, eigenständig) für das Programmfenster, den Infobereich und den Windows-Dienst. Keine Installation, keine eigene Datenbank, keine Registrierungseinträge außer dem optionalen Dienst, der Ereignisquelle und der URL-Reservierung.
• Die HTTP-Schnittstelle beruht auf dem Windows-HTTP-Server (http.sys); Anfragen werden parallel bearbeitet. Alle Schnittstellen teilen sich einen Port; der API-Key in der Anfrage entscheidet, welche Schnittstelle (und welche Datenquellen und erlaubten IP-Adressen) gilt.
• Telefonnummernlisten: Quellen vom Typ Liste (Datenbank, CSV, LDAP/AD, Microsoft 365, REST) werden beim Start vollständig in den Arbeitsspeicher geladen und im Hintergrund aktualisiert (Standard alle 15 Minuten, je Quelle). Eine Abfrage ist ein Speicherzugriff und dauert deutlich unter einer Millisekunde; eine langsame oder nicht erreichbare Datenbank verzögert die Antwort nicht, die zuletzt geladene Liste bleibt in Gebrauch.
• Direktabfragen (SQL mit einem Parameter) fragen die Datenbank bei jedem Anruf: höchstens 8 gleichzeitig je Quelle, Schutzschalter nach 5 Fehlern in Folge (30 Sekunden).
• Cache: Antworten von Direktabfragen werden im Arbeitsspeicher gehalten (Beispiel: Treffer 300 s, unbekannte Nummern 60 s; siehe Cache).
• Die Quellen werden in der Reihenfolge der Karten gefragt; der erste Treffer gilt. Regeln, Sperrliste und VIP-Liste greifen danach.

Globale Einstellungen und Einstellungen je Schnittstelle

Die von CallerHub angelegte Windows-Firewall-Regel fasst die erlaubten IP-Adressen aller Schnittstellen zusammen, weil alle Schnittstellen denselben Port verwenden.

Dateien im Programmordner

Betrieb und Überwachung

• /health (ohne Schlüssel) für Lastverteiler und Überwachung; /status und /metrics (Prometheus) mit dem Modul Browser-Zugang.
• Fehler wahlweise im Windows-Anwendungsprotokoll (Quelle CallerHub); Benachrichtigungen per E-Mail oder Webhook.
• Einstellungen lassen sich bei laufender Schnittstelle ändern: Speichern und übernehmen übernimmt sie ohne Neustart; der Dienst liest sie bei seinem nächsten Start.
• Update: den Inhalt des Programmordners ersetzen und die Einstellungsdatei, Logs, Statistics und CallData behalten (siehe Installation).

Protokollierung und Diagnose

• Protokollstufen Info, Zugriff, Warnung, Fehler, Debug; Telefonnummern maskiert, sofern vollständige Nummern nicht eingeschaltet sind; Schlüssel, Passwörter, Authorization und Cookie immer maskiert.
• Die Debug-Protokollierung und die erweiterte Aufzeichnung schalten sich selbst ab; die erweiterte Aufzeichnung ist auf 10 MB begrenzt.
• Das Diagnosepaket wird vor der Anzeige anonymisiert (siehe Diagnosepaket).

Dienst, Sicherung, Diagnose

Alles für den Dauerbetrieb steht in der Karte Administration → Betrieb, in fünf Abschnitten mit kurzer Erklärung und den jeweils passenden Schaltflächen.

Windows-Dienst

• Der Abschnitt zeigt den Zustand und nur die passenden Schaltflächen: Als Dienst installieren, Dienst starten, Dienst anhalten, Dienst entfernen (Dienstname CallerHub, Start automatisch, Neustart nach Fehler nach 1, 1 und 5 Minuten). Der Dienst verwendet dieselben Einstellungen wie die Oberfläche.
• Solange der Dienst läuft, die Schnittstelle in der Oberfläche gestoppt lassen; die Oberfläche dient dann nur zum Einstellen und Auswerten. Nach dem Speichern den Dienst neu starten.
• Ohne Dienst: Mit Windows-Anmeldung starten (minimiert) startet die Oberfläche im Infobereich.

Läuft CallerHub als Dienst? Jede dieser Stellen zeigt es:

• Administration → Betrieb → Windows-Dienst zeigt den Zustand (z. B. „Dienst 'CallerHub' ist gestartet.“) und das Konto; der Systemzustand warnt mit „Dienst und Programm laufen gleichzeitig“, wenn beide den Port verwenden.
• Windows: services.msc, Eintrag CallerHub; oder in einer Eingabeaufforderung:

sc.exe query CallerHub
tasklist /fi "imagename eq CallerHub.exe" /v

Ein Prozess CallerHub.exe mit dem Sitzungsnamen Services ist der Dienst; einer in Ihrer Sitzung ist das Programmfenster oder das Symbol im Infobereich.

Beenden: Dienst anhalten in der Karte (Administratorrechte) oder als Administrator:

sc.exe stop CallerHub
rem dauerhaft: nicht mehr automatisch starten
sc.exe config CallerHub start= disabled

Dienst entfernen löscht die Registrierung des Dienstes; Programmordner und Einstellungen bleiben erhalten.

HTTPS-Assistent

☰ → Schnittstelle → HTTPS einrichten …: Zertifikat mit privatem Schlüssel aus dem Zertifikatspeicher „Eigene Zertifikate“ des Computers (certlm.msc) wählen, Port (z. B. 8443) und Windows-Benutzer (z. B. FIRMA\svc-callerhub) angeben, auf Einrichten klicken. Der Assistent bindet das Zertifikat und setzt die URL-Reservierung; „Befehle kopieren“ liefert dieselben netsh-Befehle für die manuelle Ausführung. Der Name im Zertifikat (z. B. lookup.firma.de) muss zur Adresse passen, die die Telefonanlage aufruft.

• Noch kein Zertifikat? Der Assistent weist darauf hin und bietet Zertifikat erzeugen … an: CallerHub erzeugt ein selbst signiertes Zertifikat für diesen Rechner (RSA 3072, SHA-256, 3 Jahre gültig, Namen: Rechnername, vollständiger DNS-Name, localhost und die IPv4-Adressen) im Speicher „Eigene Zertifikate“ des Computers und speichert den öffentlichen Teil als Certificates\callerhub-<Rechner>.cer. Dieser Rechner vertraut dem Zertifikat automatisch (CallerHub trägt es unter „Vertrauenswürdige Stammzertifizierungsstellen“ ein), sodass Browser auf diesem Rechner nicht mehr „Nicht sicher“ anzeigen – die Adresse mit einem im Zertifikat enthaltenen Namen öffnen, z. B. https://<Rechner>:8443/stats. Andere Rechner und die Telefonanlage: diese Datei importieren (vertrauenswürdige Zertifikate, z. B. per Gruppenrichtlinie; Firefox verwendet die Windows-Zertifikate, wenn security.enterprise_roots.enabled eingeschaltet ist). Für den Zugriff über das Internet stattdessen ein Zertifikat einer öffentlichen Zertifizierungsstelle oder der Firmen-Zertifizierungsstelle verwenden.
• Beim Wechsel zwischen HTTP und HTTPS auf demselben Port verweigert Windows den Start mit „Konflikt mit einer vorhandenen Registrierung“. CallerHub erkennt das und bietet an, die Reservierung zu ändern (Administratorrechte).

Windows-Ereignisprotokoll

Ereignisquelle anlegen registriert die Quelle CallerHub einmalig (Administratorrechte) und zeigt danach „Eingerichtet“; die Schaltfläche wechselt zu Ereignisquelle entfernen. Fehler erscheinen in der Ereignisanzeige unter Windows-Protokolle → Anwendung, sobald „Fehler zusätzlich ins Ereignisprotokoll schreiben“ eingeschaltet und gespeichert ist.

Sicherung, Export, Import

• Vor jedem Speichern legt CallerHub eine Sicherung in Backups an (höchstens 20). Sicherung wiederherstellen spielt eine davon zurück.
• Exportieren/Importieren überträgt die Einstellungen als XML-Datei. Passwörter sind mit dem Schlüssel dieses Computers verschlüsselt; auf einem anderen Computer geben Sie sie nach dem Import neu ein.

Fehleranalyse

Alle Werkzeuge stehen im Menü ☰ → Fehleranalyse (Gruppe Betrieb):

Diagnosepaket

Das Paket (ZIP) enthält die Einstellungen ohne Geheimnisse, Systeminformationen (Version, Windows, Arbeitsspeicher, Anzeigeskalierung, Module, Lizenz, Schnittstellen, HTTPS, Port, Proxys, Benachrichtigungen), den Status (JSON), die Antwortzeiten der Oberfläche (ui-performance.txt: Seitenwechsel, Scrollen, Hänger), die Protokolle der letzten Tage und die erweiterten Aufzeichnungen der letzten Tage (Trace\…). Bevor das Paket angezeigt wird, anonymisiert CallerHub jeden Eintrag:

• Benutzer-, Domänen- und Rechnernamen, Benutzerordner, Netzwerkfreigaben und Ordnernamen werden zu Platzhaltern wie user-1, <folder-2> oder <program folder>.
• Server- und Hostnamen aus den Einstellungen und den Protokollen werden zu server-1.example, E-Mail-Adressen zu mail-1@example.invalid, IPv4-Adressen zu ip-1; Datenbankbenutzer in Verbindungszeichenfolgen werden zu user-N.
• Erhalten bleiben: öffentliche Domänen (z. B. microsoft.com), 127.0.0.1 und 0.0.0.0, Datei- und Programmnamen, weil sie für die Analyse nötig sind.
• Derselbe Originalwert erhält immer denselben Platzhalter, sodass Zusammenhänge sichtbar bleiben. ANONYMISATION.txt im Paket listet auf, was ersetzt wurde (Kategorien und Anzahl, nicht die Originalwerte).

Das Fenster Diagnosepaket listet alle Einträge auf; die Auswahl eines Eintrags zeigt dessen Inhalt. Schaltflächen:

• Speichern unter … – speichert die ZIP-Datei.
• Mit E-Mail-Programm senden … – öffnet eine neue Nachricht im Standard-E-Mail-Programm mit dem Paket als Anhang (ist kein E-Mail-Programm registriert, öffnet sich der Explorer mit markierter Datei).
• Hochladen – überträgt das Paket an den Support-Server (FTP mit TLS, sofern angeboten, Ersatzadresse, falls der Name nicht aufgelöst werden kann). Der Dateiname erhält einen zufälligen Zusatz; nennen Sie dem Support den nach dem Hochladen angezeigten Namen. Ein anderes Ziel lässt sich mit DiagnosticUploadUrl in der Einstellungsdatei festlegen.

Prüfen Sie den Inhalt, bevor Sie das Paket weitergeben. Telefonnummern sind im Protokoll ohnehin maskiert.

Ereignisprotokoll: Fehler zusätzlich ins Windows-Anwendungsprotokoll (Quelle CallerHub) schreiben, z. B. für die Überwachung.

Protokoll

Das Protokoll öffnet sich als eigenes Fenster mit eigenem Eintrag in der Taskleiste (☰ → Fehleranalyse → Protokoll anzeigen). Es bleibt nicht im Vordergrund und lässt sich neben dem Hauptfenster verwenden; beim Beenden von CallerHub schließt es sich mit.

2026-10-14 17:03:58.164 WARN   ip=198.51.100.23 pfad=/lookup nummer=- status=403 quelle=- dauer=0ms ergebnis=IP nicht erlaubt

Leistungszeile

Während die Schnittstelle läuft, schreibt CallerHub je Minute mit Anfragen eine Zeile (und beim Stoppen):

INFO   Performance 60 s: requests=41230 rate=687.2/s avg=4ms p50=≤2ms p95=≤10ms p99=≤50ms max=380ms queue_avg=0ms queue_max=12ms concurrent_max=24 errors=0 rejected=0 threads=61 pool_busy=3 memory=88MB gc=120/4/1 call_events_queue=0

Unter hoher Last bleibt die Protokolldatei geöffnet, und das Hauptfenster aktualisiert die Anfrageliste gebündelt, sodass beides die Schnittstelle nicht bremst.

Telefonanlagen-Simulator

☰ → Fehleranalyse → Telefonanlagen-Simulator (Test und Lasttest) … oder Telefonanlagen-Simulator.cmd im Programmordner (CallerHub.exe simulator) öffnet ein eigenes Fenster, das Telefonanlagen gegenüber einer CallerHub-Installation simuliert – zum Testen einer neuen Einrichtung und für Lasttests.

• Adresse von CallerHub und API-Key werden aus den Einstellungen übernommen; Bekannte Nummern (Treffer in den Datenquellen) und Unbekannte Nummern (%) steuern die Mischung.
• Beliebig viele simulierte Anlagen gleichzeitig; je Anlage der Typ und die Last: Ruhig (1 Anruf je Minute), Normal (6 je Minute), Belebt (1 je Sekunde), Hoch (10 je Sekunde), Sehr hoch (50 je Sekunde), Extrem (so schnell wie möglich, 32 parallele Schleifen). Ruhige Stufen laufen in Echtzeit (Klingeln, Gespräch); hohe Stufen melden die Zeiten ohne Wartezeit.
• Typen: Abfrage je Anruf (STARFACE, 3CX, Asterisk, Yealink, Snom), Ereignisse (/event, Placetel, sipgate.io), an CallerHub gesendete Verbindungsdaten (3CX aktiver Socket, OpenScape Business, innovaphone TCP und HTTP) und Anlagen, mit denen sich CallerHub verbindet (3CX passiver Socket, Mitel SMDR, Asterisk AMI, FRITZ!Box-Anrufmonitor).
• Die simulierten Anlagen beantworten SSDP-Suchen und lauschen auf ihren Ports, sodass die Netzwerk-Discovery sie findet.
• Das Fenster zeigt je Anlage Anrufe, Übertragungen, Fehler, Rate und Antwortzeiten; CallerHub schreibt seine Sicht in die Leistungszeile.

Verwenden Sie den Simulator nur gegen eigene Testsysteme: Hohe Stufen erzeugen sehr viele Anfragen, Protokollzeilen und Verbindungsdaten.

Diagnoselauf

Menü Fehleranalyse → Diagnoselauf (höchstens 1 Minute) …, Schaltfläche Diagnoselauf … in Administration → Betrieb oder auf der Kommandozeile CallerHub.exe diagnoselauf. Der Lauf testet die gesamte Einrichtung auf diesem Rechner und erstellt einen Bericht für den Support – innerhalb von 60 Sekunden.

1. Aktuelle Einrichtung: die Prüfungen beim Speichern, doppelt vergebene Ports, der Systemzustand.
2. Rechner und Netzwerk: Domänenmitgliedschaft, DNS-Name, Netzwerkadressen, ob der Port frei ist oder von CallerHub belegt wird, ob die Datenbank- und Mailserver antworten, freier Speicherplatz, Schreibrecht auf die Ordner für Protokoll und Statistik, ob die Fehleranalyse noch aktiv ist und wie schnell die Oberfläche reagiert hat.
3. Unlogische Einstellungen: etwa 16 Kombinationen, die ein Administrator einstellen kann (z. B. zwei Schnittstellen mit demselben API-Key, ein Empfänger auf dem Port der Schnittstelle, ein Webhook ohne Adresse, alle Datenquellen ausgeschaltet, eine fehlende CSV-Datei); jede muss erkannt werden. Ein Start mit fehlender Datei darf die Schnittstelle nicht zum Absturz bringen.
4. Live-Test: eine zweite Schnittstelle nur auf localhost mit freien Ports und temporären Ordnern, mit Ihren Datenquellen und Schnittstellen sowie einer Testdatenbank (Samples\simulator-contacts.csv, 20.000 erfundene Kontakte), allen Modulen, fünf Live-Empfängern und einer Aktion für Anrufereignisse an einen lokalen Testempfänger. Der Simulator sendet mit 11 Telefonanlagen; danach werden etwa 25 Adressen mit richtigen und falschen Schlüsseln, ungewöhnlichen Nummern und Methoden aufgerufen.
5. Laststufen: 10/s, 50/s, so schnell wie möglich mit einer und mit drei Telefonanlagen; der Lauf stoppt bei mehr als 5 % Fehlern oder 5 Sekunden Antwortzeit und meldet die Grenze.
6. Hilfe und Benutzeraktionen: ob die Hilfe die verwendeten Funktionen beschreibt und was Sie selbst tun müssen (z. B. Firewall-Regel, Einstellungen in der Telefonanlage).

Ihre gespeicherten Einstellungen werden nie geändert: Der Lauf verwendet nur Kopien und prüft am Ende, dass die Einstellungsdatei und die geladenen Einstellungen unverändert sind. Echte Ziele werden nicht angesprochen – keine CRM-Aktionen, E-Mails, Webhooks, Plugins oder Verbindungen zu Ihren Telefonanlagen; Ihre Datenquellen erhalten nur wenige Abfragen. Windows fragt eventuell einmal, ob CallerHub Verbindungen annehmen darf (Firewall).

Der Bericht diagnostic-run.txt ist für Menschen geschrieben, nicht nur für den Support:

• Ergebnis – ein Satz: Alles ist in Ordnung, oder wie viele Punkte Aufmerksamkeit brauchen.
• Empfehlungen – gruppiert nach Wichtig, Empfohlen und Optional; jeweils mit Wo, der Stelle in der Anwendung (z. B. Administration > Sicherheit). Doppelte Hinweise werden einmal aufgeführt.
• Leistung – in Worten, z. B. wie viele Anrufe je Minute CallerHub beantworten kann.
• Übersicht je Bereich und am Ende die Technischen Einzelheiten (Laststufen, jede Prüfung).

Während der Lauf aktiv ist, gehen Meldungen der Test-Schnittstelle nur ins Protokoll; Fußzeile und Startseite sind nicht betroffen.

Anschließend öffnet sich das Diagnosepaket mit der Datei diagnostic-run.txt; speichern, senden oder hochladen Sie es wie unter Diagnosepaket beschrieben. Wie das Paket ist auch der Bericht anonymisiert.

Fehlersuche

Fehlermeldungen nennen Ursache und Vorschlag; Details stehen im Protokoll. Der Systemzustand zeigt die meisten Ursachen mit passender Schaltfläche. Für eine zweite Meinung: ☰ → KI-Assistent (Claude-Chat) → Letzten Fehler analysieren ….

Häufige Fragen

Eine Datenquelle oder Schnittstelle zeigt „Unvollständig“. Was fehlt?

Der Grund steht neben dem Untertitel der Karte und als Tooltip über ihrer Kopfzeile; auch die Speicherleiste nennt die erste fehlende Angabe. Administration → Systemzustand listet jede unvollständige oder ungültige Einstellung. Öffnen neben einem Eintrag öffnet Seite und Karte und rahmt das betroffene Feld rot ein. Beim Speichern werden ungültige Felder der aktuellen Ansicht ebenfalls eingerahmt.

Das Fenster reagiert manchmal langsam. Was kann ich tun?

CallerHub misst, wie schnell sich Seiten öffnen, wie lange das Blättern dauert und ob das Fenster nicht mehr reagiert. Langsame Aktionen (ab 150 ms) schreibt CallerHub einmal pro Minute ins Protokoll, z. B. UI performance: page:administration took 260 ms; das Diagnosepaket enthält die Zusammenfassung in ui-performance.txt. Senden Sie das Paket an den Support. Typische Ursachen sind eine laufende Fehleranalyse (ausführliche Protokollierung), ein voller Datenträger oder ein Virenscanner, der den Programmordner prüft.

Warum hat Starten nicht alles gestartet?

Starten startet alles, was vollständig ist. Unvollständige Datenquellen und Schnittstellen werden übersprungen; CallerHub nennt sie einmal, und der Systemzustand listet sie weiter, bis sie vollständig sind.

Wie viele Datenquellen und Schnittstellen sind möglich?

Jeweils bis zu 10; der Zähler zeigt z. B. „3 von 10“. Mehr sind mit einer Sonderlizenz möglich (callerhub.de).

Wie ändere ich die Reihenfolge der Datenquellen?

Ziehen Sie die Kopfzeile einer Karte an die neue Position (eine Linie zeigt, wo sie eingefügt wird), oder verwenden Sie die Pfeilschaltflächen in der geöffneten Karte. Die erste Quelle mit Treffer liefert den Namen.

Wo liegen die Datenbanktreiber?

Im Ordner Drivers neben CallerHub.exe. Nach einer Aktualisierung von einer älteren Version werden der Ordner native und eine Oracle.ManagedDataAccess.dll neben der Programmdatei nicht mehr benötigt und können gelöscht werden.

Der SQL-Assistent findet Mitarbeiter, aber keine Kunden oder Lieferanten.

In vielen ERP-Systemen stehen die Telefonnummern in einer eigenen Kommunikationstabelle, die über einen Schlüssel mit der Firma oder Person verknüpft ist. Der Assistent erkennt solche Verknüpfungen und schlägt eine Abfrage vor, die die Tabellen verbindet (eine oder zwei Ebenen, z. B. Firma und Ansprechpartner). Prüfen Sie den Vorschlag vor dem Speichern mit Testen.

Welches Trennzeichen verwenden Listen?

Überall ein Semikolon, z. B. in der Sperrliste, der VIP-Liste, bei Empfängern und Ersetzungen (je Zeile eine, z. B. Limited;Ltd). Die frühere Schreibweise => für Ersetzungen wird weiterhin akzeptiert.

Wie sende ich Diagnosedaten an den Support?

☰ → Fehleranalyse → Diagnosepaket erstellen und ansehen …; die Einträge im Fenster prüfen, dann Speichern unter … oder Mit E-Mail-Programm senden …. Benutzer-, Computer- und Servernamen, Ordner, E-Mail- und IP-Adressen werden durch Platzhalter ersetzt (siehe Diagnosepaket).

Die Telefonanlage zeigt keine Namen an. Wie finde ich die Ursache?

Siehe Typische Fehler beim Anbinden. Hilft das nicht: ☰ → Fehleranalyse → Erweiterte Aufzeichnung starten …, einen Testanruf führen, dann ein Diagnosepaket erstellen – es enthält die Aufzeichnung.

Was bedeutet „Wartet auf Anfragen“?

Die Schnittstelle läuft, aber noch keine Telefonanlage hat eine Anfrage gesendet. Nach der ersten Anfrage wechselt die Anzeige auf „Läuft“. Bleibt sie bei einem Testanruf auf „Wartet auf Anfragen“, erreicht die Anfrage CallerHub nicht (Adresse, Port, Firewall).

Wie erkenne ich, ob CallerHub als Windows-Dienst läuft, und wie beende ich ihn?

Siehe Windows-Dienst: die Karte zeigt den Zustand; in einer Eingabeaufforderung funktionieren sc.exe query CallerHub und sc.exe stop CallerHub.

Ich habe die Sprache geändert, aber nichts ist passiert.

Eine neue Sprache wird nach einem Neustart wirksam. Der Dialog „Select Language“ bietet Jetzt neu starten oder Später an.

Wo sind alle Einstellungen? Einige Karten fehlen.

Der einfache Modus zeigt nur, was für den Betrieb nötig ist. ☰ → Erweiterte Einstellungen anzeigen zeigt alles, z. B. „Anzeige und Link“ einer Datenquelle oder die Karten Sicherheit und Betrieb in der Administration.

Wie sehe ich die aktuellen Einstellungen, wenn die Datei verschlüsselt ist?

Administration → Datenschutz → Aktuelle Einstellungen anzeigen … listet alle gespeicherten Einstellungen; Passwörter, Schlüssel und Zugangsdaten erscheinen als ***.

Versionen und Lizenzschlüssel

CallerHub gibt es in zwei Versionen. Einen Lizenzschlüssel geben Sie unter Administration → Lizenz ein; CallerHub prüft ihn ohne Internetverbindung anhand einer Signatur (RSA 3072 Bit, SHA-256, nach BSI TR-02102-1) und zeigt Kunde, Ablaufdatum und die freigeschalteten Funktionen.

Mehrere Lizenzen: die Karte zeigt alle eingegebenen Schlüssel als Liste (Kunde, Lizenznummer, Funktionen, gültig bis, Zustand). Lizenz hinzufügen … fügt einen Schlüssel hinzu, der Stift ersetzt ihn, der Papierkorb entfernt ihn. Die Funktionen aller gültigen Schlüssel addieren sich – z. B. die Vollversion plus die Sonderlizenz Rebranding oder ein zusätzliches Schnittstellenpaket. Die Statuszeile zeigt das Gesamtergebnis.

Die Karte Lizenz listet jede lizenzpflichtige Funktion und jedes lizenzpflichtige Modul mit seinem Zustand (Lizenziert oder Nicht lizenziert) für den eingegebenen Schlüssel oder die Testversion. Module der Vollversion sind unter Administration → Module zusätzlich mit „· Vollversion“ gekennzeichnet. Lizenzschlüssel erhalten Sie über callerhub.de.

Lizenzvertrag und Datenschutzhinweise

Lizenzvertrag und Datenschutzhinweise liegen im Programmordner: LICENSE.txt (Englisch) und LICENSE.de.txt (Deutsch, maßgeblich), PRIVACY.txt und PRIVACY.de.txt.

• Grundversion: kostenlos für private und gewerbliche Nutzung auf beliebig vielen Computern; kein Anspruch auf Support oder Aktualisierungen.
• Vollversion: einfaches, nicht ausschließliches Nutzungsrecht für die im Lizenzschlüssel genannten Funktionen und Laufzeit, für den darin genannten Kunden.
• Nicht erlaubt: die Lizenzprüfung umgehen, das Programm verändern oder zurückentwickeln (soweit nicht gesetzlich erlaubt), Hinweise entfernen. Die Weitergabe des unveränderten Programmordners ist erlaubt (ohne Lizenzschlüssel und Einstellungen).
• Daten: CallerHub arbeitet nur auf Ihren Computern und sendet keine Daten an den Anbieter – keine Telemetrie, keine Werbung. Sie sind Verantwortlicher im Sinne der DSGVO; die Datenschutzhinweise nennen alle Daten, Ordner, Aufbewahrungsfristen und Empfänger für Ihr Verzeichnis (Art. 30 DSGVO) und Ihre Datenschutzinformation (Art. 13/14 DSGVO).
• Haftung: Grundversion nur bei Vorsatz und grober Fahrlässigkeit; Vollversion nach den gesetzlichen Vorschriften mit der üblichen Beschränkung bei leichter Fahrlässigkeit. Es gilt deutsches Recht; zwingende Verbraucherrechte bleiben unberührt.

Lizenzen

CallerHub (c) 2026 - Simon Bernhard · callerhub.de

Symbole: Bootstrap Icons, MIT-Lizenz, Copyright (c) 2019-2024 The Bootstrap Authors.

CallerHub enthält die .NET-10-Laufzeit und Microsoft.Data.SqlClient (Microsoft, MIT-Lizenz), System.Data.Odbc sowie Oracle.ManagedDataAccess.Core (Oracle Corporation). Die Lizenztexte liegen im Ordner Licenses (Übersicht OVERVIEW.txt). ODBC-Treiber stammen von den jeweiligen Herstellern. Genannte Produktnamen sind Marken ihrer Inhaber; CallerHub steht in keiner Verbindung zu diesen Herstellern.