Ligação pela API não oficial do WhatsApp: como o motor da WAME faz e atende chamadas

Ligação pela API é hoje um dos recursos mais pedidos da WAME: IA que atende o telefone, confirmação de agendamento por voz, retorno de atendimento sem ninguém discando. Este artigo mostra como o motor faz isso e a regra de uso que mantém o número tranquilo. Para o resumo do produto, veja a página da API não oficial da WAME.

Como o motor faz uma ligação

Uma ligação de WhatsApp tem duas partes: a sinalização (quem liga, quem atende, quando desliga) e a mídia (o áudio). O motor cuida das duas como um aparelho conectado do seu número:

1. envia a oferta de chamada ao WhatsApp do destinatário;
2. acompanha os sinais de toque, atendimento e recusa;
3. abre o canal de áudio cifrado quando a pessoa atende;
4. encaminha o áudio que você mandar para dentro da chamada;
5. avisa o seu sistema pelo webhook a cada mudança de estado.

Do seu lado, são poucas chamadas de API. A ligação precisa estar habilitada na instância.

Ligar, tocar áudio, encerrar

Todos os exemplos usam a base https://server.wame.api.br/SUA_KEY/.

# Ligar
curl -X POST "https://server.wame.api.br/SUA_KEY/call" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5566997145103" }'

# Tocar um áudio na chamada ativa
curl -X POST "https://server.wame.api.br/SUA_KEY/call/ID_DA_CHAMADA/audio" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seu-site.com/confirmacao.mp3" }'

# Encerrar (callId e peerJid vêm na resposta do /call)
curl -X POST "https://server.wame.api.br/SUA_KEY/call/end" \
  -H "Content-Type: application/json" \
  -d '{ "callId": "ID_DA_CHAMADA", "peerJid": "[email protected]" }'

Atender quem liga

Quando alguém liga para o seu número, o webhook recebe a chamada com o ID e quem está ligando. Para atender:

curl -X POST "https://server.wame.api.br/SUA_KEY/call/accept" \
  -H "Content-Type: application/json" \
  -d '{ "callId": "ID_DA_CHAMADA", "callFrom": "[email protected]" }'

Com a chamada atendida, o áudio pode vir de uma gravação ou de um agente de voz com IA. Os detalhes de montar o agente estão em IA para atender ligação no WhatsApp e agente de voz: latência e interrupção.

O que dá para montar

• IA que atende: responde dúvidas por voz, agenda e transfere quando precisa;
• confirmação de agendamento: liga um dia antes e entende sim, não e remarcar, veja IA que liga para confirmar agendamento;
• URA por voz: um menu falado em vez de "digite 1", veja URA inteligente no WhatsApp;
• recusar e responder por texto: quando ninguém pode atender, veja recusar ligação e responder por mensagem.

A regra que evita problema

Ligação segue a mesma lógica das mensagens:

• atender quem liga é uso normal;
• ligar para quem já é seu contato é uso normal: a confirmação que o cliente espera, o retorno que ele pediu;
• ligação fria em volume, para uma lista de quem nunca falou com você, é o que bane.

Uma regra prática: se a pessoa estranharia receber a ligação, não ligue pela API.

Conclusão

O motor da WAME faz, atende, toca áudio e encerra ligações de WhatsApp como um aparelho conectado do seu número, e manda cada passo para o seu webhook. É a base para IA de voz, confirmação de agendamento e URA. Usada para quem liga e para quem já é seu contato, a ligação vira um canal novo de atendimento. Veja a página da API não oficial.