Vereinfacht ausgedrückt verwendet das Widget „Anrufen bei (über API)“ eine API-Antwort, um anhand von Daten, die außerhalb von Aircall gespeichert sind, zu ermitteln, welches Aircall-Team, welcher Benutzer, welche interne Nummer oder welche externe Nummer angerufen werden soll.
Während „Ring to“ (über API) ein flexibles Widget ist, mit dem eine Reihe gewünschter Workflows 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 für dynamisches Routing verwendet wird Anrufe an einen Aircall-Benutzer.
Voraussetzungen
Bevor Sie das Ring-Widget (über die 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 am Beispiel der Aircall-API die Standardauthentifizierungsmethode. Wir generieren einen API-Schlüssel, indem wir zum Abschnitt „Integrationen & API“ des Dashboards, klicken Sie auf die Registerkarte „API-Schlüssel“ und generieren Sie den Schlüssel.
📚 Wo zu finden mein Aircall API-Schlüssel
Wir speichern nun die ID und das Token des API-Schlüssels, gehen dann in der Konfiguration des Ring to (via API)-Widgets zu „Anmeldeinformationen“ und legen die API-Schlüssel-ID als Benutzernamen und das Token als Passwort fest.
Kenntnisse der Plattform-API
Abhängig von der Plattform, von der Sie Daten abrufen möchten, ist es wichtig, gut zu verstehen, 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 angefordert werden, um Routing-Entscheidungen zu treffen.
JSON-Kenntnisse
Ring to (über API) verwendet auch JSON oder JavaScript Object Notation, ein standardmäßiges textbasiertes Format, das häufig zum Übertragen von Daten zwischen Webanwendungen verwendet wird.
Wir empfehlen, sich mit den Grundkonzepten von JSON vertraut zu machen, bevor Sie versuchen, das Ring-Widget (über die API) zu konfigurieren.
Wenn Sie Hilfe bei der Einrichtung des Ring to (über API)-Widgets benötigen, wenden Sie sich an das Professional Services-Team von Aircall. ist in der Lage, durch technische Beratung und praktische Umsetzung den Erfolg sicherzustellen.
Konfigurationsschritte
Das Endverhalten des Widgets „Klingeln an (über API)“ besteht darin, dass es entweder bei einem Aircall-Benutzer, einem Aircall-Team, einer Aircall-Nummer oder einer externen Nummer außerhalb von Aircall klingelt.
In diesem Beispiel betrachten wir das Klingeln eines Aircall-Benutzers mithilfe des Search Calls-Endpunkts von Aircall API .
Die API oder der Abschnitt der API, den wir verwenden möchten, bestimmt, ob wir GET oder POST als „Methode“ in der Ring to (via API)-Konfiguration auswählen. Da wir in diesem Fall den Search Calls-Endpunkt der Aircall-API verwenden, wählen wir GET als Methode.
Für die 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 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 für die Suche nach einer relevanten Telefonnummer verwendet werden kann.
Andere Variablen, die in dieser URL enthalten sein könnten, sind unter den Abfrageparametern in den Suchaufrufen aufgeführt Aircall API-Dokumentation .
Antwortkonfiguration
Jetzt schauen wir uns den Abschnitt „Antwortkonfiguration“ des Ring to (via API)-Widgets an.
Die unterstützten Antworttypen sind:
- 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 „Suchaufrufe“ 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 „Aufrufe“ der Antwort verweist, wobei jeder Punkt auf einen Unterabschnitt des Abschnitts „Aufrufe“ verweist (in diesem Fall „Benutzer“ und „ id“-Wert). Der in Klammern enthaltene Wert 0 ist ein Array, das angibt, dass die Antwort mit dem ersten Aufruf in der Liste beginnt.
Anschließend können wir über den Abschnitt „Testantwort“ des Widgets „Ring an (über API)“ sicherstellen, dass der von uns gewählte Pfad korrekt ist, indem wir eine Telefonnummer eingeben, für die wir die Abfrage ausführen möchten.
Bitte stellen Sie sicher, dass die im Feld „Testantwort“ eingegebene Nummer in steht. E.164-Format .
Wenn ein Fehler vorliegt, lesen Sie bitte den Abschnitt Fehler der Aircall-API-Dokumentation , das die Ursache des Fehlers angibt und bei der Fehlerbehebung hilft.
Schließlich können wir die Klingeleinstellungen einrichten, die mit den Klingeleinstellungen im Standard-Widget „Klingeln an“ identisch sind. Weitere Informationen zu den Klingeleinstellungen finden Sie in unserem Hilfeartikel zur Anrufweiterleitung .
Wenn Sie Hilfe bei der Einrichtung des Ring to (über API)-Widgets benötigen, wenden Sie sich an das Professional Services-Team von Aircall. ist in der Lage, technische Beratung und praktische Implementierung anzubieten, um den Erfolg sicherzustellen.