Message Batch

message.batch.item.failed

Um item terminou em FAILED.

Pro

Requisição

http

POST /webhooks/codechat HTTP/1.1
Content-Type: application/json
User-Agent: CodeChat-MessageBatch-Webhook/1.0
x-webhook-event: message.batch.item.failed

Payload

json

{
  "event": "message.batch.item.failed",
  "timestamp": "2026-07-13T15:12:00Z",
  "data": {
    "batchId": "01900000-0000-7000-8000-000000000001",
    "itemId": "01900000-0000-7000-8000-000000000037",
    "recipient": "5531888888888",
    "instance": {
      "id": 2,
      "name": "codechat-02"
    },
    "error": {
      "code": "SEND_MESSAGE_FAILED",
      "message": "falha ao enviar a mensagem"
    }
  }
}

Observações de entrega

Entregue somente ao WEBHOOK_GLOBAL_URL pela outbox PostgreSQL.
Respostas 2xx confirmam a entrega; falhas são reagendadas com backoff persistente.
Implemente idempotência por chave de negócio e aceite a possibilidade de duplicidades e reordenação.