WhatsApp
Place a WhatsApp call
Place an outbound WhatsApp voice call after the customer has granted permission
POST
Queues an outbound WhatsApp voice call. Your sender’s assistant joins the call when the customer answers.
The customer must have granted call permission and that consent must still be valid. This endpoint will not call a number that never allowed calling.
Rate-limited to 5 requests per minute, 15 per hour, and 30 per day per user. Also limited to 3 attempts per contact every 5 minutes and 5 WhatsApp calls in progress on the same sender.
Request Body
integer
required
WhatsApp sender ID with calling enabled
string
required
Customer phone number in E.164 format
object
Optional variables passed to the assistant (max 20 keys, string values up to 500 characters). Use the same names you configured on the assistant.
Response Fields
boolean
The call was queued
string
Always
queued on success. The call is placed asynchronously.integer
Sender used for the call
string
Normalized E.164 phone number
Error codes
After you queue the call
- A
call_startedevent is sent to the WhatsApp voice webhook when the call is placed - When the call finishes, the assistant’s post-call webhook fires as usual (transcript, duration, extracted variables)
- The response does not include provider call IDs

