Skip to main content
Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: não O módulo /api/call/* cobre o disparo de chamadas de voz e a criação de links de chamada compartilháveis a partir da instância. Hoje há cinco operações: a chamada fake, que faz o telefone tocar por alguns segundos e desliga sozinha (sem áudio); a chamada com áudio, que liga e reproduz um arquivo quando o destinatário atende; a criação de link de chamada, que gera um link compartilhável (áudio ou vídeo) que qualquer pessoa pode abrir para entrar; a pré-visualização de link de chamada, que consulta os metadados de um link sem entrar na chamada; e o agendamento de chamada, que cria um link e envia um cartão de evento com esse link, título e horário de início. Todas as rotas validam a ownership da instância e aceitam TokenAccount ou TokenInstance.

​
Endpoints disponíveis

​
Estrutura comum

​
Destinatário (number)

Ambos os endpoints recebem o destino no campo number, que aceita:
  • Número simples: "5511999999999" (preferido).
  • JID privado: "5511999999999@s.whatsapp.net".
As chamadas são sempre 1:1, não há chamada para grupo via API.

​
Resposta padrão (200)

As duas rotas retornam um envelope com o callId atribuído pelo WhatsApp:
A chamada fake inclui também o campo duration (segundos que ficou tocando).
O callId identifica a chamada no WhatsApp. A chamada fake é encerrada automaticamente pelo servidor após duration segundos; a chamada com áudio só reproduz o arquivo se o destinatário atender.

​
Erros comuns

Envelope de erro:

​
Próximos passos

Chamada Fake

Faz o telefone tocar por alguns segundos e desliga sozinha.

Chamada com Áudio

Liga e reproduz um áudio (URL ou base64) quando atendem.

Criar Link de Chamada

Cria um link de chamada compartilhável (áudio ou vídeo) que qualquer pessoa pode abrir.

Pré-visualizar Link de Chamada

Consulta os metadados de um link de chamada sem entrar na chamada.

Agendar Chamada

Cria um link e envia um cartão de evento com o link, título e horário de início.