Activity Generation Configs
Configuración solo de ciclo de vida que define cómo se generan las actividades de retención.
Descripción general
Una Activity Generation Config (AGC) describe cómo la plataforma deriva el estado del ciclo de vida de retención de un usuario. Es una configuración solo de ciclo de vida: metadatos base, una audiencia/filtro opcional y exactamente tres pilares de ciclo de vida obligatorios.
| Pilar | Propósito |
|---|---|
activation | Clasifica si (y con qué intensidad) un usuario se ha activado, en base a sus primeros momentos de acción. |
engagement | Agrupa a los usuarios activos en niveles de engagement (p. ej. casual, core, power). |
resurrection | Detecta usuarios que regresan tras un período de inactividad y clasifica recuperación vs. abandono. |
Los tres pilares son 1:1 con la AGC: toda AGC siempre tiene exactamente una configuración de activation, engagement y resurrection. No puedes crear una AGC con un pilar faltante, ni crear un pilar que no esté asociado a una AGC.
No existe un estado borrador/activo en una AGC — no hay campo status ni
paso /activate. Una AGC existe y es utilizable apenas se crea. Tampoco
existe configuración de dispatch independiente: una AGC solo define la
clasificación del ciclo de vida.
Config hashes
GET /:id devuelve un objeto configHashes — un hash determinístico por pilar (16 caracteres hexadecimales) para cada uno de los tres pilares:
{
"activation": "9f1c2a3b4d5e6f70",
"engagement": "a1b2c3d4e5f60718",
"resurrection": "0f1e2d3c4b5a6978"
}Los clientes usan estos hashes para detectar de forma económica cuándo cambió la configuración de un pilar, sin tener que comparar el payload anidado completo. El hash se calcula solo sobre el contenido semántico del pilar: los campos volátiles (id, timestamps) se eliminan y las colecciones hijas se hashean de forma independiente del orden, por lo que reordenar hijos sin cambiar sus valores no altera el hash.
Autenticación
Todos los endpoints requieren un token JWT Bearer más la cabecera x-tenant-id que identifica el tenant sobre cuyo esquema opera la solicitud.
-H "Authorization: Bearer <token>"
-H "x-tenant-id: <tenant-id>"Permisos
| Permiso | Constante | Otorga |
|---|---|---|
activity-generation-config:view | VIEW_ACTIVITY_GENERATION_CONFIGS | Listar y leer AGCs |
activity-generation-config:create | CREATE_ACTIVITY_GENERATION_CONFIG | Crear una AGC |
activity-generation-config:update | UPDATE_ACTIVITY_GENERATION_CONFIG | Actualizar metadatos y reemplazar pilares de ciclo de vida |
activity-generation-config:delete | DELETE_ACTIVITY_GENERATION_CONFIG | Archivar (soft delete) una AGC |
Endpoints
List Configs
Listar metadatos de AGC (sin config anidada, sin config hashes).
Get Config
Leer una AGC con sus tres pilares anidados y los config hashes.
Create Config
Crear una AGC con los tres pilares de ciclo de vida (transaccional).
Update Lifecycle
Reemplazo in-place de uno o más pilares de ciclo de vida.
Update Config
Actualizar solo los metadatos de la AGC (nombre, descripción, audiencia, filtro).
Delete Config
Archivar una AGC; sus tres pilares se archivan en cascada.