WhatsApp Cloud API

Cloud API Calling

Overview

The WhatsApp Business Calling API enables you to initiate and receive calls with users on WhatsApp using voice-over-internet protocol (VoIP).

Architecture

(Right click image and choose "Open in new tab" for enlarged image)

Get Started

Step 1: Prerequisites

Before you get started with the Calling API, ensure that:

  1. Your business number is in use with Cloud API (not only the SMB app)
  2. Subscribe to the “calls” webhook field (unless you plan to use SIP)
  3. Enable Calling features on your business phone number

Step 2: Configure optional calling features

The WhatsApp Business Calling API offers a number of features that affect when and how calling features appear to users on your WhatsApp profile

  • Inbound call control allows you to prevent users from placing calls from your profile
  • Business call hours allows you to avoid missed calls and direct users to message when your call center is closed
  • Callback requests offer users the option to request a callback when you don’t pick up a call or if your call center is closed

Learn more about call control settings

Step 3: Make and receive calls

Cloud API Calling offers two call initiation paths:

Availability

User-initiated Calling (UIC)

UIC is available in every location Cloud API is available

Business-initiated Calling (BIC)

BIC is currently available in every location Cloud API is available, except the following countries:

  • USA
  • Canada
  • Turkey
  • Egypt
  • Vietnam
  • Nigeria

Note: The business phone number’s country code must be in this supported list. The consumer phone number can be from any country where Cloud API is available.

Next steps

Use our guides below to help you get started with integrating and using calling features in your application: