Einfach ausgedrückt verwendet das Smart Routing-Widget „Ruf an (über API)“ eine API-Antwort, um basierend auf Daten außerhalb von Aircall zu ermitteln, welches Aircall-Team, welcher Benutzer, welche interne oder externe Nummer angerufen werden soll.
„Ruf an (über API)“ ist ein flexibles Widget, mit dem sich verschiedene gewünschte Workflows auf Basis externer Plattformen realisieren lassen. In diesem Tutorial sehen wir uns jedoch ein Beispiel an, bei dem die Aircall-API verwendet wird, um Anrufe dynamisch an einen Aircall-Benutzer weiterzuleiten.
⚠️ Sie müssen den Professional-Plan nutzen, um in Ihrem Smartflows-Editor auf das Widget „Ruf an (über API)“ zugreifen zu können. Wenn Sie ein Upgrade wünschen, wenden Sie sich bitte an Ihren Account Manager.
Voraussetzungen
Stellen Sie vor der Konfiguration des Widgets „Ring to (via API)“ 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 (via API)“ unterstützt derzeit die Standardauthentifizierung, Bearer Token, API-Schlüssel und OAuth.
In diesem Beispiel verwenden wir anhand der Aircall-API die Standardauthentifizierungsmethode. 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 und gehen dann in der Widget-Konfiguration „Anrufen an (über API)“ zu „Anmeldeinformationen“ und legen die API-Schlüssel-ID als Benutzernamen und das Token als Kennwort fest.
Kenntnisse der Plattform-API
Je nachdem, von welcher Plattform Sie Daten abrufen möchten, ist es wichtig, ein gutes Verständnis davon zu haben, was in der öffentlichen API dieser Plattform enthalten ist.
Diese Dokumentation verwendet die Aircall-API als Beispiel, Benutzer können jedoch auch andere Partnerplattformen wie HubSpot, Salesforce, Zendesk, Intercom, Pipedrive oder interne CRMs als Plattformen verwenden, auf denen Daten angefordert werden, um Routing-Entscheidungen zu treffen.
JSON-Kenntnisse
„Ring to (via 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 Grundkonzepten von JSON vertraut zu machen, bevor Sie versuchen, das „Ring to (via API)“-Widget zu konfigurieren.
Wenn Sie Hilfe bei der Einrichtung des „Ring to (via API)“-Widgets benötigen, kann Ihnen das Professional Services-Team von Aircall technische Beratung und praktische Implementierung bieten, um den Erfolg sicherzustellen.
Hinweise zur Verwendung
Das Widget „Ring to (via API)“ 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 von Ihnen definierte externe System oder jede Datenbank abfragen (sofern es eine webbasierte REST-API und Standardauthentifizierungsmethoden unterstützt) und, was am wichtigsten ist, den eingehenden Anrufer als Antwort auf die API-Anfrage/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 den Anruf an einen bestimmten Agenten weiter, basierend auf der Aircall-Benutzer-ID oder E-Mail-Adresse.
- Team : Leitet den Anruf an ein bestimmtes Team weiter, basierend auf der Aircall-Team-ID.
- Aircall-Nummer : Leitet den Anruf intern an eine andere Aircall-Nummer weiter, basierend auf der Aircall-Nummern-ID
- Externe Nummer : Leitet den Anruf extern an eine angegebene Telefonnummer weiter (muss im internationalen E.164-Format vorliegen)
Was passiert, wenn Sie dem Routing zusätzliche erweiterte Logik hinzufügen müssen, bevor Sie den eingehenden Anruf an den erforderlicher Benutzer, Team oder Nummer (z. B. bedingte Verzweigungen, Schleifen usw.)?
Im Wesentlichen müssen Sie die erweiterte Logik, an wen oder wohin der eingehende Anrufer weitergeleitet werden soll, außerhalb von Aircall handhaben . 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, es ist 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 – anschließend 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 betrachten wir das Anrufen eines Aircall-Benutzers mithilfe des Endpunkts „Anrufe suchen“ der Aircall-API .
Die API oder der Abschnitt der API, den wir verwenden, bestimmt, ob wir in der Konfiguration „Anrufen an (über API)“ GET oder POST als „Methode“ auswählen. Da wir in diesem Fall den Endpunkt „Anrufe suchen“ der Aircall-API verwenden, wählen wir GET als Methode.
Als URL verwenden wir Folgendes als Beispiel:
https://api.aircall.io/v1/calls/search?order=des & phone_number= {{callerNumber}}
Basierend auf dieser URL sucht „Ring to“ (über die API) in absteigender Reihenfolge nach Telefonnummern, d. h. die Suche beginnt bei 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 für die Suche nach einer relevanten Telefonnummer verwendet werden kann.
Andere Variablen, die in diese URL aufgenommen werden könnten, sind unter den Abfrageparametern in der Aircall-API-Dokumentation zu Suchaufrufen aufgeführt.
Antwortkonfiguration
Nun sehen wir uns den Abschnitt „Antwortkonfiguration“ des Widgets „Anrufen an (über API)“ an.
Folgende Antworttypen werden unterstützt:
- Benutzer (ID oder E-Mail)
- Team (ID)
- Aircall-Nummer (intern)
- Externe Nummer
Ähnlich wie beim Standard-Widget „Anrufen an“ 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
In der Aircall-API-Dokumentation 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 die Werte „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.
Wir können dann im Abschnitt „Antwort testen“ des Widgets „Anrufen an (über API)“ sicherstellen, dass der gewählte Pfad richtig ist, indem wir eine Telefonnummer eingeben, unter der wir die Abfrage ausführen möchten.
Stellen Sie sicher, dass die im Feld „Testantwort“ eingegebene Nummer im E.164-Format vorliegt.
Tritt ein Fehler auf, konsultieren Sie bitte den Abschnitt „Fehler“ der Aircall-API-Dokumentation . Dort finden Sie die Fehlerursache und Hilfe bei der Fehlerbehebung.
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 Hilfeartikel zur Anrufweiterleitung .
Wenn Sie Hilfe bei der Einrichtung des Widgets „Klingeln an (über API)“ benötigen, steht Ihnen Professional Services-Team von Aircall mit technischer Beratung und praktischer Implementierung zur Verfügung, um den Erfolg sicherzustellen.