> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# DialNexa External Webhooks

> Configure DialNexa external webhooks with HTTPS URL, retry count, timeout, active state, webhook secret, delivery attempts, and deletion.

DialNexa external webhooks send real-time events to a workspace HTTPS endpoint. The Webhooks page lets users create or update a URL, set retry count from 0 to 3, set request timeout from 1,000 ms to 60,000 ms, view active state, and delete the webhook.

<Warning>
  The webhook URL must start with `https://`. Webhooks are not the place to experiment with almost-secure endpoints.
</Warning>

## External Webhook Fields

These fields control event delivery.

| Field                         | Requirement or behavior                                                           |
| ----------------------------- | --------------------------------------------------------------------------------- |
| URL                           | Required, must use `https://`, and must be 150 characters or less.                |
| Retry count                   | Must be between 0 and 3.                                                          |
| Request timeout               | Must be between 1,000 ms and 60,000 ms.                                           |
| Active state                  | Shows whether delivery is active. A missing secret can make the webhook inactive. |
| Last delivery and status code | Used to understand recent delivery behavior.                                      |

## Events And Delivery

Webhook delivery records help debug receivers.

<CardGroup cols={2}>
  <Card title="Call initiated" icon="phone-call" href="/api-access/webhook-retries-and-failures">
    Event sent when a call starts.
  </Card>

  <Card title="Call ended" icon="phone-off" href="/api-access/webhook-retries-and-failures">
    Event sent when a call ends.
  </Card>

  <Card title="Transfer completed" icon="phone-forwarded" href="/calls/call-transfer">
    Event sent for completed transfer behavior.
  </Card>

  <Card title="Delivery logs" icon="activity" href="/api-access/webhook-retries-and-failures">
    Record response status, success flag, retry attempt, and errors.
  </Card>
</CardGroup>

## Create A Webhook Receiver

<Steps>
  <Step title="Create a webhook secret">
    Configure verification before relying on events.
  </Step>

  <Step title="Enter HTTPS URL">
    Use a stable endpoint under your control.
  </Step>

  <Step title="Set timeout and retries">
    Choose values your receiver can satisfy.
  </Step>

  <Step title="Create or update webhook">
    Watch the active badge.
  </Step>

  <Step title="Trigger a test call">
    Confirm the receiver gets and verifies the event.
  </Step>
</Steps>

## Related Reading

<CardGroup cols={2}>
  <Card title="Webhook Secrets" icon="key-round" href="/api-access/webhook-secrets">
    Verify events.
  </Card>

  <Card title="Agent Webhooks" icon="bell" href="/api-access/agent-webhooks">
    Enable events for agents.
  </Card>

  <Card title="Webhook Failures" icon="refresh-cw" href="/api-access/webhook-retries-and-failures">
    Debug delivery.
  </Card>
</CardGroup>