Mandaí DocsAbrir console
Webhooks · IntroduçãoAbrir para IA

Receba mudanças de estado com evidência

O Mandaí envia HTTPS POST assinado para endpoints ativos. O evento contém identificadores e resultado operacional, sem telefone ou corpo em claro.

Configure no console

  • Abra Webhooks no ambiente correto.
  • Informe uma URL HTTPS pública e selecione os eventos.
  • Armazene o segredo whsec_ exibido uma única vez.
  • Nos POSTs da API do console para criar endpoint ou rotacionar segredo, use uma Idempotency-Key estável por intenção. Replay retorna 409 secret_already_revealed e resource_id, sem segredo; payload ou ator diferente retorna idempotency_conflict. Sem header, não há deduplicação.
  • Envie uma mensagem na Sandbox e acompanhe o recibo da entrega.

Formato da entrega

POST
application/json
10 segundos
At-least-once
Evento v1
{
  "event_id": "evt_01J...",
  "sequence": 3,
  "schema_version": "1.0",
  "environment": "sandbox",
  "type": "message.delivered",
  "occurred_at": "2026-08-22T16:42:00.000Z",
  "data": {
    "message_id": "msg_01J...",
    "status": "delivered"
  }
}

Quando a primeira tentativa acontece

Depois do HTTP 202, o Mandaí aciona o relay em background. A fila pode acrescentar latência. Se o acionamento imediato falhar, o registro permanece no outbox e uma varredura de recuperação ocorre nominalmente a cada minuto.

Próximos passos

Primeiros passosWebhooksOpenAPITermos de usoPrivacidadeUso aceitável