WhatsApp Business-initiated calls
You can make calls from your WhatsApp Business account to your customers in the WhatsApp application with Voximplant.
Business-initiated Calling is currently available in every location Cloud API is available, except the following countries: USA, Canada, Turkey, Egypt, Vietnam, Nigeria.
To make a call from your WhatsApp Business account:
- Create a Voximplant application or use an existing one.
- Create a scenario. In the scenario, use the
callWhatsappUser
method to call someone from your WhatsApp account. Pass the destination WhatsApp phone number in thenumber
parameter, and pass your WhatsApp Business phone number in thecallerid
parameter.
See the example below to understand how the callWhatsappUser
method works:
WhatsApp calls cannot be connected to PSTN according to the WhatsApp Business Calling API terms of service, so use of both PSTN and WhatsApp calls in the same scenario is prohibited.
- To accept calls from your WhatsApp Business account, your customers need to give you permission to make calls. You can receive the permission in two ways:
Send a template request to the customer you want to call.
If the customer has called you before, you get a temporary call permission for 7 days.
If your customer has your WhatsApp Business account in their contact list, they can tap the header bar to open the contact settings and allow or deny the permission to call.
You can find more information about call permissions on the Meta's developer website.
- Create a routing rule to start the scenario. You can leave the default mask
.*
to process all calls by the attached scenario. - In your control panel open the Settings → WhatsApp phone numbers section and click the Add a WhatsApp phone number button.

- Follow the instructions that appear on the screen. During the phone number connection, you need to execute two API requests to the Meta Graph API.

Enter your WhatsApp phone number and SIP password that you receive from the API request in the fields below and click Save.
Open your application and choose the WhatsApp numbers section from the menu on the left. Add an available WhatsApp phone number to attach it to your application.