Skip to main content
This page explains how the per-agent webhook settings fit into the workspace webhook system. For the controls themselves - where they live and how to use them - see Agent Webhooks in Agent Settings.
Think of it as three parts: the agent’s switch and destination pick, the workspace’s named webhooks, and the signing secrets your receivers verify with.

​
DialNexa Agent Webhook Delivery Layers

Each layer has a different owner. Events flow only when all three are in place: the agent’s toggle is on with a destination webhook picked, that webhook is active with a valid URL, and the receiver verifies with the webhook’s signing secret.

​
Agent Webhook Confusions

Check which webhook the agent points at, that webhook’s active state and URL, its signing secret, and your receiver logs. The webhook’s Delivery Ledger shows whether DialNexa attempted delivery.
Check secret rotation and verification code. During a rotation grace window, verify against any configured key.
Point each agent at a different webhook. Events from one agent only reach the single webhook it is attached to.
Confirm which agent version handled the call. The payload’s agent_id identifies the agent on every event.

Agent Settings Webhook

Use the builder toggle.

External Webhooks

Configure receiver URL.

Webhook Secrets

Verify events.