Webhooks

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

Webhook-Integrationen stellen individuelle HTTP-Endpunkte als Tools bereit, die die Rezeption oder der Geschäftsassistent während Gesprächen aufrufen kann. Anders als passive Benachrichtigungssysteme ruft die KI diese Endpunkte aktiv auf, wenn der Gesprächskontext es erfordert.

So funktionieren Webhook-Tools

Beim Erstellen einer Webhook-Integration definieren Sie:

  1. Einen HTTP-Endpunkt, den Ihre Rezeption aufrufen kann
  2. Eine Beschreibung seiner Funktion, damit die KI weiß, wann sie ihn nutzen soll
  3. Parameter, die die KI aus dem Gespräch erfassen soll

Wenn ein Gespräch während eines Anrufs zum Zweck des Tools passt, ruft Ihre Rezeption den Endpunkt auf, verarbeitet die Antwort und führt das Gespräch fort.

Webhook-Tool erstellen

  1. Gehen Sie zu Integrationen → klicken Sie auf Webhook
  2. Klicken Sie auf Webhook hinzufügen
  3. Konfigurieren Sie:
FeldBeschreibung
NameTool-Name, den die KI intern sieht
BeschreibungWann und warum dieses Tool verwendet wird (hilft der KI bei der Entscheidung)
URLIhr HTTP-Endpunkt
MethodeGET, POST, PUT, PATCH oder DELETE
Body-ParameterParameter, die im Anfrage-Body gesendet werden
AbfrageparameterParameter, die als URL-Abfragezeichenfolgen gesendet werden
Antwort-TimeoutWartezeit auf Ihren Server (Sekunden)
Unterbrechungen deaktivierenVerhindert Unterbrechungen durch Anrufer während der Tool-Ausführung
AgentenzieleWelche Agenten dieses Tool nutzen können

Parameter

Jeder Parameter hat:

  • Schlüssel — Der Feldname
  • Typ — string, number oder boolean
  • Beschreibung — Welchen Wert die KI aus dem Gespräch extrahieren soll
  • Erforderlich — Ob die KI diesen Wert vor dem Aufruf erfassen muss

Agentenziele

Weisen Sie jedes Webhook-Tool zu an:

  • Kundenorientierte Rezeption — Während Telefonaten verfügbar
  • Geschäftsassistent — Im Dashboard-Chat verfügbar
  • Beide — Überall verfügbar

Anwendungsfälle

SzenarioBeschreibungMethode
CRM-AbfrageKundendaten in Ihrem System nachschlagenGET
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: “Verfügbarkeit im Gebiet prüfen”
  • Beschreibung: “Prüfen, ob wir die Postleitzahl des Anrufers bedienen und wann der nächste Termin verfügbar ist”
  • URL: https://api.mybusiness.com/check-area
  • Methode: POST
  • Parameter: zip_code (string, erforderlich), service_type (string, erforderlich)

Wenn jemand während eines Anrufs nach der Verfügbarkeit in seinem Gebiet fragt, erfasst die Rezeption die Postleitzahl, ruft den Webhook auf und teilt das Ergebnis mit.

Webhook-Integrationen erfordern den Tarif Basic oder höher.