> ## 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.

# Visão geral

> Entenda o WhatsApp Calling, seus requisitos, preços e opções de configuração na YCloud.

O WhatsApp Calling é um recurso de chamadas de voz (VoIP) fornecido pela WhatsApp Business Cloud API. Ele permite que as empresas realizem conversas de voz em tempo real com clientes diretamente no WhatsApp.

A YCloud oferece suporte a dois tipos de chamada:

* **Chamadas receptivas:** os clientes ligam para a sua empresa.
* **Chamadas ativas:** sua empresa liga para os clientes após receber permissão.

## Cobrança

#### Chamadas receptivas

As chamadas receptivas são gratuitas, independentemente de sua empresa atender ou não.

#### Chamadas ativas

* As cobranças são baseadas na duração da chamada conectada.
* Uma unidade de cobrança é de 6 segundos. Qualquer unidade parcial é arredondada para cima.
* A tarifa depende do código de país do número de telefone do cliente.

Por exemplo, se a tarifa para a Indonésia for de USD 0,0242 por minuto e uma chamada conectada durar 9 segundos:

**Cobrança = 2 unidades × USD 0,0242 ÷ 10 = USD 0,00484**

Consulte os [preços do WhatsApp Calling](https://www.ycloud.com/pricing#price-table) para obter as tarifas atuais por país.

## Chamadas iniciadas pelo usuário (receptivas)

Os clientes podem iniciar uma chamada de três maneiras.

#### 1. Botão de chamada no WhatsApp

Ative o ícone de chamada para o número da sua empresa para que os clientes possam ligar a partir da conversa ou do perfil comercial.

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

#### 2. Link de chamada

Gere um link de chamada e insira-o em seu site, em um e-mail ou em uma mensagem do WhatsApp.

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

#### 3. Botão de chamada em uma mensagem

Adicione um botão de chamada a um modelo de mensagem ou mensagem interativa.

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

## Chamadas iniciadas pela empresa (ativas)

Antes de usar o WhatsApp Calling para chamadas ativas, sua conta comercial deve atender aos seguintes requisitos:

1. O limite de mensagens do Business Portfolio atingiu o nível de 2.000 clientes.
2. O país ou região registrado do número de negócios não é:
   * Estados Unidos (+1)
   * Canadá (+1)
   * Turquia (+90)
   * Egito (+20)
   * Vietnã (+84)
   * Nigéria (+234)

As empresas devem obter a permissão do cliente antes de iniciar uma chamada. A permissão pode ser solicitada com uma mensagem de modelo Calling Request ou uma mensagem interativa. Após o cliente selecionar **Permitir**, a empresa poderá ligar enquanto a permissão permanecer válida.

<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="Captura de tela do produto YCloud" width="1280" height="678" data-path="product-assets/47f902e6d1-image-58.webp" />

## Escolha um método de integração

A YCloud oferece suporte a duas maneiras de usar o WhatsApp Calling. Escolha o método correspondente à sua implementação.

#### Integração via HTTPS API

Para criar chamadas receptivas ou ativas com a API, entre em contato com seu representante da YCloud para ativar o Calling. Consulte o [exemplo de API do WhatsApp Calling](/api-reference/whatsapp-calling/connect-a-call).

#### Plataforma YCloud (recomendado)

Use o workspace de Calling no console da YCloud para chamadas baseadas em atendentes.

## Ativar o Calling para um número de negócios

Cada número de negócios pode ativar ou desativar o Calling de forma independente.

Acesse **Contas do WhatsApp**, abra as configurações do número de negócios e selecione **Calling > Permissão**. Ative o recurso Calling.

<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="Página de permissão de Calling para um número de demonstração da YCloud" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/calling-authority.png" />
</Frame>

## Exibir o ícone de chamada receptiva

Nas configurações de autoridade de Calling, ative o ícone de chamada para que os clientes possam ligar a partir da conversa do WhatsApp ou do perfil comercial. Mesmo quando o ícone estiver oculto, os clientes ainda poderão ligar por meio de uma mensagem que contenha um botão de chamada.

<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="Configurações do WhatsApp Business Number mostrando a visibilidade da Permissão de Calling e do ícone de chamada ativada." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/calling-icon-visibility-annotated.svg" />
</Frame>

## Configurar o acesso a chamadas ativas

Nas configurações do número de negócios, use **Calling > Permissão** para escolher quais atendentes podem iniciar chamadas ativas com esse número.

<Info>
  Essa restrição se aplica a chamadas ativas realizadas no console da YCloud. As chamadas iniciadas por meio da API não são restringidas por essa configuração do console.
</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="Página completa de configurações de Permissão de Calling mostrando a seção de Chamadas ativas e o controle Adicionar membros." 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.