Scala automaticamente gli allarmi ai supervisori

Configura regole di escalation che notificano supervisori e manager quando un allarme non viene riconosciuto in tempo.

Cosa otterrai

Al termine di questo tutorial avrai una catena di escalation completa: quando un allarme non viene riconosciuto entro 15 minuti, verra inviata un'email al supervisore; se persiste, un messaggio WhatsApp al manager. Tempo stimato: 20 minuti.

Prerequisiti

Un account attivo su Rela AI con accesso alla dashboard
Un agente macchina con almeno una regola di allarme configurata
Dati di contatto configurati per il supervisore (email) e il manager (WhatsApp)
Un account email attivo in Impostazioni > Account Email

Passo 1: Crea una regola di escalation

Nel menu laterale, vai su Agenti e seleziona il tuo agente macchina.
Vai alla sezione Allarmi > Escalation.
Fai clic su Nuova Regola di Escalation.
Configura i campi base:
- Nome: Escalation Allarme Critico
- Trigger: alarm_unack (allarme non riconosciuto)
- Tempo di attesa: 15 minuti

Dovresti vedere il modulo di escalation con la sezione dei passaggi disponibile per la configurazione.

Il trigger alarm_unack si attiva quando un allarme rimane non riconosciuto per il tempo configurato. Altri trigger disponibili includono alarm_active e task_overdue.

Passo 2: Aggiungi il passaggio 1 — Email al supervisore

Nella sezione Passaggi di Escalation, fai clic su Aggiungi Passaggio.
Configura il primo passaggio:
- Ordine: 1
- Canale: Email
- Destinatario: seleziona il supervisore (es: Maria Lopez)
- Account email: seleziona il tuo account email attivo
- Oggetto: [URGENTE] Allarme non riconosciuto: {{alarm_name}}
- Messaggio: L'allarme "{{alarm_name}}" dell'agente "{{agent_name}}" non e stato riconosciuto per oltre 15 minuti. Si prega di verificare e agire immediatamente.

Dovresti vedere il passaggio 1 elencato con il canale Email e il destinatario selezionato.

Le variabili {{alarm_name}} e {{agent_name}} vengono sostituite automaticamente con i valori reali quando l'escalation viene eseguita.

Verifica che il supervisore abbia un'email valida nel suo profilo. Se il campo email e vuoto, la notifica non verra inviata e non apparira alcun errore visibile.

Passo 3: Aggiungi il passaggio 2 — WhatsApp al manager

Fai clic su Aggiungi Passaggio di nuovo.
Configura il secondo passaggio:
- Ordine: 2
- Ritardo aggiuntivo: 15 minuti (si esegue 30 minuti dopo l'allarme originale)
- Canale: WhatsApp
- Destinatario: seleziona il manager (es: Roberto Sanchez)
- Numero WhatsApp: seleziona un numero connesso
- Messaggio: ALLERTA CRITICA: L'allarme "{{alarm_name}}" non e stato riconosciuto per oltre 30 minuti. Il supervisore e stato notificato ma non ha risposto. Richiede attenzione del manager.

Dovresti vedere entrambi i passaggi elencati in ordine, con i tempi cumulativi visibili.

Il ritardo aggiuntivo si somma al tempo di attesa iniziale. In questo caso: 15 min (attesa iniziale) + 15 min (ritardo passaggio 2) = 30 min totali prima del WhatsApp al manager.

Passo 4: Collega l'escalation alla regola di allarme

Vai su Allarmi > Regole.
Seleziona la regola di allarme esistente (es: Vibrazione Alta P-101).
Nella sezione Azioni, cerca Escalation.
Seleziona Escalation Allarme Critico dal menu a tendina.
Fai clic su Salva.

Dovresti vedere la regola di allarme aggiornata con l'escalation collegata e un'icona di escalation visibile.

L'escalation deve essere abilitata sia nella regola di escalation che nell'agente. Verifica che l'agente abbia l'opzione Escalation abilitata attivata nella sua configurazione generale.

Passo 5: Testa con un evento critico

Invia un evento che attivi l'allarme (usa il webhook dell'agente):

curl -X POST https://api.rela.ai/v1/events/webhook/il_tuo_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"
  }'

NON riconoscere l'allarme. Attendi 15 minuti.
Verifica nella dashboard:
- L'allarme appare in Allarmi con stato active e priorita high.
- Dopo 15 minuti, il supervisore riceve l'email.

Dovresti vedere l'allarme attivo e, dopo 15 minuti, una voce nel registro di escalation che mostra "Passaggio 1 eseguito: Email a Maria Lopez".

Per test rapidi, puoi ridurre temporaneamente il tempo di attesa a 1 minuto. Ricorda di ripristinarlo prima di passare in produzione.

Passo 6: Verifica che l'escalation funziona

Vai su Allarmi > Escalation > Registro.
Cerca la voce dell'allarme che hai appena testato.
Verifica i dettagli:

Tempo	Passaggio	Canale	Destinatario	Stato
+15 min	1	Email	Maria Lopez	Inviato
+30 min	2	WhatsApp	Roberto Sanchez	In attesa (o Inviato se hai aspettato 30 min)

Dovresti vedere il registro completo di escalation con i timestamp e gli stati di ogni passaggio.

Per fermare l'escalation, riconosci l'allarme facendo clic su Riconosci nella pagina dell'allarme.

Riconoscere l'allarme ferma la catena di escalation immediatamente. I passaggi in attesa vengono annullati automaticamente.

Riepilogo

Passo	Azione	Risultato
1	Creare regola di escalation	Regola con trigger alarm_unack a 15 min
2	Aggiungere passaggio 1	Email al supervisore configurata
3	Aggiungere passaggio 2	WhatsApp al manager a 30 min
4	Collegare all'allarme	Escalation associata alla regola di allarme
5	Testare con evento	Allarme generato e escalation avviata
6	Verificare registro	Catena di escalation eseguita correttamente

Prossimi passi

Configura livelli multipli di escalation per catene piu complesse
Integra con sistemi esterni per notificare strumenti come Slack o PagerDuty
Rivedi le best practice ISA 18.2 per la gestione professionale degli allarmi

Scala automaticamente gli allarmi ai supervisori

In questa pagina