Webhook delivery

​

Sucesso

{
  "type": "delivery",
  "event_id": "01J5Q8ZK3M4N5P6Q7R8S9T0V1X",
  "instance_id": "8f2a3c1e-6b7d-4e5f-9a0b-1c2d3e4f5a6b",
  "momment": 1786968420000,
  "wabox_id": "wbx_01J5Q8ZK3M4N5P6Q7R8S9T0M01",
  "message_id": "3EB0A9C6D2F1E4B5A7D0",
  "phone": "5511988887777"
}

​

Falha

{
  "type": "delivery",
  "event_id": "01J5Q8ZK3M4N5P6Q7R8S9T0V1Z",
  "instance_id": "8f2a3c1e-6b7d-4e5f-9a0b-1c2d3e4f5a6b",
  "momment": 1786968425000,
  "wabox_id": "wbx_01J5Q8ZK3M4N5P6Q7R8S9T0M02",
  "phone": "5511900000000",
  "error": "phone is not on WhatsApp",
  "error_code": "phone_not_on_whatsapp"
}

​

Códigos mais comuns

​

O que delivery não é

• Não é recibo de entrega ao destinatário. delivery diz que a mensagem saiu do seu aparelho. “Chegou no celular do contato” é message_status com RECEIVED; “leu” é READ.
• Não vem para mensagens enviadas pelo celular — só para envios pela API.

​

Fluxo completo de um envio

1. POST /send-text → 200 { wabox_id, message_id, status: "queued" }
2. A mensagem espera o intervalo anti-ban na fila (1 a 3 s por padrão)
3. delivery com o mesmo wabox_id/message_id — ou error_code
4. message_status SENT → RECEIVED → READ (cada um quando o WhatsApp informar)