Saltar al contenido principal

Eventos

La pantalla Eventos es el log de todos los eventos de dominio emitidos por la cuenta: las señales que dicen "esto ocurrió" (charge.paid, agreement.accepted, notification.delivered) para quien necesita reaccionar a ellas. Es la misma fuente que alimenta los webhooks: lo que aparece aquí es exactamente lo que se habría (o se ha) entregado a un endpoint suscriptor.

Log de eventos de dominio

Para qué sirve​

Es la pantalla de quien integra. Antes de configurar un webhook, aquí ves qué eventos está emitiendo de verdad la cuenta y el formato de cada payload. Después de configurar, es donde compruebas si el evento que esperabas se emitió realmente, sin depender del log de tu propio sistema.

Qué muestra cada fila​

  • Cuándo — el momento en que ocurrió el evento.
  • Tipo — el nombre del evento en el patrón <recurso>.<hecho> (charge.paid, dispute.resolved, person.created).
  • Recurso — el tipo y el identificador del recurso afectado (cobro, cliente, acuerdo, etc.).
  • Ver payload — abre un diálogo con el cuerpo completo del evento en JSON, el mismo objeto que el webhook entregaría.

Filtros​

  • Por tipo — escribe parte del nombre del evento (por ejemplo, charge.paid o solo charge.) para filtrar.
  • Por recurso — elige el tipo de recurso (Cobro, Cliente, Acuerdo, Disputa, Tarea, Regla, Plantilla, Clasificación, Interacción, Negativación, Protesto, Webhook).

El catálogo completo de los eventos, con cuándo se dispara cada uno y ejemplos de payload, está en Eventos de webhook. La configuración y la entrega a endpoints están en la Visión general de webhooks.

Eventos × Auditoría​

Dos pistas parecidas que responden a preguntas diferentes:

  • La Auditoría es la pista inmutable de acciones de usuario: quién hizo qué, cuándo, desde qué IP, con el estado antes y después. Es evidencia jurídica, hecha para responder "¿por qué hicieron esto?". No puede alterarse ni borrarse.
  • Eventos (esta pantalla) son señales de dominio para integración: lo que ocurrió en el sistema, en el formato que un webhook consume. El foco es máquina leyendo máquina, no la prueba de una acción humana.

Un ejemplo lo deja claro: cuando un operador resuelve una disputa, la auditoría registra su acción (con motivo, IP, antes/después) y, en paralelo, se emite un evento dispute.resolved para quien esté escuchando. Misma resolución, dos registros con propósitos distintos.