> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Understand WhatsApp Calling, its requirements, pricing, and setup options in YCloud.

WhatsApp Calling is a voice calling (VoIP) capability provided by the WhatsApp Business Cloud API. It lets businesses have real-time voice conversations with customers directly in WhatsApp.

YCloud supports two call types:

* **Inbound calls:** customers call your business.
* **Outbound calls:** your business calls customers after receiving permission.

## Billing

#### Inbound calls

Inbound calls are free, whether or not your business answers.

#### Outbound calls

* Charges are based on the connected duration.
* One billing unit is 6 seconds. Any partial unit is rounded up.
* The rate depends on the country code of the customer's phone number.

For example, if the rate for Indonesia is USD 0.0242 per minute and a connected call lasts 9 seconds:

**Billing = 2 units × USD 0.0242 ÷ 10 = USD 0.00484**

See [WhatsApp Calling pricing](https://www.ycloud.com/pricing#price-table) for current country-level rates.

## User-initiated calls (inbound)

Customers can start a call in three ways.

#### 1. Call button in WhatsApp

Enable the call icon for your business number so customers can call from the conversation or business profile.

<img src="https://mintcdn.com/lchnan/NjO13A6gLJKR9m7M/product-assets/8285b84010-image-55.webp?fit=max&auto=format&n=NjO13A6gLJKR9m7M&q=85&s=c6c4772d087833a93a5f97c96789934d" alt="YCloud product screenshot" width="1280" height="658" data-path="product-assets/8285b84010-image-55.webp" />

#### 2. Call-in link

Generate a call-in link and place it on your website, in an email, or in a WhatsApp message.

<img src="https://mintcdn.com/lchnan/Z2X3BzyqaivSGKDr/product-assets/7070f537ba-image-56.webp?fit=max&auto=format&n=Z2X3BzyqaivSGKDr&q=85&s=32c7f6d972ed927bdad2708b3decfc5b" alt="YCloud product screenshot" width="1097" height="679" data-path="product-assets/7070f537ba-image-56.webp" />

#### 3. Call-in button in a message

Add a call-in button to a message template or interactive message.

<img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/a272b1bd25-image-57.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=cf87720cd3304e595f3d2f857e529c50" alt="YCloud product screenshot" width="1280" height="828" data-path="product-assets/a272b1bd25-image-57.webp" />

## Business-initiated calls (outbound)

Before using outbound WhatsApp Calling, your business account must meet these requirements:

1. The Business Portfolio messaging limit has reached the 2,000-customer tier.
2. The business number's registered country or region is not:
   * United States (+1)
   * Canada (+1)
   * Türkiye (+90)
   * Egypt (+20)
   * Vietnam (+84)
   * Nigeria (+234)

Businesses must obtain customer permission before initiating a call. Permission can be requested with a Calling Request template message or an interactive message. After the customer selects **Allow**, the business can call while the permission remains valid.

<img src="https://mintcdn.com/lchnan/WD-ixrYVrqB7b7aQ/product-assets/47f902e6d1-image-58.webp?fit=max&auto=format&n=WD-ixrYVrqB7b7aQ&q=85&s=3a1b18a3b80f6c240c28f12f772db086" alt="YCloud product screenshot" width="1280" height="678" data-path="product-assets/47f902e6d1-image-58.webp" />

## Choose an integration method

YCloud supports two ways to use WhatsApp Calling. Choose the method that matches your implementation.

#### HTTPS API integration

To build inbound or outbound calling with the API, contact your YCloud representative to enable Calling. See the [WhatsApp Calling API example](/api-reference/whatsapp-calling/connect-a-call).

#### YCloud platform (recommended)

Use the Calling workspace in the YCloud console for agent-based calling.

## Enable Calling for a business number

Each business number can enable or disable Calling independently.

Go to **WhatsApp accounts**, open the settings for the business number, and select **Calling > Authority**. Turn on the Calling feature.

<Frame caption="Open Calling > Authority to manage calling, icon visibility and outbound access.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/calling-authority.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=380a48c16bbd160ee7914533b97b8fdc" alt="Calling authority page for a YCloud demonstration number" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/calling-authority.png" />
</Frame>

## Show the inbound call icon

In the Calling authority settings, enable the call icon so customers can call from their WhatsApp conversation or your business profile. Even when the icon is hidden, customers may still call through a message that contains a call button.

<Frame caption="In Calling > Authority, control whether the WhatsApp call icon is visible to customers.">
  <img src="https://mintcdn.com/lchnan/4TSqTiiIpS59tkT7/product-assets/english-help-context-2026-09-25/calling-icon-visibility-annotated.svg?fit=max&auto=format&n=4TSqTiiIpS59tkT7&q=85&s=2ce0a18f4d95821e3f7aab1f0ce12295" alt="WhatsApp Business Number settings showing Calling Authority and Call icon visibility enabled." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/calling-icon-visibility-annotated.svg" />
</Frame>

## Configure outbound calling access

In the business number settings, use **Calling > Authority** to choose which agents can initiate outbound calls with that number.

<Info>
  This restriction applies to outbound calls placed in the YCloud console. Calls initiated through the API are not restricted by this console setting.
</Info>

<Frame caption="Find Agents and teams under Outbound calls, then select Add members to manage console access.">
  <img src="https://mintcdn.com/lchnan/4TSqTiiIpS59tkT7/product-assets/english-help-context-2026-09-25/calling-authority-annotated.svg?fit=max&auto=format&n=4TSqTiiIpS59tkT7&q=85&s=000605d556e9589ed3f847ebf64f9458" alt="Full Calling Authority settings page showing the Outbound calls section and Add members control." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/calling-authority-annotated.svg" />
</Frame>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.