---
title: "WhatsApp Calling API: como funcionam as chamadas de voz e vídeo pela API"
description: "Entenda a WhatsApp Calling API: como iniciar chamadas de voz e vídeo pela API, requisitos, o que é cobrado e quando vale usar no seu atendimento."
url: "https://wame.api.br/blog/whatsapp-calling-api-chamada-voz-video"
language: "pt-BR"
og:type: "article"
published_time: "2026-09-17"
modified_time: "2026-09-17"
author: "Raphael Serafim"
keywords: "whatsapp calling api, chamada de voz whatsapp api, videochamada whatsapp business, whatsapp voip api, iniciar chamada whatsapp programaticamente, call automation whatsapp"
reading_time: "6 min de leitura"
---

# WhatsApp Calling API: como funcionam as chamadas de voz e vídeo pela API

> Entenda a WhatsApp Calling API: como iniciar chamadas de voz e vídeo pela API, requisitos, o que é cobrado e quando vale usar no seu atendimento.

**A WhatsApp Calling API permite iniciar e receber chamadas de voz e vídeo pela própria API oficial, no mesmo número e no mesmo thread de conversa usado para mensagens.** É um recurso relativamente novo dentro da Cloud API, ainda pouco explorado por quem já automatiza WhatsApp — mas resolve um problema real: conversa que trava em texto e precisaria de uma ligação pra andar.

## O que é a Calling API

Até pouco tempo, quem queria oferecer chamada de voz junto do atendimento por WhatsApp precisava de um canal separado — telefonia, outro app, ou pedir pro cliente ligar por fora. A Calling API muda isso: a chamada acontece dentro do mesmo número e do mesmo histórico de conversa, via VoIP, iniciada ou recebida programaticamente.

Isso é diferente de mandar um **link** de chamada por vídeo de terceiro — é a chamada nativa do WhatsApp, gerenciada pela sua integração.

## Requisitos pra habilitar

Antes de implementar, confira três pontos:

- **Número na Cloud API**, com Messaging Tier de pelo menos **2.000 conversas iniciadas por dia** (veja como o Tier funciona em [Quality Rating e limite de mensagens](/blog/quality-rating-limite-mensagens-whatsapp)).
- **Conta comercial verificada** pela Meta, com perfil de negócio aprovado.
- **Permissão elevada** na chave de API — os endpoints de chamada exigem nível de permissão acima do padrão usado só para mensagens.

## Como iniciar e encerrar uma chamada

Com a permissão configurada, o fluxo é direto:

```sh
# Fazer chamada (requer permission > 2)
curl -X POST https://server.wame.api.br/{KEY}/call \
  -H "Content-Type: application/json" \
  -d '{"to": "5511999999999", "isVideo": false}'
```

```sh
# Rejeitar/encerrar chamada (requer permission > 2)
curl -X DELETE https://server.wame.api.br/{KEY}/call/{CALL_ID}/{FROM}
```

O parâmetro `isVideo` decide se a chamada sobe como voz ou vídeo. O restante do ciclo de vida da chamada chega por webhook, do mesmo jeito que eventos de mensagem — vale revisar como seus webhooks já estão estruturados em [webhook em produção: assinatura, retry e idempotência](/blog/webhook-producao-assinatura-retry-idempotencia).

## Quando é cobrado e quando é grátis

| Cenário | Cobrança |
| --- | --- |
| Chamada recebida | Grátis |
| Chamada de saída que toca e não é atendida | Grátis |
| Pedido de permissão dentro da janela de 24h | Grátis |
| Pedido de permissão fora da janela de 24h | Cobrado como template |
| Chamada de saída atendida | Cobrada |

O ponto de atenção é o **pedido de permissão fora da janela de 24h** — ele entra na mesma lógica de template pago que já existe pra mensagens, então vale considerar isso no seu cálculo de custo (mais contexto em [quanto custa a API oficial do WhatsApp](/blog/quanto-custa-api-whatsapp-precos-meta)).

> Ligar sem pedir permissão antes, fora da janela de atendimento, tende a gerar a mesma reação negativa de uma mensagem sem opt-in — o cliente rejeita, e isso pesa contra a reputação do número.

## Casos de uso com resultado medido

A própria Meta divulgou resultados de early adopters: uma financeira teve aumento de **4x na conversão de ofertas de crédito** ao trocar uma sequência de mensagens por uma ligação no momento certo. Outro caso, de um programa de descontos, registrou **26% a mais de conversão** e **50% menos tempo médio de chamada** até fechar a venda.

Isso indica onde a chamada compensa: não em toda conversa, mas nos pontos em que texto vira gargalo — explicação técnica longa, negociação, ou urgência que o cliente sente que merece uma pessoa (ou uma IA) falando, não digitando.

## Conclusão

A Calling API é um recurso que a maioria das integrações de WhatsApp ainda não usa — e por isso mesmo é uma diferenciação real. Não é pra substituir o atendimento por texto, é pra resolver o ponto específico em que texto trava a conversa. Antes de implementar, confirme o Tier do número e desenhe o fluxo de pedido de permissão dentro da janela de 24h, que é o que evita cobrança extra e protege a reputação do número.

## Perguntas frequentes

### O que é a WhatsApp Calling API?

É o recurso da API oficial do WhatsApp que permite iniciar e receber chamadas de voz e vídeo (VoIP) diretamente no mesmo número e no mesmo app usado para mensagens, sem depender de outro canal de telefonia. A chamada acontece dentro do mesmo thread de conversa.

### Quais são os requisitos pra habilitar chamadas?

O número precisa estar na Cloud API (não funciona em número só com QR Code não oficial), ter Messaging Tier de pelo menos 2.000 conversas iniciadas por dia, e a conta comercial precisa estar com o perfil verificado pela Meta. Endpoints de chamada também exigem nível de permissão elevado na API.

### Chamada pelo WhatsApp API é cobrada?

Depende do cenário. Chamadas recebidas, chamadas de saída que tocam mas não são atendidas, e pedidos de permissão para ligar enviados dentro da janela de atendimento de 24h são gratuitos. É cobrada a chamada de saída que é atendida, e o pedido de permissão enviado fora da janela de 24h — nesse caso ele é cobrado como mensagem de template.

### Preciso pedir permissão antes de ligar para o cliente?

Sim, fora da janela de 24h. O fluxo recomendado é enviar um pedido de permissão para chamada (call permission request) e só iniciar a chamada depois que o cliente aceitar — isso evita chamada não solicitada, que pesa contra a qualidade do número da mesma forma que mensagem sem opt-in.

### Quando faz sentido usar chamada de voz em vez de só texto?

Em conversas que dependem de explicação mais longa, negociação ou urgência — como cobrança, suporte técnico complexo ou fechamento de venda consultiva. Casos documentados pela própria Meta mostram aumento relevante de conversão quando a chamada substitui uma sequência longa de mensagens de texto.