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.

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](/atoms/atoms-platform/features/webhooks).

Payload

The payload of this webhook request is an object.

urlstringRequired

The webhook URL endpoint that received the event.

descriptionstringRequired

Human-readable label configured on the webhook (e.g. “Debt Collection Agent’s Endpoint”).

eventstringRequired

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

idstringRequired

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

metadataobjectRequired

Response

2XX

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

1	{
2	"url": "https://example.com/webhook",
3	"description": "string",
4	"event": "69fc7dd072a0c1d28d948ace.post-conversation",
5	"id": "69fd96118fd277fc807e4c23",
6	"metadata": {
7	"agentId": "69fc7dd072a0c1d28d948ace",
8	"eventType": "pre-conversation",
9	"conversationType": "telephonyOutbound",
10	"toPhone": "+916296641821",
11	"fromPhone": "+918035317096",
12	"callId": "CALL-1778226705739-7e4c17"
13	}
14	}