Zur Navigation springen
Integrationen

Webhooks

Geben Sie Ihrem Rezeptionisten benutzerdefinierte Tools, die Ihre HTTP-Endpunkte aufrufen.

Die Integration Webhook Tool stellt Ihre HTTP-Endpunkte als Tools bereit, die Ihr Rezeptionist oder Business Assistant während Unterhaltungen aufrufen kann. Die KI entscheidet anhand der Unterhaltung, wann der Endpunkt aufgerufen wird.

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 ihn verwenden soll.
  3. Parameter, die die KI aus der Unterhaltung erfassen soll.

Wenn während eines Anrufs die Unterhaltung zum Zweck des Tools passt, erfasst Ihr Rezeptionist die Parameter, ruft den Endpunkt auf und verwendet die Antwort, um die Unterhaltung fortzusetzen.

Webhook-Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool. Konfigurieren Sie die folgenden Felder und wählen Sie Enable. Sie können mehrere Webhook-Tools hinzufügen.

FeldBeschreibung
NameTool-Name, den die KI sieht, zum Beispiel check_order_status
DescriptionWann und warum dieses Tool verwendet wird
MethodGET, POST, PUT, PATCH oder DELETE
URLIhr HTTP-Endpunkt
Response timeout (seconds)Wie lange auf Ihren Server gewartet wird: 5–120 Sekunden, Standardwert 20
Assign to agentsReceptionist, Assistant agent oder beide
Disable interruptionsVerhindert Unterbrechungen durch den Anrufer, während das Tool ausgeführt wird
Request HeadersOptionale Header, die mit jeder Anfrage gesendet werden, etwa ein API-Schlüssel
Body ParametersParameter, die im Anfrage-Body gesendet werden
Query ParametersParameter, die als URL-Abfragezeichenfolgen gesendet werden

Parameter

Jeder Parameter hat:

  • Key: der Feldname.
  • Type: string, number oder boolean.
  • Description: welcher Wert von der KI aus der Unterhaltung extrahiert werden soll.
  • Required: ob die KI ihn vor dem Aufruf erfassen muss.

Anwendungsfälle

SzenarioBeschreibungMethode
CRM-AbfrageKundeninformationen in Ihrem System suchenGET
BestandsprüfungProduktverfügbarkeit in Echtzeit prüfenGET
Lead-ErfassungAnruferdaten an Ihr Marketingsystem sendenPOST
Ticket-ErstellungWä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
  • Description: “Prüfen, ob wir die Postleitzahl des Anrufers bedienen und wann der nächste verfügbare Termin ist.”
  • URL: https://api.mybusiness.com/check-area
  • Method: POST
  • Request Headers: Authorization, festgelegt auf den API-Schlüssel des Unternehmens
  • Body Parameters: zip_code (string, erforderlich), service_type (string, erforderlich)

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

Webhook-Tools sind in jedem Tarif verfügbar.