Copy page

Voice Channels

WhatsApp Business Calling API Integration

Introduction

The WhatsApp Business Calling API enables businesses to initiate and receive voice calls with WhatsApp users using Voice over VoIP. Unlike traditional Cloud API messaging workflows that rely on Graph API endpoints and webhooks, WhatsApp Calling supports SIP (Session Initiation Protocol) as the signaling protocol for voice communication.

---

Setup

Prerequisites and Account Setup

Before configuring WhatsApp Calling, ensure the following prerequisites are met:

Account Requirements

Application Requirements

Before configuring SIP signaling:

• Ensure all WhatsApp Calling prerequisites are satisfied.
• Verify that the application has messaging permissions for the target business phone number.
• Validate messaging functionality by sending and receiving messages through the Graph API.
• Use the same application for SIP configuration.
• Verify the phone number status using the Health Status API.
• Ensure the application mode is set to Live (not Development).

---

User-Initiated Calls

User-initiated calls are calls placed by a WhatsApp user to your business.

Configuration Steps

Enable and configure SIP on the business phone number.

Example API Request

Code
curl 'https://graph.facebook.com/v23.0/<Unique-ID-of-the-Registered-Number>/settings' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H "Content-Type: application/json" \
-d '{
  "messaging_product":"whatsapp",
  "calling":{
    "status":"ENABLED",
    "call_icon_visibility":"DEFAULT",
    "callback_permission_status":"ENABLED",
    "srtp_key_exchange_protocol":"SDES",
    "sip":{
      "status":"ENABLED",
      "servers":[
        {
          "hostname":"<iravoice-host>",
          "port":<iravoice-port>
        }
      ]
    }
  }
}'

---

Business-Initiated Calls

Business-initiated calls are calls placed by your business to a WhatsApp user.

Requirements

• Ensure that the user has granted calling permission to the business.
• The account owner must retrieve the Meta-generated SIP password.

To enable Outbound WhatsApp Calls via IraVoice, Epicode team will configure the SIP password on the SIP server to respond to Meta's digest authentication challenges.

---