Configuración de alertas
Configuración de alertas automáticas por cliente en Relo: tipos de disparador, umbrales, canales de notificación y pruebas.
Configuración de alertas
La pantalla Alerts es la vista administrativa de las reglas de alerta (alert_rules) por cliente. Hoy vive como la surface alert dentro del Rules Engine: la ruta /v2/c/:slug/alerts redirige a /v2/c/:slug/rules?surface=alert, donde el contenido se renderiza inline. Las reglas tienen alcance por cliente — si no hay cliente seleccionado, la pantalla pide elegir uno en el selector de workspace.
Flujo
Tipos de alerta
El selector Trigger type ofrece 12 tipos de disparador. Cada uno valida su propia forma de conditions en el servidor.
| Tipo | Cuándo dispara |
|---|---|
| Budget threshold | Cuando el gasto de un partner alcanza X% de su cap. |
| Budget reached (100%) | Cuando el gasto llega al 100% del cap. No tiene condiciones configurables. |
| Budget increased | Cuando se eleva el cap de presupuesto. |
| Budget decreased | Cuando se reduce el cap de presupuesto. |
| Commission rate changed | Cuando cambia una tasa de comisión a mitad de periodo. |
| Partner inactivity | Cuando un partner no registra ventas durante X días. |
| Unattributed sales | Cuando X o más ventas caen sin atribución a partner. |
| Sales drop | Cuando las ventas caen X% respecto al periodo anterior. |
| Sales spike | Cuando las ventas suben X% respecto al periodo anterior. |
| Low attribution rate | Cuando la tasa de atribución baja de X%. |
| Partner status change | Cuando un partner pasa de un estatus a otro. |
| Fraud detected (Protect360) | Cuando Protect360 marca fraude por encima del umbral. Los umbrales se gestionan de forma centralizada en el pipeline Protect360, así que las condiciones no se pueden editar desde la UI: solo se activa o pausa la regla. |
Clientes pixel
Los disparadores Sales drop, Sales spike, Unattributed sales y Low attribution rate dependen de rollups de product_sales / partner_daily_aggregates que los clientes pixel no pueblan. Se ocultan del selector para clientes pixel-only; los clientes MMP e híbridos los ven todos.
Condiciones y umbrales
Cada tipo de disparador tiene su propio editor inline de condiciones:
- Budget threshold:
Thresholden % (1–100, default 80). - Budget increased / decreased:
Min change %(0–100) y ventana de look-back en horas (1–168, default 24). - Commission rate changed:
Segmentopcional (dropdown alimentado desdeclient_segmentsdel cliente activo, o "All segments") y ventana de look-back en horas. - Partner inactivity:
Days without sales(1–90, default 5). - Unattributed sales:
Sales count threshold(1–10,000, default 20). - Sales drop / spike:
Percent threshold(1–1000, default 30) y periodo de comparación: Previous week o Previous month. - Low attribution rate:
Min attribution rateen % (1–100, default 80). - Partner status change:
From statusyTo status(Any, Active, Paused o Cancelled). - Budget reached: sin condiciones — dispara automáticamente al 100% del cap.
- Fraud detected: condiciones de solo lectura, gestionadas por el servidor.
Al cambiar el tipo de disparador, las condiciones se reinician con los valores por defecto de ese tipo. Para cualquier tipo sin editor dedicado existe un fallback de JSON libre, validado en el servidor.
Canales de notificación
Una regla puede notificar por dos canales, activables con checkbox:
- Email: lista de destinatarios en formato chips. Se agregan con Enter o el botón + (la dirección debe contener
@y no estar duplicada) y se eliminan con la × de cada chip. - Webhook: una sola URL. Al dispararse, se hace un POST con un payload JSON (por ejemplo a Slack o a un endpoint interno).
Alcance y severidad
- Partner scope: dropdown con los partners del cliente (tabla
partner_clients). "All partners" aplica la regla a todos; también se puede acotar a un partner específico. - Severity: radio de 3 botones — info, warning o critical — que define el tono del badge e icono de la regla en la lista.
- Name es obligatorio; Description es texto libre opcional para dar contexto al equipo.
Crear, editar y probar reglas
Toda la gestión ocurre desde la misma pantalla:
- New rule abre un drawer con el editor completo (identidad, disparador, condiciones, alcance, severidad y canales). El mismo drawer sirve para Edit sobre una regla existente.
- Test ejecuta la regla contra los datos actuales y muestra durante 8 segundos si dispararía en ese momento (
would_trigger) y cuántos registros coinciden, o el error si la prueba falla. - Pause / Activate alterna
is_activesin borrar la regla. - Delete pide confirmación y es irreversible.
- La lista se puede buscar (por nombre, descripción, tipo de disparador o partner) y filtrar por estatus (All / Active / Paused).
Arriba de la lista, cuatro cards resumen el estado: Active rules (de N totales), Triggered last 24h, Lifetime triggers y Disabled. Cada fila muestra además cuándo disparó por última vez y cuántas veces ha disparado en total.
¿Necesitas ayuda?
Si una regla no dispara cuando debería, usa el botón Test para evaluarla contra los datos actuales y revisa que el Partner scope y las condiciones (umbrales, ventanas de look-back) correspondan a lo que esperas. Si el test devuelve error, el mensaje viene directo de la validación del servidor.