Die intelligente Anrufweiterleitung zum letzten Agenten stellt sicher, dass zurückkehrende Anrufende automatisch mit dem Agenten verbunden werden, der sie zuletzt kontaktiert hat. Durch die Verwendung des Widgets Ring-to (via API) in Smartflows können Sie Ihre Bemühungen bei ausgehende Anrufe verbessern und Ihren wiederkehrenden Kund:innen ein nahtloseres Erlebnis bieten.

Achtung: Das Widget Ring-to (via API) muss über ein Feature-Flag aktiviert werden. Wenden Sie sich an Ihre Aircall Ansprechperson, um dies vor dem Fortfahren zu aktivieren.
Hinweis: Im Video-Tutorial wird möglicherweise die vorherige Version des Abschnitts „Test response“ angezeigt. Halten Sie sich für die aktuellsten Anweisungen immer an die schriftlichen Schritte in diesem Artikel.

Warum intelligente Anrufweiterleitung zum letzten Agenten verwenden?

Die Verwendung des Widgets Ring-to (via API) zur Konfiguration der Weiterleitung zum letzten Agenten bietet mehrere Vorteile:

  • Verbessertes Erlebnis für Anrufende durch die Verbindung wiederkehrender Kund:innen mit dem Agenten, der ihren Fall kennt
  • Weniger Gesprächsabbrüche, da Anrufe direkt an eine bekannte Kontaktperson gehen
  • Höhere Effizienz, da nicht das gesamte Team durch nicht zugehörige eingehende Anrufe unterbrochen wird
  • Besseres Lead-Management, da Agenten sich auf ihre eigenen Prospects konzentrieren

Erstellen Sie Ihren Aircall API-Schlüssel

Zu Beginn benötigen Sie einen Aircall API-Schlüssel. Damit kann sich das Widget Ring-to (via API) authentifizieren und den Verlauf abrufen.

Schritte

  1. Gehen Sie im Aircall Dashboard zu Integrations & API > API Keys.
  2. Klicken Sie auf Generate an API Key.
Screenshot 2025-09-16 at 6.51.05 PM.png
Screenshot 2025-09-16 at 6.52.20 PM.png
  1. Benennen Sie Ihren Schlüssel und kopieren Sie dann die API ID und das API token.
Screenshot 2025-09-16 at 6.55.35 PM.png
  1. Speichern Sie diese sicher, da das Token nur dieses eine Mal sichtbar ist.
  2. Klicken Sie auf Confirm.
Hinweis: Wenn Sie das Token verlieren, müssen Sie ein neues generieren.

Richten Sie das Widget Ring-to (via API) in Smartflows ein

Konfigurieren Sie nun Ihren Smartflow mit dem API-Schlüssel, um eine dynamische Weiterleitung zu aktivieren.

Schritte

  1. Navigieren Sie im Aircall Dashboard zu der Smartflows-Nummer, die Sie konfigurieren möchten.

  2. Fügen Sie das Widget Ring-to (via API) an der gewünschten Position im Anruffluss ein.

Hinweis: Nutzer:innen, die über die API weitergeleitet werden, müssen der Rufweiterleitung von Smartflows nicht zugewiesen sein. Wenn sie jedoch zugewiesen sind, erhalten sie Benachrichtigungen über verpasste Anrufe in ihrer To-do-Liste.
  1. Konfigurieren Sie die Request im Widget-Editor:
    • URL: Kopieren Sie die folgende URL und fügen Sie sie ein - https://api.aircall.io/v1/calls/search?direction=outbound&order=desc&phone_number={{callerNumber}}
      • Diese URL sucht nach dem zuletzt getätigten ausgehenden Anruf an die Nummer des aktuellen eingehenden Anrufers und gibt die entsprechende Aircall Nutzer:in zurück.
    • Method: Im Dropdown „Method“ sind POST und GET verfügbar. Stellen Sie sicher, dass Sie GET ausgewählt haben

    • Authentication: Im Dropdown „Authentication“ sind die folgenden Optionen verfügbar - Basic Auth (User & Password), Bearer token, API Key, OAuth und None. Stellen Sie sicher, dass Sie Basic Auth (User & Password) ausgewählt haben

    • Credentials: Wählen Sie Set credentials aus und geben Sie die folgenden Informationen ein -
      • Username = Ihre API ID
      • Password = Ihr API token
  1. Scrollen Sie nach unten und konfigurieren Sie die Response:
    • Response type: Im Dropdown „Response type“ stehen User (ID or email), Team (ID), Aircall number (internal), External number und Dynamic Target (ID) zur Auswahl. Stellen Sie sicher, dass Sie User (ID or email) ausgewählt haben

    • Path: Kopieren Sie Folgendes und fügen Sie es in das Feld „Path“ ein - calls[0].user.id

    • Abschließend müssen Sie im dafür vorgesehenen Feld Test response einen Test für die Antwort ausführen. Dieses Feld akzeptiert ein JSON object, das eine oder mehrere Eingabevariablen enthält, die in Ihrer Request-URL oder im Body verwendet werden.
    • Für dieses Beispiel müssen Sie callerNumber im E.164-Format angeben. Sie können aber auch andere Variablen einfügen, wenn Ihre Konfiguration diese erfordert.
    • Beispiel:
      {
        "callerNumber": "+15551234567"
      }
    • Wenn Sie den Test ausführen, ersetzt das Widget die Variable(n) in Ihrer Anfrage durch die Werte aus dem JSON und zeigt das geparste Ergebnis anhand Ihres konfigurierten Pfads an (calls[0].user.id). Stellen Sie sicher, dass die zurückgegebene Payload die erwarteten Daten enthält, damit das Widget den Anruf korrekt weiterleiten kann.
  1. Passen Sie die Klingeleinstellungen unter dem Testfeld nach Bedarf an Ihre betrieblichen Anforderungen an.
Tipp: Führen Sie immer einen Test aus, um zu prüfen, dass der Pfad eine korrekte Aircall Nutzer-ID zurückgibt.

Optional: Fügen Sie ein Fallback-Team hinzu

Erwägen Sie, nach dem Widget Ring-to (via API) ein Fallback-Team hinzuzufügen, damit keine Anrufe verpasst werden, wenn der letzte Agent nicht verfügbar ist.

Hinweis: Alle Weiterleitungsziele (Nutzer:innen, Teams, Nummern) müssen vorhanden sein, bevor das Widget Ring-to (via API) konfiguriert wird.
Hilfe?
Tipp: Wenn Sie diese Funktion nutzen möchten, aber nicht über das technische Fachwissen verfügen, wenden Sie sich an unser Account-Management-Team. Dieses stellt den Kontakt zu unserem technischen Team her, um Support und Implementierungshinweise bereitzustellen.