Resumen
Events & Automation es el motor orientado a eventos de CXF. Un único Event Template unifica dos cosas: qué lo dispara (su tipo) y qué corre en respuesta — un flujo de automatización visual de nodes conectados por edges. Cuando algo sucede — un contact envía una encuesta, un registro cambia, una programación se dispara — el template corre su flujo. Para ver cómo encaja en la plataforma, consulta Conceptos básicos.Dónde encontrarlo
Events & Automation está en Orchestration → Events & Automation, construido en un canvas visual de flujo.Properties
| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | Sí | Nombre visible. |
slug | string | Sí | Identificador (a–z, 0–9, -). |
description | string | No | Para qué sirve el template. |
type | enum | Sí | contact, user, scheduled o system — ver Event types. |
is_enabled | boolean | No | Si el template está activo. |
requires_authentication | boolean | Condicional | Solo tipo contact — cuando es false, contacts anónimos (ghost) pueden dispararlo. |
enrichment | object | No | El esquema de datos extra provistos cuando el template se dispara. |
first_action | object | No | Una acción síncrona opcional que corre antes del flujo. |
nodes / edges | array | No | El flujo de automatización. |
Tipos de trigger
El type de un template determina cómo se dispara:| Tipo | Disparado por |
|---|---|
| Contact | Una acción de un contact por la Contact API pública (soporta anónimo/ghost). |
| User | Un usuario staff autenticado por la User API. |
| Scheduled | Una programación recurrente (RRULE), típicamente iterando una View guardada. |
| System | Automáticamente, cuando un registro se crea, actualiza o elimina. |
El flujo de automatización
La respuesta es un flujo construido con nodes conectados por edges, que corre de un node start a un node goal. Los nodes pueden ramificar por condiciones, esperar, ejecutar acciones (vía action plugins) o iterar una View. Consulta Automation nodes.Enrichment
Cada template define un esquema de enrichment — los campos extra provistos cuando el template se dispara (por ejemplo el rating de una encuesta, el total de una order). El enrichment se valida contra el esquema, y sus valores quedan disponibles en todo el flujo comoenrichment.* en los
field mappings.
First action
Un template puede ejecutar una first action de forma síncrona antes del flujo asíncrono — útil cuando quien llama necesita un resultado inmediato. Cualquier action plugin puede correr como first action.Habilitar y el event endpoint
Habilitar un template (debe tener al menos un node goal) crea automáticamente un endpoint de evento para poder dispararlo por la API. El endpoint auto-creado arranca deshabilitado — habilítalo cuando estés listo para exponerlo.Runs e historial
Cada disparo crea un automation run que trackea sustatus (waiting, running,
completed, failed, cancelled), el camino de nodes recorrido, y si alcanzó su goal.
Los events también se pueden guardar históricamente para analítica, y los events legacy
soportan moderación (pending / approved / rejected).
Seeds
El soporte de Seeds para Event Templates está próximamente.Gobernanza y permisos
Solo un super admin o un Master puede crear, editar, habilitar y eliminar Event Templates.Acceso por API
La User API gestiona templates, nodes y edges, y dispara eventsuser; la Contact API
dispara events contact. Consulta la API reference.
En profundidad
Event types
Triggers contact, user, scheduled y system en detalle.
Automation nodes
Nodes de flujo, field mappings y la matriz de disponibilidad de acciones.
Relacionado
Engagement Funnels
Los checkpoints y result layers de un funnel disparan event automations.
Endpoints
El event endpoint creado al habilitar un template.