Pular para o conteúdo principal
Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: não O módulo /api/call/* cobre o disparo de chamadas de voz a partir da instância. Hoje há duas operações: a chamada fake, que faz o telefone tocar por alguns segundos e desliga sozinha (sem áudio), e a chamada com áudio, que liga e reproduz um arquivo quando o destinatário atende. Todas as rotas validam a ownership da instância e aceitam TokenAccount ou TokenInstance.

​
Endpoints disponíveis

MétodoPathTipo
POST/api/call/fake/:instanceChamada Fake
POST/api/call/audio/:instanceChamada com Áudio

​
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: 
{
  "success": true,
  "message": "Audio call placed",
  "callId":  "3EB08FCF27E532F1D3D3",
  "number":  "5511999999999"
}
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

HTTPMensagem
400Instance name is required
400Invalid request body: <detalhe>
400Number is required
400Duration must be between 1 and 60 seconds (fake)
400Provide exactly one of mediaUrl or mediaBase64 (áudio)
404instance not found
500<motivo da falha>
Envelope de erro: 
{
  "success": false,
  "error": { "message": "Number is required" }
}

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