customer-engagement
common-assets
customer-engagement-webhooks

Conversations Webhook

Webhooks are automated notifications sent between applications when specific events occur. They enable real-time communication by transmitting data through HTTP requests.

Conversations webhooks provide instant access to conversation details and the latest message information, allowing you to manage customer inquiries efficiently. They support real-time integrations to automate workflows for message routing, escalation, and analytics, enhancing operational reporting with comprehensive conversation and message-level metadata.

With these webhooks, you can receive notifications for incoming messages and conversational events through Subscriptions Management.

On our web interface, go to Subscriptions Management → Create subscription. Choose the Customer engagement option in the Channel menu and select the events you want to subscribe to. Additionally, you can use the Subscriptions Management API endpoints to create the wanted subscriptions.

postWebhookconversation-event-webhook

Payload

typestring required

Defines the type of conversation event being delivered.

timestampstring required

Date and time of the event.

Example payload

{
  "timestamp": "2025-10-31T13:47:40.032+00:00"
}

Response

Your server returns this code if it accepts the callback.

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.