WhatsApp calling API: o que é e como usar

WhatsApp calling — chamada de voz dentro do WhatsApp — deixou de ser só um recurso do app para virar algo que você integra no seu produto. Neste guia: o que é uma WhatsApp calling API, quais as opções e como colocar de pé rapidamente com o Hasos.

O que é uma WhatsApp calling API?

É uma interface para fazer e receber chamadas de voz do WhatsApp por software — do seu backend, CRM ou app — em vez de manualmente pelo celular. Você provisiona um número, origina/recebe chamadas e recebe eventos (tocando, atendida, encerrada) e gravações via API/webhook.

Não confunda com telefonia (PSTN) nem com mensagens: WhatsApp calling é o áudio que toca no app do WhatsApp do contato — não uma ligação telefônica comum.

Opções hoje

Meta WhatsApp Business Calling API — oficial, para números Business verificados; setup mais longo (Cloud API, verificação, aprovação).
Hasos — conecta um número de WhatsApp existente por QR Code e entrega calling por API + discador embarcável, com preço fixo por número.

Twilio e Voximplant, apesar de fortes em voz PSTN/SIP, não originam chamada dentro do WhatsApp — veja o comparativo completo.

Como usar (Hasos, em minutos)

bash

# provisiona o número
curl -X POST https://api.hasos.com.br/v1/instances \
  -H "x-api-key: hs_live_sua_chave" -H "Content-Type: application/json" \
  -d '{"phone":"5511999999999"}'

# emite o token do discador
curl -X POST https://api.hasos.com.br/v1/instances/INSTANCE_ID/tokens \
  -H "x-api-key: hs_live_sua_chave"

html

<iframe src="https://app.hasos.com.br/discador?token=SEU_TOKEN"
  allow="microphone" style="width:420px;height:640px;border:0"></iframe>

Eventos e gravação

Cada chamada dispara webhooks assinados (HMAC) com o ciclo de vida da chamada e um evento com o link da gravação estéreo quando ela fica pronta — pronto para gravar no seu banco ou acionar automações.

Coloque WhatsApp calling no seu produto

Conecte um número por QR Code e faça a primeira chamada hoje.

Criar conta grátis

Perguntas frequentes

Existe uma API oficial de WhatsApp calling?

Sim, a Meta WhatsApp Business Calling API — para números Business verificados. O Hasos é uma alternativa que funciona com números comuns e entrega o discador pronto.

Preciso trocar de número?

Não. O Hasos conecta o número de WhatsApp que você já usa, por QR Code.