Einfach ausgedrückt verwendet das Smart Routing-Widget „Anrufen an (über API)“ eine API-Antwort, um basierend auf Daten außerhalb von Aircall zu ermitteln, welches Aircall-Team, welcher Benutzer, welche interne Nummer oder welche externe Nummer angerufen werden soll.
Während „Ring to (via API)“ ein flexibles Widget ist, mit dem eine Reihe gewünschter Arbeitsabläufe auf der Grundlage einer Reihe externer Plattformen erreicht werden können, sehen wir uns in diesem Tutorial ein Beispiel an, bei dem die Aircall-API zum dynamischen Weiterleiten von Anrufen an einen Aircall-Benutzer verwendet wird.
Voraussetzungen
Bevor Sie das Widget „Anrufen an (über API)“ konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:
Authentifizierungsdaten
Die Authentifizierungsmethode hängt von der externen Plattform ab, deren Daten Sie abrufen möchten. Ring to (über API) unterstützt derzeit Basisauthentifizierung, Bearer Token, API-Schlüssel und OAuth.
In diesem Beispiel verwenden wir die Aircall-API als Beispiel und die Methode der Basisauthentifizierung. Wir generieren einen API-Schlüssel, indem wir zum Abschnitt „Integrationen & API“ des Dashboards navigieren, auf die Registerkarte „API-Schlüssel“ klicken und den Schlüssel generieren.
📚 Wo finde ich meinen Aircall API-Schlüssel?
Wir speichern jetzt die ID und das Token des API-Schlüssels, gehen dann in der Widget-Konfiguration „Ring an (über API)“ zu „Anmeldeinformationen“ und legen die API-Schlüssel-ID als Benutzernamen und das Token als Kennwort fest.
Kenntnisse der Plattform-API
Abhängig von der Plattform, von der Sie Daten abrufen möchten, ist es wichtig, ein gutes Verständnis davon zu haben, was in der öffentlichen API dieser Plattform enthalten ist.
In dieser Dokumentation wird die Aircall-API als Beispiel verwendet. Benutzer können jedoch auch andere Partnerplattformen wie HubSpot, Salesforce, Zendesk, Intercom, Pipedrive oder interne CRMs als Plattformen verwenden, auf denen Daten zur Entscheidungsfindung im Routing angefordert werden.
Kenntnisse in JSON
Ring to (über API) verwendet auch JSON oder JavaScript Object Notation, ein standardmäßiges textbasiertes Format, das häufig zur Datenübertragung zwischen Webanwendungen verwendet wird.
Wir empfehlen, sich mit den grundlegenden Konzepten von JSON vertraut zu machen, bevor Sie versuchen, das Ring-to-Widget (über API) zu konfigurieren.
Wenn Sie Hilfe bei der Einrichtung des Ring-to-Widgets (über API) benötigen, kann Ihnen das Professional Services-Team von Aircall technische Beratung und praktische Implementierung bieten, um den Erfolg sicherzustellen.
Hinweise zur Verwendung
Das Ring to (via API)-Widget bietet leistungsstarke Funktionen, indem es dynamisches („intelligentes“) Anrufrouting basierend auf Daten ermöglicht, die von Ihrem externen System abgerufen werden. Das Widget kann praktisch jedes externe System oder jede Datenbank abfragen, die Sie definieren (sofern es eine webbasierte REST-API und Standardauthentifizierungsmethoden unterstützt) und, was am wichtigsten ist, den eingehenden Anrufer nach der Antwort auf die API-Anforderung/-Abfrage weiterleiten – das ist der Schlüssel.
Die API-Antwort muss Daten in einem Format zurückgeben, das Aircall interpretieren und für das Routing verwenden kann. Zu den unterstützten Antworttypen gehören:
- Benutzer : Leitet an einen bestimmten Agenten weiter, basierend auf der Aircall-Benutzer-ID oder E-Mail
- Team : Routen zu einem bestimmten Team basierend auf der Aircall-Team-ID
- Aircall-Nummer : Leitet intern an eine andere Aircall-Nummer weiter, basierend auf der Aircall-Nummer-ID
- Externe Nummer : Leitet extern an eine angegebene Telefonnummer weiter (muss im internationalen E.164-Format vorliegen)
Was aber, wenn Sie der Weiterleitung zusätzliche erweiterte Logik hinzufügen müssen, bevor der eingehende Anruf an den erforderlichen Benutzer, das erforderliche Team oder die erforderliche Nummer weitergeleitet wird (z. B. bedingte Verzweigungen, Schleifen usw.)?
Im Wesentlichen müssen Sie die erweiterte Logik handhaben, an wen oder wohin der eingehende Anrufer außerhalb von Aircall weitergeleitet werden soll . Erst wenn die endgültige Entscheidung getroffen ist, müssen Sie eine der oben genannten Optionen als Teil der API-Antwortnutzlast präsentieren.
Mit anderen Worten handelt es sich um ein einfaches Widget, das die Frage stellt: „ An wen oder wohin soll ich den eingehenden Anrufer weiterleiten? “. Es berücksichtigt keine komplexe Logik (z. B. wenn dies, dann das, aber zuerst dies prüfen usw.). Die komplexe Logik muss zuerst außerhalb von Aircall verwaltet/verarbeitet werden – danach muss die Antwort auf die Frage dem Widget zurückgegeben werden.
Konfigurationsschritte
Das Endverhalten des Widgets „Anrufen an (über API)“ besteht darin, dass es entweder einen Aircall-Benutzer, ein Aircall-Team, eine Aircall-Nummer oder eine externe Nummer außerhalb von Aircall anruft.
In diesem Beispiel sehen wir uns das Anrufen bei einem Aircall-Benutzer an, indem wir den Suchanruf-Endpunkt der Aircall-API verwenden.
Die API oder der Abschnitt der API, den wir verwenden möchten, bestimmt, ob wir GET oder POST als „Methode“ in der Konfiguration „Ring to (via API)“ auswählen. In diesem Fall, da wir den Search Calls-Endpunkt der Aircall-API verwenden, wählen wir GET als Methode.
Für die URL verwenden wir als Beispiel Folgendes:
https://api.aircall.io/v1/calls/search?order=des & phone_number= {{callerNumber}}
Basierend auf dieser URL sucht „Ring to“ (über API) in absteigender Reihenfolge nach Telefonnummern, d. h. die Suche beginnt mit den letzten Anrufen. Aircall verwendet auf Partnerplattformen fast immer entweder Telefonnummern oder E-Mail-Adressen als eindeutige Kennung. Dies ist also eine gängige URL, die zur Suche nach einer relevanten Telefonnummer verwendet werden kann.
Andere Variablen, die in dieser URL enthalten sein könnten, sind unter den Abfrageparametern in der Suchaufrufe Aircall API-Dokumentation aufgeführt.
Antwortkonfiguration
Nun schauen wir uns den Abschnitt „Antwortkonfiguration“ des Widgets „Ring an (über API)“ an.
Die unterstützten Antworttypen sind:
- Benutzer (ID oder E-Mail)
- Team (ID)
- Aircall-Nummer (intern)
- Externe Nummer
Ähnlich wie beim Standard-Widget „Anrufen“ bestimmt der Antworttyp, an wen eingehende Anrufe weitergeleitet werden. „Benutzer“ klingelt bei einem einzelnen Aircall-Agenten, „Team“ klingelt bei einem Aircall-Team, „Aircall-Nummer“ klingelt bei einer anderen Aircall-Nummer und „Externe Nummer“ klingelt bei einer Nummer außerhalb von Aircall.
Der Abschnitt „Pfad“ analysiert die von der API bereitgestellte Antwort. Da wir den Endpunkt „Anrufe suchen“ der Aircall-API nutzen, können wir die Antwort in der Aircall-API-Dokumentation sehen.
Nehmen wir Folgendes als Beispiel:
calls[0].user.id
Wenn wir uns die Aircall API-Dokumentation ansehen, können wir sehen, dass der Pfad auf den Abschnitt „Anrufe“ der Antwort verweist, wobei jeder Punkt auf einen Unterabschnitt des Abschnitts „Anrufe“ verweist (in diesem Fall auf den Wert „Benutzer“ und „ID“). Der in Klammern enthaltene Wert 0 ist ein Array, das angibt, dass die Antwort mit dem ersten Anruf in der Liste beginnt.
Anschließend können wir im Abschnitt „Testantwort“ des Widgets „Anrufen an (über API)“ sicherstellen, dass der von uns gewählte Pfad korrekt ist. Dazu geben wir eine Telefonnummer ein, unter der wir die Abfrage ausführen möchten.
Bitte stellen Sie sicher, dass die im Feld „Testantwort“ eingegebene Nummer im E.164-Format vorliegt.
Wenn ein Fehler auftritt, konsultieren Sie bitte den Abschnitt „Fehler“ der Aircall-API-Dokumentation , der den Grund des Fehlers angibt und bei der Fehlerbehebung hilft.
Abschließend können wir die Klingeleinstellungen einrichten, die mit den Klingeleinstellungen des Standard-Widgets „Klingeln an“ identisch sind. Weitere Informationen zu den Klingeleinstellungen finden Sie in unserem Hilfe-Center-Artikel zur Anrufweiterleitung .
Wenn Sie Hilfe bei der Einrichtung des Ring-to-Widgets (über API) benötigen, steht Ihnen Professional Services-Team von Aircall mit technischer Beratung und praktischer Implementierung zur Verfügung, um den Erfolg sicherzustellen.