DialNexa Agent Webhooks For API Access

Understand how DialNexa agent webhooks relate to workspace external webhooks, event delivery, agent settings, and receiver verification.

DialNexa agent webhooks control whether a saved agent participates in webhook event delivery. Workspace external webhooks define where events go, webhook secrets define how receivers verify them, and the agent webhook toggle enables or disables event behavior for a specific agent.

Think of it as three parts: agent switch, workspace URL, verification secret.

Webhook Layers

Each layer has a different owner.

Layer	Configured in	Purpose
Agent webhook toggle	Agent Settings	Enable or disable webhook behavior for a saved agent.
External webhook URL	Webhooks tab	Choose where workspace events are delivered.
Webhook secret	Keys tab	Let your receiver verify events.
Delivery logs	Webhook delivery system	Show success, status code, errors, and retries.

Make Agent Events Work End To End

1. Create or rotate webhook secret

   Store it in the receiver.

2. Create external webhook

   Use HTTPS URL, timeout, and retry settings.

3. Enable agent webhook

   Turn on the toggle for the saved agent.

4. Place a test call

   Confirm receiver event and Call History agree.

Agent Webhook Confusions

The agent toggle is on but no event arrives

Check the external webhook URL, active state, secret, and receiver logs.

The receiver rejects events

Check secret rotation and verification code.

The wrong agent triggers events

Confirm which agent version handled the call.

Related Reading

Agent Settings Webhook

Use the builder toggle.

External Webhooks

Configure receiver URL.

Webhook Secrets

Verify events.