Call webhooks: send your calls to your own system

Last updated: 9 October 2026 · 4 min read

Steps

1. 1

   Tick the call events

   On the Settings › Workspace settings › Integrations page, click “Configure” on the “Webhook” card, then “Add new webhook”. Enter the “Webhook URL” (HTTPS) and tick the events you need under “Calls”. Click “Create webhook” and copy the secret: you verify the signature with it. To add the events to an existing webhook, click “Edit” next to it. Other webhooks do not change; a call event goes only to the webhooks it is ticked on.

2. 2

   Which event comes when

   • “Call started” (call_started): an incoming call rings, or an agent places a call.
   • “Call answered” (call_answered): the call is picked up in the dashboard, the app or on the phone.
   • “Call ended” (call_ended): with the duration, the outcome and who hung up.
   • “Call recording ready” (call_recording_ready): with a link to the recording, the transcript and the summary.

   Each event comes once per call. More in “Call webhooks: events and when they arrive”.

3. 3

   Good to know

   • Your server should answer with 2xx within 5 seconds. If it does not, Clomni retries the delivery up to 5 attempts, with the same delivery_id.
   • For a WhatsApp (QR) call answered on the phone, the duration comes from the phone's call log. If the log does not arrive within 10 minutes, “Call ended” comes without a duration, with duration_known: false.
   • A summary is made only for answered calls longer than 10 seconds.
   • Check that a request really comes from Clomni with the secret and the X-ChatX-Signature header.
4. 4

   Full guide

   • PDF: Call webhooks guide, in Azerbaijani and English: example requests, every field, signature checks and the differences between services.
   • In the dashboard: “Guide (PDF)” next to “Calls” in the webhook form.
   • Separate articles: events, request fields, the signature, delivery and retries, differences between services, troubleshooting.