
External Webhook Fields
These fields control event delivery for each webhook.Events And Delivery
Each webhook’s Delivery Ledger shows its full delivery history.Verification
Reachability check sent before a webhook is saved.
Call initiated
Event sent when a call starts.
Call ended
Event sent when a call ends.
Transfer completed
Event sent for completed transfer behavior.
Delivery Ledger
Per-call history with statuses, retries, errors, and payload download.
Create A Webhook Receiver
1
Create a webhook secret
Configure verification before relying on events. Several webhooks can share one secret.
2
Choose Add webhook
Name it after the system it feeds, such as CRM Sync.
3
Enter HTTPS URL and pick the signing secret
Use a stable endpoint under your control and the secret that receiver verifies with.
4
Set timeout and retries
Choose values your receiver can satisfy.
5
Choose whether to verify before saving
Choose Validate & Create to send a
verification POST to your URL and your endpoint must answer with a 2xx status code inside the timeout you set. Anything else blocks creation through this validation action. Create saves without sending the verification request; this does not prove receiver readiness. This payload has no call object, so branch on event_type before reading call fields.6
Attach the webhook to an agent
In the agent editor’s Webhook section, enable the toggle and pick this webhook as the destination. See Agent Webhooks.
7
Trigger a test call
Confirm the receiver gets and verifies the event, then check the webhook’s Delivery Ledger.
Choose Webhook URL Validation
Validate & Create sends a signed verification request and saves only after the receiver returns2xx within the configured timeout. Create saves without probing the URL. The workspace must already have a webhook signing secret.
When editing, Validate & Save and Save provide the same choice; the URL is checked only when it changes. Skipping the probe does not change the webhook’s delivery retries or signing rules. Before relying on a webhook saved without validation, verify an actual delivery in the Delivery Ledger and confirm that your receiver checks its signature.
Delete Rules
Deleting a webhook detaches it from every agent that pointed at it; those agents stop sending events until you attach another webhook. Deleting a webhook does not affect its signing secret, and events already queued for a deleted webhook are skipped rather than delivered.Related Reading
Webhook Secrets
Create, rotate, and delete signing secrets.
Agent Webhooks
Route each agent’s events to a webhook.
Webhook Failures
Debug delivery with the Delivery Ledger.