Eventos

A tela de eventos (/dashboard/events) expõe o stream interno de eventos de domínio gerados pelo sistema toda vez que um estado relevante muda — invoice.created, payment.succeeded, subscription.canceled, nfe.issued e dezenas de outros. É a mesma fila que alimenta os Webhooks e o histórico do cliente no portal.

Por que isso importa

Diferente da Auditoria, que registra alterações feitas por humanos, eventos representam o que aconteceu do ponto de vista do domínio do negócio — independentemente da origem (UI, API, worker, webhook recebido de gateway).

Eventos são úteis para:

• Debug: descobrir por que um webhook não chegou ao destino ou por que uma assinatura foi cancelada inesperadamente.
• Replays: reenviar eventos para um endpoint que estava fora do ar.
• Integrações: confirmar que um evento esperado foi de fato gerado.

Estrutura do evento

Cada evento contém:

• type — nome no padrão recurso.acao (ex.: invoice.paid)
• resource_type e resource_id — a entidade afetada
• payload — JSON com o estado relevante no momento do evento
• created_at — quando o evento foi emitido
• delivery_status — agregado das tentativas de entrega para os endpoints assinantes

Filtros e busca

A lista oferece filtros por tipo de evento, recurso, intervalo de datas e status de entrega. Cada linha pode ser expandida para mostrar o payload completo e o histórico de tentativas em cada endpoint inscrito.

Catálogo de eventos

A referência completa dos tipos de evento (e quando cada um é disparado) está em Webhooks > Eventos.

Captura de tela