Eventos

Evento é a entidade central da plataforma. Tudo que acontece na sua operação — uma transação, uma autenticação, um marco logístico — chega à plataforma na forma de um evento.

Ao modelar suas ocorrências como eventos, você ganha um ponto único e padronizado para ingestão de dados, independentemente do domínio de negócio. Isso permite:

  • analisar dados em tempo real: acompanhe o que está acontecendo na sua operação assim que os eventos chegam;
  • criar métricas customizadas: agregue valores, calcule taxas e acompanhe tendências diretamente dos eventos recebidos;
  • configurar monitoramentos: defina regras para detectar anomalias, riscos ou quedas de performance;
  • evoluir sem acoplamento: adicione novos campos e tipos de evento sem quebrar integrações existentes.
Tipo de Evento
type:     "transaction"
fields:
  amount:   number
  status:   string
  currency: string
schema
valida
Evento
type:     "transaction"
id:       "evt_8f3a"
amount:   99.90
status:   "approved"
currency: "BRL"
ocorrência

Como eventos se organizam

Cada evento pertence a um tipo de evento, que define o contrato de dados esperado — quais campos existem, seus tipos e obrigatoriedade. Esses tipos podem representar contextos diferentes de negócio, como transação financeira (transaction), autenticação de usuário (user_authentication) e marcos logísticos de entrega (logistics_delivery_event).

Você define os tipos de evento conforme a realidade da sua operação e envia as ocorrências para o endpoint POST /events. A plataforma valida, processa e disponibiliza os dados para análise, métricas e monitoramentos.

Índice