API de WhatsApp — Documentação

🔌 API de WhatsApp

Envie e receba mensagens de WhatsApp programaticamente. Cada instância (número conectado) tem um token próprio. Crie e conecte suas instâncias no painel.

Autenticação

Envie o token da instância no header Authorization (ou x-api-token).

Authorization: Bearer SEU_TOKEN_DA_INSTANCIA

Base URL

…

Enviar mensagem de texto

POST /api/wa/send

numero	Destino com DDI+DDD, só dígitos. Ex: `5531999999999`
mensagem	Texto a enviar.

…

Enviar áudio (nota de voz)

POST /api/wa/send-audio

numero	Destino (DDI+DDD).
audio_base64	Áudio em base64 (Ogg/Opus recomendado).
mimetype	Opcional. Padrão `audio/ogg; codecs=opus`.

Status da conexão

GET /api/wa/status

…

Receber mensagens (webhook)

Configure a URL de webhook da instância no painel. A cada mensagem recebida, enviamos um POST para sua URL com o corpo:

{
  "instancia_id": "...",
  "from": "5531999999999",
  "pushName": "Cliente",
  "texto": "Olá!",
  "tem_audio": false,
  "recebido_em": "2026-06-01T12:00:00.000Z"
}

Erros

401	Token ausente ou inválido.
409	Número não conectado — conecte a instância pelo painel.
429	Muitas requisições (limite por minuto).

Dúvidas? Volte ao painel para gerenciar instâncias, tokens e webhooks.