BlueRockTEL API: Beispielanwendung mit dem 3CX Call Flow Designer

Die BlueRockTEL API

BlueRockTEL stellt mehrere API-Routen bereit, mit denen Sie Ihre Kundendatenbank in Echtzeit abfragen können. Diese Routen wurden insbesondere für die Integration mit dem 3CX Call Flow Designer entwickelt, sind jedoch für jedes System geeignet, das eine On-the-fly-Kundenidentifikation erfordert.

Grundlegende Identifikation anhand der Rufnummer

`/api/isKnownPhoneNumber`

Diese Route identifiziert einen Anrufer anhand seiner Telefonnummer. Die Suche umfasst:

Die primäre Nummer des Kundendatensatzes
Alle Telefonnummern der zugehörigen Kontakte
In den Kundendatensätzen hinterlegte Durchwahlen

Die Suche nutzt Indexierung für nahezu sofortige Ergebnisse, auch bei einer großen Kundenbasis.

`/api/isKnownCustomerAccount`

Diese Route wird verwendet, wenn ein Anrufer nicht anhand seiner Rufnummer identifiziert werden kann, aber seine BlueRockTEL-Kontonummer angibt. Sie validiert die Existenz des Kontos und gibt die zugehörigen Informationen zurück.

VIP-Kundenidentifikation

BlueRockTEL ermöglicht die Kategorisierung Ihrer Kunden. Die folgenden Routen erkennen, ob ein Anrufer einen VIP-Status besitzt:

/api/isVipByPhoneNumber — Prüft den VIP-Status anhand der Anrufnummer
/api/isVipByCustomerAccount — Prüft den VIP-Status anhand der Kontonummer

Dies ermöglicht beispielsweise die automatische Weiterleitung von VIP-Anrufen an eine dedizierte Warteschlange oder einen bestimmten Techniker.

Bereitschaftsdienst-Verträge

Diese Routen prüfen, ob ein Kunde einen aktiven Bereitschaftsdienst-Vertrag hat:

/api/hasOnCallDutyContractByPhoneNumber — Über die Anrufnummer
/api/hasOnCallDutyContractByCustomerAccount — Über die Kontonummer

Typischer Anwendungsfall: Weiterleitung eingehender Anrufe außerhalb der Geschäftszeiten an ein Bereitschaftsteam — ausschließlich für Kunden, die diesen Dienst abonniert haben, ohne ihn für alle zu aktivieren.

Anwendungsfall im 3CX Call Flow Designer

Durch die Kombination dieser Routen in einem Call Flow Designer können Sie intelligente Anrufabläufe aufbauen:

Der Anrufer wählt Ihre Nummer
Der CFD fragt /api/isKnownPhoneNumber ab — wird der Anrufer nicht erkannt, wird die Kontonummer abgefragt
Der CFD prüft /api/isVipByPhoneNumber — bei VIP-Status wird der Anruf in die Prioritätswarteschlange weitergeleitet
Außerhalb der Geschäftszeiten prüft der CFD /api/hasOnCallDutyContractByPhoneNumber — nur berechtigte Kunden erreichen das Bereitschaftsteam