Rate this page:

WhatsApp Business-initiated calls

You can make calls from your WhatsApp Business account to your customers in the WhatsApp application with Voximplant.

Please note

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:

  1. Create a Voximplant application or use an existing one.
  2. Create a scenario. In the scenario, use the callWhatsappUser method to call someone from your WhatsApp account. Pass the destination WhatsApp phone number in the number parameter, and pass your WhatsApp Business phone number in the callerid parameter.

See the example below to understand how the callWhatsappUser method works:

Outgoing call from WhatsApp

Outgoing call from WhatsApp

Calls to PSTN phone numbers

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.

  1. 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.

About permissions

You can find more information about call permissions on the Meta's developer website.

  1. Create a routing rule to start the scenario. You can leave the default mask .* to process all calls by the attached scenario.
  2. In your control panel open the SettingsWhatsApp phone numbers section and click the Add a WhatsApp phone number button.
Add a WhatsApp phone number
  1. 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.
Meta commands
  1. Enter your WhatsApp phone number and SIP password that you receive from the API request in the fields below and click Save.

  2. 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.