Chamadas do WhatsApp Business — Visão geral

O WhatsApp Business Calling permite fazer e receber chamadas de voz com seus clientes pelo WhatsApp, através da API /v1/calls*.

​

Provedores suportados

As chamadas funcionam em dois tipos de provedor — e se comportam de forma diferente em cada um:

​

Tipos de chamada

O Pilot Status não cobra nada pelas chamadas.

​

Preços da Meta para chamadas iniciadas pela empresa (números oficiais)

Em números Meta Cloud API, os minutos de BIC são cobrados pela Meta diretamente na sua WABA (preços oficiais):

• Chamadas iniciadas pelo usuário são gratuitas — sempre, nos dois provedores.
• A duração de BIC é medida em pulsos de 6 segundos; pulso fracionado conta como pulso inteiro (uma chamada de 56 segundos = 9,33 → 10 pulsos).
• A tarifa por pulso depende do país de destino e do seu tier de volume mensal (mesma estrutura de acúmulo de tiers das mensagens do WhatsApp). Quando uma chamada cruza a fronteira de um tier, a chamada inteira é cobrada pela tarifa mais barata (do tier de maior volume).
• É obrigatório ter um método de pagamento válido na WABA para fazer chamadas — sem ele, as chamadas falham com o erro Meta 131044.
• Mensagens de solicitação de permissão de chamada são cobradas como mensagens normais, não como minutos de chamada.
• As tarifas são publicadas por moeda nos rate cards da Meta (rate card em BRL vigente a partir de 1º de julho de 2026).

​

Suporte de recursos por provedor

Um recurso que o provedor não suporta retorna 400 FEATURE_NOT_SUPPORTED.

​

Como cada provedor trata a mídia

​

META — apenas sinalização

O Pilot Status retransmite o SDP; o áudio flui navegador ↔ WhatsApp diretamente. Seu cliente WebRTC produz a oferta/resposta SDP. Não há nada no servidor para tocar áudio, então play e realtime-session não se aplicam. A página /chat do painel tem um softphone integrado (disponível nos dois tipos de número).

​

Pilot Status web — mídia no servidor (sem SDP)

POST /v1/calls e /accept não recebem sdp — a chamada conecta e o áudio é processado no servidor. Você então controla o áudio com os dois endpoints exclusivos dos números web:

• POST /v1/calls/{callId}/play — o backend baixa seu arquivo de áudio (a URL é validada no servidor) e o toca na chamada; passe hangupAfterPlay: true para encerrar a chamada automaticamente quando a reprodução terminar (bots de notificação não precisam de timer no cliente).
• POST /v1/calls/{callId}/realtime-session — abre uma sessão WebSocket PCM16 full-duplex. A wsUrl retornada fica em um host público de mídia dedicado e seu token é de uso único com TTL curto (~2 min); conecte-se a ela diretamente (não passa pelo proxy da API).

Números web não precisam de concessão de permissão BIC e não têm superfície de configurações de chamada (esses são conceitos da Meta).

​

Camada de migração / compatibilidade

Se você já integra com o Evolution GO, a camada de compatibilidade faz proxy dos endpoints GO /call/* (start, answer, reject, hangup, list, get, media/play, media/realtime/session) — aponte sua base URL para /api/layer/evolution-go/ e seu código de chamadas GO existente continua funcionando. O WebSocket em tempo real (/call/media/realtime/ws/*) é acessado diretamente em um host público de mídia dedicado (a camada HTTP não faz upgrade de WebSocket); rotas de frontend/manager do GO não passam pelo proxy.

​

Acompanhe o progresso com webhooks

Assine call.ringing, call.connected, call.ended (inclui duration em segundos quando atendida), call.missed e call.permission_updated. Eventos call.* normalizados disparam tanto para números META quanto Pilot Status web.

​

Próximos passos