Zum Hauptinhalt springen
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 Ihre 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. Verwenden Sie den API-Endpunkt Enable Conversation Ended Webhook
  2. Hinterlegen Sie Ihre Webhook-URL, an die Benachrichtigungen gesendet werden
  3. Konfigurieren Sie optional Post-Call-Variablen in Ihrem Assistenten, um strukturierte Daten aus Konversationen zu extrahieren

​
Request-Format

Der Webhook wird als POST-Request an Ihre konfigurierte URL mit dem folgenden JSON-Payload gesendet:

​
Payload-Struktur

​
conversation_id
string
Eindeutige Kennung (UUID) der Konversation
​
assistant_id
string
Eindeutige Kennung (UUID) des Assistenten, der die Konversation geführt hat
​
type
string
Typ der Konversation. Mögliche Werte: widget, whatsapp
​
message_count
integer
Gesamtanzahl der in der Konversation ausgetauschten Nachrichten
​
status
string
Status der Konversation. Wert: ended
​
extracted_variables
object
Von der KI extrahierte Variablen basierend auf der Post-Call-Schema-Konfiguration Ihres Assistenten
​
input_variables
object
Variablen, die dem Assistenten zu Beginn der Konversation übergeben wurden (z. B. aus Pre-Chat-Formularfeldern oder Automatisierungs-Flows)
​
transcript
array
Array von Nachrichtenobjekten, das die vollständige Konversation abbildet
​
formatted_transcript
string
Lesbares, formatiertes Transkript mit den Präfixen AI: und Customer:
​
customer_phone
string
Telefonnummer des Kunden (bei WhatsApp-Konversationen verfügbar, bei Widget-Konversationen null)
​
customer_name
string
Kundenname, falls vorhanden (z. B. aus dem Pre-Chat-Formular), sonst null
​
sender
object
WhatsApp-Senderinformationen (nur bei WhatsApp-Konversationen vorhanden, bei Widget null)
​
created_at
string
ISO-8601-Zeitstempel, wann die Konversation gestartet wurde (in der konfigurierten Zeitzone des Nutzers)
​
ended_at
string
ISO-8601-Zeitstempel, wann die Konversation beendet wurde (in der konfigurierten Zeitzone des Nutzers)
{
  "conversation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assistant_id": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
  "type": "widget",
  "message_count": 8,
  "status": "ended",
  "extracted_variables": {
    "status": true,
    "summary": "Customer asked about pricing plans and was interested in the Pro plan"
  },
  "input_variables": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "transcript": [
    {
      "role": "assistant",
      "content": "Hi! How can I help you today?"
    },
    {
      "role": "user",
      "content": "I have a question about your service."
    },
    {
      "role": "assistant",
      "content": "Of course! I'd be happy to help. What would you like to know?"
    },
    {
      "role": "user",
      "content": "What are your pricing plans?"
    }
  ],
  "formatted_transcript": "AI: Hi! How can I help you today?\nCustomer: I have a question about your service.\nAI: Of course! I'd be happy to help. What would you like to know?\nCustomer: What are your pricing plans?",
  "customer_phone": null,
  "customer_name": "John Doe",
  "sender": null,
  "created_at": "2026-02-23T09:30:00+01:00",
  "ended_at": "2026-02-23T10:00:00+01:00"
}

​
Retry-Verhalten

Wenn Ihr Webhook-Endpunkt einen Nicht-2xx-Statuscode zurückgibt oder die Anfrage fehlschlägt, wiederholt das System den Versand:
VersuchVerzögerung
1. Retry30 Sekunden
2. Retry60 Sekunden
3. Retry120 Sekunden
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 Ihres Assistenten befüllt
  • input_variables enthalten Daten aus Pre-Chat-Formularen (Web Widget) oder Automatisierungs-Flows