Rela AIRela AI Docs
Tutoriales

Escala alarmas automaticamente a supervisores

Configura reglas de escalacion que notifican a supervisores y gerentes cuando una alarma no es reconocida a tiempo.

Que vas a lograr

Al final de este tutorial tendras una cadena de escalacion completa: cuando una alarma no sea reconocida en 15 minutos, se enviara un email al supervisor; si persiste, un mensaje de WhatsApp al gerente. Tiempo estimado: 20 minutos.

Requisitos previos

  • Una cuenta activa en Rela AI con acceso al dashboard
  • Un agente de maquinas con al menos una regla de alarma configurada
  • Datos de contacto configurados para el supervisor (email) y el gerente (WhatsApp)
  • Una cuenta de email activa en Configuracion > Cuentas de Email

Paso 1: Crea una regla de escalacion

  1. En el menu lateral, ve a Agentes y selecciona tu agente de maquinas.
  2. Ve a la seccion Alarmas > Escalacion.
  3. Haz clic en Nueva Regla de Escalacion.
  4. Configura los campos basicos:
    • Nombre: Escalacion Alarma Critica
    • Disparador: alarm_unack (alarma no reconocida)
    • Tiempo de espera: 15 minutos

Deberias ver el formulario de escalacion con la seccion de pasos disponible para configurar.

El disparador alarm_unack se activa cuando una alarma permanece sin reconocer por el tiempo configurado. Otros disparadores disponibles incluyen alarm_active y task_overdue.

Paso 2: Agrega el paso 1 — Email al supervisor

  1. En la seccion Pasos de Escalacion, haz clic en Agregar Paso.
  2. Configura el primer paso:
    • Orden: 1
    • Canal: Email
    • Destinatario: selecciona al supervisor (ej: Maria Lopez)
    • Cuenta de email: selecciona tu cuenta de email activa
    • Asunto: [URGENTE] Alarma sin reconocer: {{alarm_name}}
    • Mensaje: La alarma "{{alarm_name}}" del agente "{{agent_name}}" lleva mas de 15 minutos sin ser reconocida. Por favor revise y tome accion inmediata.

Deberias ver el paso 1 listado con el canal Email y el destinatario seleccionado.

Las variables {{alarm_name}} y {{agent_name}} se reemplazan automaticamente con los valores reales cuando se ejecuta la escalacion.
Verifica que el supervisor tenga un email valido en su perfil. Si el campo de email esta vacio, la notificacion no se enviara y no aparecera error visible.

Paso 3: Agrega el paso 2 — WhatsApp al gerente

  1. Haz clic en Agregar Paso nuevamente.
  2. Configura el segundo paso:
    • Orden: 2
    • Retraso adicional: 15 minutos (se ejecuta 30 minutos despues de la alarma original)
    • Canal: WhatsApp
    • Destinatario: selecciona al gerente (ej: Roberto Sanchez)
    • Numero WhatsApp: selecciona un numero conectado
    • Mensaje: ALERTA CRITICA: La alarma "{{alarm_name}}" lleva 30+ minutos sin reconocer. El supervisor fue notificado pero no ha respondido. Requiere atencion del gerente.

Deberias ver ambos pasos listados en orden, con los tiempos acumulados visibles.

El retraso adicional se suma al tiempo de espera inicial. En este caso: 15 min (espera inicial) + 15 min (retraso paso 2) = 30 min totales antes del WhatsApp al gerente.

Paso 4: Vincula la escalacion a la regla de alarma

  1. Ve a Alarmas > Reglas.
  2. Selecciona la regla de alarma existente (ej: Vibracion Alta P-101).
  3. En la seccion Acciones, busca Escalacion.
  4. Selecciona Escalacion Alarma Critica del menu desplegable.
  5. Haz clic en Guardar.

Deberias ver la regla de alarma actualizada con la escalacion vinculada y un icono de escalacion visible.

La escalacion debe estar habilitada tanto en la regla de escalacion como en el agente. Verifica que el agente tenga la opcion Escalacion habilitada activada en su configuracion general.

Paso 5: Prueba con un evento critico

  1. Envia un evento que dispare la alarma (usa el webhook del agente):
curl -X POST https://api.rela.ai/v1/events/webhook/tu_webhook_id \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": "2026-03-26T14:00:00Z",
    "machine_id": "P-101",
    "metrics": {
      "vibration_mm_s": 8.5,
      "temperature_c": 75.0
    },
    "status": "running"
  }'
  1. NO reconozcas la alarma. Espera 15 minutos.
  2. Verifica en el dashboard:
    • La alarma aparece en Alarmas con estado active y prioridad high.
    • Despues de 15 minutos, el supervisor recibe el email.

Deberias ver la alarma activa y, tras 15 minutos, una entrada en el registro de escalacion mostrando "Paso 1 ejecutado: Email a Maria Lopez".

Para pruebas rapidas, puedes reducir temporalmente el tiempo de espera a 1 minuto. Recuerda restaurarlo antes de pasar a produccion.

Paso 6: Verifica que la escalacion funciona

  1. Ve a Alarmas > Escalacion > Registro.
  2. Busca la entrada de la alarma que acabas de probar.
  3. Verifica los detalles:
TiempoPasoCanalDestinatarioEstado
+15 min1EmailMaria LopezEnviado
+30 min2WhatsAppRoberto SanchezPendiente (o Enviado si esperaste 30 min)

Deberias ver el registro completo de escalacion con los timestamps y estados de cada paso.

  1. Para detener la escalacion, reconoce la alarma haciendo clic en Reconocer en la pagina de la alarma.
Reconocer la alarma detiene la cadena de escalacion inmediatamente. Los pasos pendientes se cancelan automaticamente.

Resumen

PasoAccionResultado
1Crear regla de escalacionRegla con disparador alarm_unack a 15 min
2Agregar paso 1Email al supervisor configurado
3Agregar paso 2WhatsApp al gerente a los 30 min
4Vincular a alarmaEscalacion asociada a la regla de alarma
5Probar con eventoAlarma generada y escalacion iniciada
6Verificar registroCadena de escalacion ejecutada correctamente

Siguientes pasos

En esta página