How to Configure Calling API

In this documentation, you will learn:

• How to enable WhatsApp Calling via WhatsApp Manager

• How to enable WhatsApp Calling via API

• How to fetch current call settings programmatically

• Which webhook events are triggered when calling is enabled

• How to configure and manage the call icon visibility in the WhatsApp client

• Common errors and troubleshooting tips

Enabling via the WhatsApp Manager

1

Go to 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 programmatically

{
  "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"
  }
}

{ "success": true }

Fetching current call settings

You can also fetch the current call settings following these steps:

{
  "calling": {
    "status": "ENABLED",
    "call_icon_visibility": "DEFAULT",
    "callback_permission_status": "ENABLED",
    "call_hours": {
      "status": "ENABLED",
      "timezone_id": "[REDACTED]",
      "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"
        }
      ]
    },
    "sip": {
      "status": "ENABLED",
      "servers": [
        {
          "hostname": "[REDACTED]",
          "sip_user_password": "[REDACTED]"
        }
      ]
    }
  },
  <Other non-calling feature configuration...>
}

Webhook

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)

Enabling the call icon

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.

Common errors

Please, check the following table with errors and solutions. If you can't find your case, you can contact our Support team:How to get support.