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

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).
• 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:

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

# Rejeitar/encerrar chamada (requer permission > 2)
curl -X DELETE https://us.api-wa.me/{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.

Quando é cobrado e quando é grátis

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

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.