For the complete documentation index, see llms.txt.
Overview
WhatsApp integration lets you process WhatsApp calls/messages with VoxEngine logic and route them to your Voice AI scenarios. Use the integration flow to connect Meta credentials, complete verification, and attach numbers.

Prerequisites
- Meta developer account with a WhatsApp Business app in developers.facebook.com.
- WhatsApp Business phone number added in WhatsApp Manager and ready for verification.
- Meta Cloud API credentials: Temporary Access Token and Phone Number ID.
Inbound
Full inbound setup walkthrough video
Use this step-by-step video to see the full setup in Meta and Voximplant.
Video link: WhatsApp Business Calling setup overview
Setup flow (Inbound)
Prepare WhatsApp Cloud API in Meta
In developers.facebook.com/apps, create a Business app, add
WhatsApp, and open WhatsApp > API Setup.
Keep your Temporary Access Token and Phone Number ID available.

Verify and register the WhatsApp number on the Meta side
In WhatsApp Manager, complete verification and registration on the WhatsApp Cloud API side:
-
In the Profile tab, click Send verification code.

-
Choose how to receive the code (SMS or phone call).

-
Enter the received code and keep it for the registration step.

-
Open the Certificate tab and wait until Display Name status becomes Approved.

-
After approval, register the phone number with the Meta Graph API request shown in the guide/modal.

-
Refresh the phone numbers page and confirm the number status is Connected.

Create Voximplant application
In manage.voximplant.com, create or open an application for this WhatsApp
inbound flow.

Create inbound scenario
Create your inbound scenario (for example whatsapp-inbound) and add the call handling logic.

Connect the WhatsApp number in Voximplant
Open WhatsApp numbers in your application and click Add WhatsApp number.

Follow the modal instructions:

You will need to execute the Meta Graph API requests via cURL.
Then copy the returned password into SIP password, set the WhatsApp number, and click Save.

Create routing rule
Create a routing rule and attach the inbound scenario.
Open your application and go to Routing.

Click Create / New rule. The default mask .* is fine to process all inbound calls.

Outbound specifics
Outbound requires the same setup as inbound. Then you can use VoxEngine.callWhatsappUser() to initiate outbound calling to WhatsApp users from one of your WhatsApp business phone numbers from a scenario.
Outbound video walkthrough:
Video link: Outbound WhatsApp calling walkthrough
More information:
Multi-modal simultaneous voice & messaging support
The WhatsApp integration supports both calls and messages, so you can create multi-modal scenarios that handle voice and text in the same flow. For example, you can answer the call, send a welcome message, then continue with voice prompts and responses.
Architecture
This follows a similar setup procedure as above, but requires an additional server to proxy messages.

Walkthrough and demo
See here for a quick walkthrough and demo of this capability: Video link: Inbound WhatsApp calling demo
Example code
VoxEngine code sample for the WhatsApp multi-modal voice + text flow:
Node.js proxy server code: