> ## 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 Webhook Retries And Failures

> Troubleshoot DialNexa webhook retries and failures with retry count, timeout, response status, success flag, error messages, retry attempts, and delivery logs.

DialNexa webhook retries and failures are controlled by the workspace webhook configuration and recorded in delivery logs. Logs can show event type, response status, success flag, error message, delivery time, retry attempt, parent delivery, and related call id.

<Warning>
  A webhook can fail even when the call succeeded. Do not confuse event delivery with call outcome.
</Warning>

## Delivery Log Fields

Use these fields to find the failing layer.

| Field                | Meaning                                               |
| -------------------- | ----------------------------------------------------- |
| event                | call\_initiated, call\_ended, or transfer\_completed. |
| response\_status     | HTTP status returned by the receiver.                 |
| is\_success          | Whether DialNexa considered delivery successful.      |
| error\_message       | Failure detail from delivery attempt.                 |
| retry\_attempt       | Attempt count for retry deliveries.                   |
| parent\_delivery\_id | Connects retry attempts to the original delivery.     |
| call\_id             | Call related to the event when available.             |

## Common Failure Causes

Most failures come from receiver behavior or verification mismatch.

<CardGroup cols={2}>
  <Card title="Non-2xx response" icon="alert-triangle" href="/reference/troubleshooting">
    Fix receiver status handling.
  </Card>

  <Card title="Timeout" icon="timer" href="/api-access/external-webhooks">
    Increase timeout or make receiver faster.
  </Card>

  <Card title="Secret mismatch" icon="key-round" href="/api-access/webhook-secrets">
    Update receiver after rotating webhook secret.
  </Card>

  <Card title="URL problem" icon="link" href="/api-access/external-webhooks">
    Use HTTPS and keep URL within the dashboard limit.
  </Card>
</CardGroup>

## Debug A Failed Delivery

<Steps>
  <Step title="Check the event and call id">
    Confirm which call and event failed.
  </Step>

  <Step title="Read response status and error">
    Decide whether receiver, timeout, or secret verification failed.
  </Step>

  <Step title="Check retry count">
    Know whether DialNexa will try again.
  </Step>

  <Step title="Fix receiver or secret">
    Deploy receiver changes or update the stored secret.
  </Step>

  <Step title="Trigger a test event">
    Confirm the next delivery succeeds.
  </Step>
</Steps>

## Related Reading

<CardGroup cols={2}>
  <Card title="External Webhooks" icon="webhook" href="/api-access/external-webhooks">
    Set URL and retry behavior.
  </Card>

  <Card title="Webhook Secrets" icon="key-round" href="/api-access/webhook-secrets">
    Fix verification.
  </Card>

  <Card title="Call History" icon="activity" href="/monitoring/call-history">
    Separate call outcome from event delivery.
  </Card>
</CardGroup>