WhatsApp Voice Webhook

We POST compact WhatsApp calling events when a contact is asked to allow calls, answers that request, or a WhatsApp call starts.

This is how you listen for "they allowed the call" without polling.

Completed WhatsApp calls still use the post-call webhook. Inbound WhatsApp calls that your assistant answers also follow the assistant's inbound webhook, if you have one.

Event types

Payload

Every voice event is a small JSON object. It does not include provider IDs, trunks, recordings, transcripts, or costs.

{
  "event": "whatsapp_voice",
  "type": "call_permission_granted",
  "sender_id": 12,
  "customer_phone": "+40711222333",
  "conversation_id": "9c2e1d4a-6b8f-4c11-9a0e-1f2d3c4b5a67",
  "assistant_id": "b7e2c1aa-11d0-4f3a-9c44-0d8e7f6a5b21",
  "status": "granted",
  "expires_at": "2026-08-22T10:15:00+00:00",
  "can_call": true
}

{
  "event": "whatsapp_voice",
  "type": "voice_call",
  "sender_id": 12,
  "customer_phone": "+40711222333",
  "conversation_id": "9c2e1d4a-6b8f-4c11-9a0e-1f2d3c4b5a67",
  "assistant_id": "b7e2c1aa-11d0-4f3a-9c44-0d8e7f6a5b21",
  "status": "granted",
  "expires_at": "2026-08-22T10:15:00+00:00",
  "can_call": true,
  "call_id": 18402,
  "direction": "whatsapp_outbound"
}

Typical automation

1. Customer replies to your template (24-hour window opens)
2. You request permission
3. Your server receives call_permission_granted
4. You place the call
5. You receive voice_call, then later the post-call webhook

If you never receive call_permission_granted, the customer declined, ignored the card, or the ask never delivered. Check Get call permission and WhatsApp Calling.

Delivery

• POST JSON, 10 second timeout, up to 3 retries
• Respond with HTTP 2xx so we do not retry
• Ignore events whose event is not whatsapp_voice if you also use this URL for new conversations