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
{
"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.