Webhook Delivery Monitoring
Monitor the status of webhook deliveries to ensure your integrations are working correctly.
Viewing Delivery Logs
- Navigate to Integrations > Webhooks
- Click on a webhook endpoint
- View the Delivery Log tab
Log Information
Each delivery attempt shows:
| Field | Description |
|---|---|
| Event | The event type |
| Timestamp | When the event occurred |
| Status | Delivered, Failed, or Pending |
| Response Code | HTTP status returned by your server |
| Duration | Time to receive response |
| Attempt | Which retry attempt this was |
Status Indicators
| Status | Meaning |
|---|---|
| Delivered | Successfully delivered (2xx response) |
| Pending | Waiting to deliver or retrying |
| Failed | All retry attempts exhausted |
Retry Logic
When delivery fails, Voxifi retries with exponential backoff:
| Attempt | Delay Before Retry |
|---|---|
| 1st retry | 1 second |
| 2nd retry | 2 seconds |
| 3rd retry | 4 seconds |
| 4th retry | 8 seconds |
| 5th retry | 16 seconds |
After 5 failed attempts, the event is moved to the dead letter queue.
Retry Conditions
- 5xx responses and 429 Too Many Requests are retried
- 4xx responses (other than 429) are treated as permanent failures and go directly to the dead letter queue
Endpoint Health
The webhook detail page shows:
- Last Success — timestamp of most recent successful delivery
- Consecutive Failures — current streak of failed attempts
- Total Failures — lifetime failure count
If consecutive failures accumulate, check your endpoint's availability and response times.
Viewing Failed Deliveries
- Filter the delivery log by Failed status
- Click on a failed delivery to view:
- HTTP status code
- Response body
- Connection error message
Dead Letter Queue
Events that exhaust all retries are moved to the dead letter queue. To review them:
- Go to the webhook in Integrations > Webhooks
- View the Dead Letter Queue section
Rate Limiting
Each endpoint has a default rate limit of 10 requests per minute. Deliveries that exceed this rate are held and delivered as capacity allows.
Common Failure Reasons
| Error | Cause | Solution |
|---|---|---|
| Connection Refused | Server not running | Start your server |
| Timeout | Response took >30s | Optimize endpoint or respond immediately and process async |
| 4xx Response | Client error (e.g., bad signature handling) | Fix endpoint logic |
| 5xx Response | Server error | Check server logs |
| SSL Error | Certificate issue | Fix HTTPS certificate |
Next Steps
- Webhook Security - Verify signatures
- Troubleshooting - Common issues