Webhooks

Conversation Ended Webhook

Webhook sent after a chat conversation ends containing transcript, extracted variables, and customer data

Docs

postWebhookconversation-ended

Payload

idinteger

Numeric identifier of the conversation (the same id shown in the dashboard conversation URL). Use conversation_id (UUID) when calling the API.

conversation_idstring

Unique identifier (UUID) of the conversation

assistant_idstring

Unique identifier (UUID) of the assistant that handled the conversation

type'widget' | 'whatsapp'

The type of conversation. Possible values: widget, whatsapp

message_countinteger

Total number of messages exchanged in the conversation

statusstring

Status of the conversation. Value: ended

input_variablesobject

Variables that were passed to the assistant at the start of the conversation (e.g., from pre-chat form fields or automation flows)

formatted_transcriptstring

Human-readable formatted transcript with AI: and Customer: prefixes

customer_phonestring nullable

Customer phone number (available for WhatsApp conversations, null for widget conversations)

customer_namestring

Customer name if provided (e.g., from pre-chat form), or null

created_atstring

ISO 8601 timestamp when the conversation started (in the user's configured timezone)

ended_atstring

ISO 8601 timestamp when the conversation ended (in the user's configured timezone)

Response

Bestätige den Empfang mit 2xx. Antwortet dein Endpunkt nicht mit 2xx, wiederholt Famulor die Zustellung.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.