Guias/Eventos em tempo real
Documentação

Eventos em tempo real

Como consumir os eventos por webhook ou WebSocket.

O catálogo implementado reúne 41 eventos públicos: 27 por instância e 14 globais de Message Batch. Esses nomes são usados tanto nos Webhooks quanto no WebSocket de eventos.

Uma arquitetura comum para entrega persistente é:

  1. CodeChat envia POST ao seu endpoint de webhook.
  2. Seu backend valida, persiste e reconhece a entrega com 2xx.
  3. Seu backend publica o evento aos clientes autorizados pelo canal interno escolhido.

Para consumo direto em tempo real, abra uma conexão WebSocket para /ws/instance/events ou /ws/global/events, informando exatamente um event e o token adequado na query string. O WebSocket é best-effort e não substitui persistência ou replay no seu backend.