Skip to main content
DialNexa external webhooks send real-time call events to HTTPS endpoints you control. A workspace can hold several named webhooks, each with its own URL, signing secret, retry count, and request timeout. Manage them under Workspace Settings, Developer, Webhooks, and point each agent at the webhook its events should reach.
The webhook URL must start with https://. Webhooks are not the place to experiment with almost-secure endpoints.
DialNexa workspace Webhooks tab showing named webhooks, attached signing secrets, active status, last delivery time, and the Signing secrets table.

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 returns 2xx 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.

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.