Sign in
Webhooks

pre-conversation

Fired before the agent begins speaking. Use this to enrich CRM data, log call attempts, or gate outbound calls.

Does not contain callData, transcript, variables, analytics, or recordingUrl. callData is on post-conversation and analytics-completed; transcript, variables, and recordingUrl are only on post-conversation; analytics is only on analytics-completed.

For the full field-level reference, see the Webhooks guide.

post/webhook-events/pre-conversation

Request body

urlstring required

The webhook URL endpoint that received the event.

descriptionstring required

Human-readable label configured on the webhook (e.g. "Debt Collection Agent's Endpoint").

eventstring required

Event identifier in the form {agentId}.{eventType}.

idstring required

Unique webhook delivery ID (separate from metadata.callId).

Example request

{
  "url": "https://example.com/webhook",
  "event": "69fc7dd072a0c1d28d948ace.post-conversation",
  "id": "69fd96118fd277fc807e4c23",
  "metadata": {
    "agentId": "69fc7dd072a0c1d28d948ace",
    "eventType": "pre-conversation",
    "conversationType": "telephonyOutbound",
    "toPhone": "+916296641821",
    "fromPhone": "+918035317096",
    "callId": "CALL-1778226705739-7e4c17"
  }
}

Response

Your endpoint should return a 2XX status to acknowledge receipt.

Changes