> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Voice

> How WhatsApp calling works on the platform — setup and product UX

<Warning>
  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.
</Warning>

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)](/channels/whatsapp).

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](https://developers.facebook.com/) 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.

## Related

* [WhatsApp (Text + Voice)](/channels/whatsapp)
* [Messaging channels](/channels/messaging)
* [Phone numbers](/telephony/phone-numbers)
* [Campaigns](/campaigns/overview)