Configuración de Ciclo de Vida
Acceso de solo lectura a los tres pilares de ciclo de vida de un Activity Generation Config.
Resumen
Una configuración de ciclo de vida es uno de los tres pilares que componen un Activity Generation Config (AGC). Cada pilar clasifica una etapa distinta del ciclo de vida de retención de un cliente:
| Pilar | Recurso | Propósito |
|---|---|---|
activation | Activation Configs | Clasifica si (y con qué intensidad) un usuario se activó, en base a momentos de acción tempranos. |
engagement | Engagement Configs | Agrupa usuarios activos en niveles de engagement (p. ej. casual, core, power). |
resurrection | Resurrection Configs | Detecta usuarios que decaen hacia la inactividad y clasifica recuperación vs. fuga. |
Cada fila de configuración de ciclo de vida siempre pertenece a exactamente un AGC (activityGenerationConfigId es NOT NULL, 1:1). No existe un pilar standalone ni huérfano.
Estos recursos son de solo lectura. No existe creación, edición ni
borrado standalone: solo existen GET (lista) y GET /:id. Una configuración
de ciclo de vida se crea y edita exclusivamente a través del flujo del
AGC.
Cómo se crean y editan las configuraciones de ciclo de vida
Nunca creas ni mutas un pilar directamente. En cambio, los pilares se escriben a través de los endpoints del AGC:
Crear un AGC
Crea el AGC junto con los tres pilares de ciclo de vida en una sola petición transaccional.
Actualizar pilares de ciclo de vida
Reemplazo in-place de uno o más pilares en un AGC existente.
Para prellenar el wizard de creación del AGC con valores iniciales razonables, obtén los valores por defecto de la plataforma desde GET /api/lifecycle-defaults.
Autenticación
Todos los endpoints requieren un token JWT Bearer más el header x-tenant-id que identifica al tenant sobre cuyo schema opera la petición.
-H "Authorization: Bearer <token>"
-H "x-tenant-id: <tenant-id>"Permisos
| Permiso | Constante | Otorga |
|---|---|---|
lifecycle-config:view | VIEW_LIFECYCLE_CONFIGS | Listar y leer los tres pilares (activación / engagement / resurrección). |
activity-generation-config:view | VIEW_ACTIVITY_GENERATION_CONFIGS | Leer el payload de prellenado de valores por defecto. |
Recursos
Activation Configs
Lee el pilar de activación y sus momentos de activación.
Engagement Configs
Lee el pilar de engagement y sus niveles de engagement.
Resurrection Configs
Lee el pilar de resurrección y sus umbrales de decaimiento.
Valores por Defecto
Valores por defecto de la plataforma para prellenar el wizard de creación del AGC.