IVR (Auto Attendant) webhooks
Follow every step of a caller's journey through your IVR menu: when they arrive, which keys they press, where they are sent, and how the call ends.
Where to set it up
- Go to Premium Features > Premium IVR and open the IVR you want to edit.
- Open the Alerts & Webhooks tab.
- In the HTTP webhooks card, turn the webhook switch on.
- Enter your address in Webhook endpoint URL.
- Optional: enter a Webhook HMAC secret (up to 64 characters).
- Click Save alerts & webhooks.
Click Webhook docs on the same tab to see example messages.
Webhooks are independent of the Call completion alerts (email and SMS) on the same page. You can turn either on without the other.
Events you will receive
| Event | When it is sent |
|---|---|
ivr.started | A call has arrived at the IVR. |
ivr.dtmf_received | The caller pressed a key on their keypad. |
ivr.routed | The IVR chose where to send the caller and started connecting them. |
ivr.completed | The call finished normally. |
ivr.abandoned | The caller hung up before the call finished normally. |
Example message
{
"event": "ivr.started",
"account_code": "295327",
"ivr_uuid": "550e8400-e29b-41d4-a716-446655440000",
"call_uuid": "550e8400-e29b-41d4-a716-446655440020",
"status": "received",
"caller_id": "61400111222",
"original_did": "61298786988",
"created_at": "2026-06-07T00:00:00Z"
}Extra details are included in a data section depending on the event:
| Event | Extra details |
|---|---|
ivr.dtmf_received | digit (the key pressed), menu_uuid (which menu), action (what the key does). |
ivr.routed | destination_type and destination (where the caller was sent), final_action. |
ivr.completed | hangup_cause, final_action, total_duration_sec (call length in seconds). |
ivr.abandoned | hangup_cause and dtmf_path, a list of every key the caller pressed before hanging up. |
dtmf_path is useful for spotting where callers give up in your menu.
Security
If you set a secret, each request includes:
X-Crazytel-Signature-256: sha256=<signature>
User-Agent: Crazytel-IVR-Webhook/1.0See Verifying webhook signatures.
Cost
Email alerts and webhooks are included at no platform charge. SMS alerts are billed per segment.