Visão geral de eventos
Como a API transforma eventos internos em entregas por webhook e WebSocket.
A implementação atual publica eventos por webhooks HTTP POST e por WebSocket. Há dois escopos: eventos por instância, com envelope contendo instance, e eventos globais de Message Batch, sem esse campo.
O que está implementado
- 41 nomes públicos: 27 eventos por instância e 14 eventos globais de Message Batch.
- Webhook por instância com flags em
events. - Webhook global controlado por
WEBHOOK_GLOBAL_URLeWEBHOOK_GLOBAL_ENABLED. - WebSocket por instância em
/ws/instance/events. - WebSocket global em
/ws/global/events. - Fila em memória com múltiplos workers para eventos por instância.
- Outbox PostgreSQL com retry e backoff para eventos globais de Message Batch.
Limites operacionais
Eventos por instância não têm retry automático nem dead-letter queue. Eventos de Message Batch são reagendados pela outbox após falhas, com backoff persistente. Nenhum dos fluxos garante ordem ou assinatura HMAC; o x-request-id serve apenas para correlação.
O WebSocket entrega em tempo real, mas em modo best-effort e sem replay automático. Veja WebSocket de eventos para URLs, autenticação, payloads e códigos de fechamento.