Zur Navigation springen
Integrationen

Webhooks

Geben Sie Ihrer Rezeption benutzerdefinierte Tools, die Ihre HTTP-Endpunkte aufrufen.

Die Integration Webhook-Tool stellt Ihre HTTP-Endpunkte als Tools bereit, die Ihre Rezeption oder Ihr Geschäftsassistent während Gesprächen aufrufen kann. Die KI entscheidet anhand des Gesprächs, wann sie den Endpunkt aufruft.

So funktionieren Webhook-Tools

Wenn Sie ein Webhook-Tool erstellen, definieren Sie:

  1. Einen aufzurufenden HTTP-Endpunkt.
  2. Eine Beschreibung seiner Funktion, damit die KI weiß, wann sie es verwenden soll.
  3. Parameter, die die KI aus dem Gespräch erfassen soll.

Wenn ein Gespräch dem Zweck des Tools entspricht, erfasst Ihre Rezeption während eines Anrufs die Parameter, ruft den Endpunkt auf und nutzt die Antwort, um das Gespräch fortzusetzen.

Ein Webhook-Tool erstellen

Gehen Sie zu Integrationen, wählen Sie Integration hinzufügen und dann Webhook-Tool. Konfigurieren Sie die folgenden Felder und wählen Sie Aktivieren. Sie können mehrere Webhook-Tools hinzufügen.

FeldBeschreibung
NameTool-Name, den die KI sieht, zum Beispiel check_order_status
BeschreibungWann und warum dieses Tool verwendet werden soll
MethodeGET, POST, PUT, PATCH oder DELETE
URLIhr HTTP-Endpunkt
Antwort-Timeout (Sekunden)Wie lange auf Ihren Server gewartet wird: 5–120 Sekunden, standardmäßig 20
Agenten zuweisenRezeption, Assistenten-Agent oder beides
Unterbrechungen deaktivierenVerhindert, dass der Anrufer unterbricht, während das Tool ausgeführt wird
Anfrage-HeaderOptionale Header, die mit jeder Anfrage gesendet werden. Typ ist Wert oder Secret. Ein Secret wird verschlüsselt gespeichert und nie wieder angezeigt. Ein von ElevenAgents übernommener Header kann Umgebungsvariable oder Variable anzeigen, mit dem Hinweis, dass er auf der Agentenplattform festgelegt ist.
PfadparameterWerden angezeigt, wenn die URL Platzhalter in geschweiften Klammern enthält, etwa /orders/{order_id}. Bearbeiten Sie die URL, um einen hinzuzufügen oder zu entfernen.
Body-ParameterParameter, die im Anfrage-Body gesendet werden. Wert kann Aus dem Gespräch oder ein Fester Wert sein.
AbfrageparameterParameter, die als URL-Abfragezeichenfolgen gesendet werden. Wert kann Aus dem Gespräch oder ein Fester Wert sein.

Parameter

Jeder Parameter hat:

  • Schlüssel: den Feldnamen.
  • Typ: string, number oder boolean.
  • Beschreibung: Welchen Wert die KI aus dem Gespräch extrahieren soll.
  • Erforderlich: ob die KI ihn vor dem Aufruf erfassen muss.

Anwendungsfälle

SzenarioBeschreibungMethode
CRM-AbfrageKundeninformationen in Ihrem System nachschlagenGET
BestandsprüfungProduktverfügbarkeit in Echtzeit prüfenGET
Lead-ErfassungAnruferdaten an Ihr Marketingsystem sendenPOST
Ticket erstellenWährend des Anrufs ein Support-Ticket erstellenPOST
PreisangebotEin individuelles Angebot anhand der Anforderungen des Anrufers berechnenPOST

Beispiel

Ein Sanitärbetrieb erstellt ein Webhook-Tool:

  • Name: check_service_area
  • Beschreibung: “Prüfen, ob wir die Postleitzahl des Anrufers bedienen und wann der nächste freie Termin ist.”
  • URL: https://api.mybusiness.com/check-area
  • Methode: POST
  • Anfrage-Header: Authorization ist auf den API-Schlüssel des Unternehmens gesetzt
  • Body-Parameter: zip_code (string, erforderlich), service_type (string, erforderlich)

Wenn ein Anrufer nach einem Service in seiner Region fragt, erfasst die Rezeption seine Postleitzahl, ruft den Webhook auf und teilt ihm das Ergebnis mit.

Webhook-Tools sind in jedem Tarif verfügbar.