Fundamentos

Tipos de erro

Envelope JSON estável. Endpoints planned devolvem 501.

Sucesso

A maioria dos envios devolve `{ "success": true, "messageId": "...", "data": { "messageId": "..." } }`.

Leituras (list, settings, profile) colocam o recurso em uma chave (`instances`, `profile`, `messages`).

Erro

`{ "success": false, "error": { "message": "..." } }`

400 payload inválido · 401 token ausente/inválido · 403 sem acesso ou fora do horário (módulo Horário) · 404 instância ou mensagem · 429 rate limit · 501 planned · 502 WhatsApp/whatsmeow.

Instância desconectada

Envios com a instância fora de `connected` voltam 502 com a mensagem do whatsmeow (em geral `instance not connected`). Conecte pelo QR antes de testar.