Pular para o conteúdo principal

Eventos

A tela Eventos é o log de todos os eventos de domínio emitidos pela conta: os sinais que dizem "isto aconteceu" (charge.paid, agreement.accepted, notification.delivered) para quem precisa reagir a eles. É a mesma fonte que alimenta os webhooks: o que aparece aqui é exatamente o que teria sido (ou foi) entregue a um endpoint assinante.

Log de eventos de domínio

Para que serve​

É a tela de quem integra. Antes de configurar um webhook, você vê aqui quais eventos a conta está emitindo de verdade e o formato de cada payload. Depois de configurar, é onde você confere se o evento que esperava foi mesmo emitido, sem depender do log do seu próprio sistema.

O que cada linha mostra​

  • Quando — o momento em que o evento ocorreu.
  • Tipo — o nome do evento no padrão <recurso>.<fato> (charge.paid, dispute.resolved, person.created).
  • Recurso — o tipo e o identificador do recurso afetado (cobrança, cliente, acordo, etc.).
  • Ver payload — abre um diálogo com o corpo completo do evento em JSON, o mesmo objeto que o webhook entregaria.

Filtros​

  • Por tipo — digite parte do nome do evento (por exemplo, charge.paid ou só charge.) para filtrar.
  • Por recurso — escolha o tipo de recurso (Cobrança, Cliente, Acordo, Disputa, Tarefa, Régua, Template, Classificação, Interação, Negativação, Protesto, Webhook).

O catálogo completo dos eventos, com quando cada um dispara e exemplos de payload, está em Eventos de webhook. A configuração e a entrega para endpoints estão na visão geral de Webhooks.

Eventos × Auditoria​

Duas trilhas parecidas que respondem a perguntas diferentes:

  • A Auditoria é a trilha imutável de ações de usuário: quem fez o quê, quando, de qual IP, com o estado antes e depois. É evidência jurídica, feita para responder "por que vocês fizeram isso?". Não pode ser alterada nem apagada.
  • Eventos (esta tela) são sinais de domínio para integração: o que aconteceu no sistema, no formato que um webhook consome. O foco é máquina lendo máquina, não a prova de uma ação humana.

Um exemplo deixa claro: quando um operador resolve uma disputa, a auditoria registra a ação dele (com motivo, IP, antes/depois) e, em paralelo, um evento dispute.resolved é emitido para quem estiver ouvindo. Mesma resolução, dois registros com propósitos distintos.