Eventos

El evento es la entidad central de la plataforma. Todo lo que ocurre en su operación — una transacción, una autenticación, un hito logístico — llega a la plataforma en forma de evento.

Al modelar sus ocurrencias como eventos, obtiene un punto único y estandarizado de ingestión de datos, independientemente del dominio de negocio. Esto permite:

  • analizar datos en tiempo real: siga lo que está ocurriendo en su operación a medida que llegan los eventos;
  • crear métricas personalizadas: agregue valores, calcule tasas y siga tendencias directamente de los eventos recibidos;
  • configurar monitoreos: defina reglas para detectar anomalías, riesgos o caídas de rendimiento;
  • evolucionar sin acoplamiento: agregue nuevos campos y tipos de evento sin romper las integraciones 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"
ocurrencia

Cómo se organizan los eventos

Cada evento pertenece a un tipo de evento, que define el contrato de datos esperado — qué campos existen, sus tipos y si son obligatorios. Estos tipos pueden representar diferentes contextos de negocio, como transacción financiera (transaction), autenticación de usuario (user_authentication) e hitos logísticos de entrega (logistics_delivery_event).

Usted define los tipos de evento según la realidad de su operación y envía las ocurrencias al endpoint POST /events. La plataforma valida, procesa y pone los datos a disposición para análisis, métricas y monitoreos.


Tabla de contenidos