WhatsApp
Request call permission
Send a WhatsApp Voice Call Request (Ask to call) to a customer
POST
Sends the sender’s approved Voice Call Request template so the customer can Allow or Decline WhatsApp calls.
This endpoint will not send the request if the 24-hour chat window is closed. That protects your WhatsApp quota: a request sent to a brand-new number is not delivered, but still counts as your one ask for the day.
Rate-limited to 5 requests per minute, 20 per hour, and 50 per day per user. WhatsApp typically allows 1 ask per contact every 24 hours and 2 per week. Those WhatsApp counters reset after a connected call.
Request Body
Optional Voice Call Request template ID. If omitted, the sender’s approved voice-call template is used.
Response Fields
Same shape as Get call permission, plussuccess.
Error codes
Recommended flow
- Send a regular template if there is no open chat
- Wait for the customer to reply (or poll session status)
- Call this endpoint
- Listen for
call_permission_grantedon the voice webhook - Place the call

