Initial Setup & Configuration

Pre-requisites

To enable WhatsApp Calling on a Cloud API number:

• The business must have a messaging limit of at least 1,000 business-initiated conversations per 24h.

• The number must be registered and verified in WhatsApp Business Manager.

Enabling WhatsApp Calling

Enabling WhatsApp Calling for business phone number can be done using either WhatsApp Manager or API endpoint.

Enabling via the WhatsApp Manager

To access it:

1. Click on WhatsApp Accounts

2. Select your WhatsApp Account

3. Click on Phone Numbers

4. Click the gear icon next to the phone number you are using for calling

5. Click the "More" dropdown, then select "Calls"

Enabling it programatically

You can find the phone_number_id by calling the Health Status endpoint, or by navigating to the Client Hub under WhatsApp Channel Section → WABA Channel External ID.

To set it up programmatically, use the following endpoint:

POST https://alpha-beta-onboarding.hub-production.360dialog.io/calling/settings/{phone_number_id} --header 'D360-API-KEY: ••••••'

Request body:

{
  "calling": {
    "status": "ENABLED",
    "call_icon_visibility": "DEFAULT",
    "call_hours": {
      "status": "ENABLED",
      "timezone_id": "America/Manaus",
      "weekly_operating_hours": [
        {
          "day_of_week": "MONDAY",
          "open_time": "0400",
          "close_time": "1020"
        },
        {
          "day_of_week": "TUESDAY",
          "open_time": "0108",
          "close_time": "1020"
        }
      ],
      "holiday_schedule": [
        {
          "date": "2026-01-01",
          "start_time": "0000",
          "end_time": "2359"
        }
      ]
    },
    "callback_permission_status": "ENABLED"
  }
}

Response:

{ "success": true }

Fetch current call settings

Endpoint:

GEThttps://alpha-beta-onboarding.hub production.360dialog.io/calling/settings/{phone_number_id} --header 'D360-API-KEY: ••••••'

Returns the current status, icon visibility, and permission status.

Response Example:

{
  "calling": {
    "status": "ENABLED",
    "call_icon_visibility": "DEFAULT",
    "callback_permission_status": "ENABLED"
  }
}

Call icon behavior

When calling is enabled:

• The call icon appears in chat and business info (for recent contacts or users with the number saved).

• You can hide it using call_icon_visibility = DISABLE_ALL

• Icon updates may take time depending on client versions and contact recency.

Webhook subscription

A new set of Webhook events will be exposed for calling-enabled apps to subscribe to. Those will be received as standard 'messages-related' webhooks.

Webhook events include:

• connect: User-initiated or business-initiated call starting

• terminate: Call ended

• status: For business-initiated (e.g., ringing, accepted, rejected)

Common errors