Webhook, der nach dem Ende einer Chat-Konversation gesendet wird und Transkript, extrahierte Variablen und Kundendaten enthältDer Conversation Ended Webhook wird automatisch an deine angegebene Webhook-URL gesendet, nachdem eine Chat-Konversation (WhatsApp oder Web Widget) beendet wurde. Dieser Webhook enthält das vollständige Transkript, extrahierte Variablen, Kundeninformationen und Senderdetails.
Webhook-Konfiguration
Um Conversation Ended Webhooks zu aktivieren:- Verwende den API-Endpunkt Enable Conversation Ended Webhook
- Hinterlege deine Webhook-URL, an die Benachrichtigungen gesendet werden
- Konfiguriere optional Post-Call-Variablen in deinem Assistenten, um strukturierte Daten aus Konversationen zu extrahieren
Request-Format
Der Webhook wird als POST-Request an deine konfigurierte URL mit dem folgenden JSON-Payload gesendet:Payload-Struktur
integer
Numerische Kennung der Konversation (dieselbe
id wie in der Dashboard-Konversations-URL). Verwende conversation_id (UUID), wenn du die API aufrufst.string
Eindeutige Kennung (UUID) der Konversation
string
Eindeutige Kennung (UUID) des Assistenten, der die Konversation geführt hat
string
Typ der Konversation. Mögliche Werte:
widget, whatsappinteger
Gesamtanzahl der in der Konversation ausgetauschten Nachrichten
string
Status der Konversation. Wert:
endedobject
Von der KI extrahierte Variablen basierend auf der Post-Call-Schema-Konfiguration deines Assistenten
object
Variablen, die dem Assistenten zu Beginn der Konversation übergeben wurden (z. B. aus Pre-Chat-Formularfeldern oder Automatisierungs-Flows)
array
Array von Nachrichtenobjekten, das die vollständige Konversation abbildet, sortiert von ältest nach neuest
string
Lesbares, formatiertes Transkript mit den Präfixen
AI: und Customer:array
Medien-Dateien (Bilder, Videos, Dokumente), die während der Konversation geteilt wurden. Jeder Eintrag enthält eine direkte URL, die du an externe Dienste weitergeben kannst (z. B. Bild- oder Videoanalyse). Ein leeres Array, wenn keine Medien geteilt wurden — Medien sind typischerweise bei WhatsApp-Konversationen vorhanden.
string
Telefonnummer des Kunden (bei WhatsApp-Konversationen verfügbar, bei Widget-Konversationen
null)string
Kundenname, falls vorhanden (z. B. aus dem Pre-Chat-Formular), sonst
nullobject
WhatsApp-Senderinformationen (nur bei WhatsApp-Konversationen vorhanden, bei Widget
null)string
ISO-8601-Zeitstempel, wann die Konversation gestartet wurde (in der konfigurierten Zeitzone des Nutzers)
string
ISO-8601-Zeitstempel, wann die Konversation beendet wurde (in der konfigurierten Zeitzone des Nutzers)
Retry-Verhalten
Wenn dein Webhook-Endpunkt einen Nicht-2xx-Statuscode zurückgibt oder die Anfrage fehlschlägt, wiederholt das System den Versand:
Nach 3 fehlgeschlagenen Versuchen wird die Webhook-Zustellung als fehlgeschlagen markiert und es erfolgen keine weiteren Retries.
Wichtige Hinweise
conversation_idundassistant_idsind UUIDs, keine Integer-IDs- Das Feld
senderist nur bei WhatsApp-Konversationen befüllt; bei Web-Widget-Konversationen ist esnull customer_phoneist nur bei WhatsApp-Konversationen verfügbarcustomer_namestammt aus Pre-Chat-Formulardaten oder dem Konversationskontext- Zeitstempel verwenden die konfigurierte Zeitzone des Nutzers (ISO-8601-Format)
extracted_variableswerden aus der Post-Call-Schema-Auswertung deines Assistenten befülltinput_variablesenthalten Daten aus Pre-Chat-Formularen (Web Widget) oder Automatisierungs-Flows- Das
attachments-Array listet Medien (Bilder, Videos, Dokumente) auf, die während der Konversation geteilt wurden — jeweils mit einer herunterladbarenurl, nützlich zur Weiterleitung an externe Analyse-Tools. Es ist ein leeres Array, wenn keine Medien geteilt wurden (am häufigsten bei Web-Widget-Konversationen)

