Skip to main content
A webhook sends call data to your system through a POST request. A call can finish successfully even if delivery to your endpoint fails.

​
Configure and test

1

Prepare your receiver

Create a reachable URL that accepts POST JSON. If you start calls through the API, store their IDs to correlate them with your system.
2

Publish the agent URL

Open Voice agent → Advanced → Post-call, configure the outgoing webhook, and publish. The inbound webhook retrieves context and has a different contract.
3

Make a controlled call

Use Test agent and wait for analysis. If evaluation criteria are assigned, delivery can wait for their results.
4

Compare delivery and action

Inspect the body in your receiver and Calls → Webhooks. Also confirm that the expected task, ticket, or update completed.
The current editor has no sample-payload button. Test calls can execute real actions in your receiver.

​
What you receive

The body has a data object containing agent, organization, call, and available context. Contact and campaign blocks depend on the record. A web test can have a contact when it was registered with email.

Payload fields and examples

Explore objects and select a JSON example by call type.

Call types

Distinguish tests, API calls, campaigns, inbound calls, and widgets.

​
Investigate delivery

Open an event in Calls → Webhooks to inspect its URL, status, attempts, HTTP response, raw data, and associated call. Store data.call.call_id in your receiver. The event ID shown in the app helps diagnostics but is not automatically included in the body. Make your receiver tolerate repeated deliveries: a retry must not create duplicate tickets or repeat an operation. These deliveries are separate from messaging channel webhooks, inbox automations, and lead-routing events. Each has its own configuration and content.

​
Frequently asked questions

No. It retries event delivery. Your receiver may repeat actions unless it handles duplicates.
No. The inbound webhook obtains context before the conversation; the outgoing webhook delivers call information.
The event ID, call ID, date, and HTTP response, with receiver secrets removed.

​
See also