Skip to main content
Outbound WhatsApp calling is a workspace-gated Beta capability, is only available in supported regions, and requires explicit permission from the recipient. Multi-channel campaigns request permission automatically, show the lead as Awaiting permission, and dial only after permission is granted. A decline or expiry ends that delivery attempt.
The same assistant that answers phone calls can also answer WhatsApp voice calls. Campaign calls receive the lead information and mapped variables configured in the campaign. Product setup (credentials, webhook, toggles, templates): Settings → Channels → WhatsApp — see WhatsApp (Text + Voice). Text and voice use the same WhatsApp connection. For manual setup, subscribe the displayed webhook URL to both messages and calls.

​
What the end user sees

  1. Customer taps call on your WhatsApp Business number (or answers an outbound call).
  2. Normal WhatsApp call UI (ringing → connected).
  3. Your assistant speaks as it does on a phone call.
  4. After hang-up, the call appears in History with its analysis and usage.
There is no custom in-app WhatsApp dialer for the customer — they stay in WhatsApp.

​
What workspace admins will see (product)

Settings → Channels → WhatsApp:
  1. Connect Meta credentials (Phone Number ID + permanent System User token + app secret + verify token + WABA ID), or use Connect with Meta.
  2. Assign an assistant.
  3. Copy the displayed webhook URL for messages, calls, and template-status updates.
  4. Enable voice inbound / outbound toggles (outbound is region-dependent + Meta user permission).
  5. Optional: place a test WhatsApp call from the same panel.
Public API: POST /api/v1/calls/whatsapp-outbound.

​
Apps / accounts you need

  1. Meta Developer account.
  2. WhatsApp Business Account (WABA) with a business phone number.
  3. Voice calling enabled on that number (Cloud API v23/v24).
  4. Meta app with WhatsApp product + permanent System User access token (or Embedded Signup).

​
Meta setup (step by step)

  1. Create / open a Meta app → add WhatsApp.
  2. Under WhatsApp → API Setup, note:
    • Phone number ID
    • Access token (use a long-lived System User token in production)
  3. WhatsApp → Configuration → Webhooks:
    • Callback URL: copy the connector-specific URL shown in Settings
    • Verify token: use the value shown for the connector
    • Subscribe at least to calls (and messages for text)
    • Use API version v23.0 or v24.0 consistently
  4. Enable call permissions:
    • Inbound: configure available call hours (user-initiated calls)
    • Outbound: only in supported regions + explicit user permission

​
Place an outbound call

Start an outbound WhatsApp call from the sender panel, POST /api/v1/calls/whatsapp-outbound, or the start_whatsapp_outbound_call MCP tool. Meta supports business-initiated calling only in eligible regions and after the recipient has granted permission.