Skip to main content
Webhook, der nach dem Ende einer Chat-Konversation gesendet wird und Transkript, extrahierte Variablen und Kundendaten enthält
Der 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:
  1. Verwende den API-Endpunkt Enable Conversation Ended Webhook
  2. Hinterlege deine Webhook-URL, an die Benachrichtigungen gesendet werden
  3. 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, whatsapp
integer
Gesamtanzahl der in der Konversation ausgetauschten Nachrichten
string
Status der Konversation. Wert: ended
object
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 null
object
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_id und assistant_id sind UUIDs, keine Integer-IDs
  • Das Feld sender ist nur bei WhatsApp-Konversationen befüllt; bei Web-Widget-Konversationen ist es null
  • customer_phone ist nur bei WhatsApp-Konversationen verfügbar
  • customer_name stammt aus Pre-Chat-Formulardaten oder dem Konversationskontext
  • Zeitstempel verwenden die konfigurierte Zeitzone des Nutzers (ISO-8601-Format)
  • extracted_variables werden aus der Post-Call-Schema-Auswertung deines Assistenten befüllt
  • input_variables enthalten 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 herunterladbaren url, 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)