Canali di Notifica

Configurazione dei canali di notifica per email, WhatsApp e in-app con supporto multilingua.

Quando usare questa guida

Configura i canali di notifica quando il tuo team deve ricevere avvisi su attivita assegnate, allarmi delle apparecchiature o aggiornamenti di stato. Ogni canale ha punti di forza diversi: scegli quello giusto in base all'urgenza e al contesto.

Albero decisionale: quale canale usare

Situazione	Canale consigliato	Motivo
Notifica formale, necessita allegato o registro	Email	Tracciabilita completa, supporta documenti
Avviso urgente, tecnico in campo, mobile	WhatsApp	Consegna immediata, alto tasso di lettura su dispositivi mobili
Utente in dashboard, aggiornamento non urgente	In-App	Nessuna interruzione esterna, latenza < 1 secondo
Allarme critico apparecchiatura	WhatsApp + Email	Doppio canale per garantire la consegna del messaggio
Report settimanale conformita SLA	Email	Formato esteso con dati tabulari

Esempio pratico: Un compressore attiva un allarme critico alle 3:00. Il sistema invia una notifica WhatsApp al tecnico di turno (perche richiede attenzione immediata in campo) e un'email al supervisore (per il registro formale quando arriva in ufficio).

Panoramica

Rela AI supporta tre canali di notifica per mantenere informati i team di lavoro. Ogni notifica viene inviata attraverso i canali configurati in base alle preferenze del tenant e dell'utente.

Canale	Provider	Latenza tipica
Email	Postmark	< 5 secondi
WhatsApp	Evolution API	< 3 secondi
In-App	Ably (real-time)	< 1 secondo

Email (Postmark)

Le notifiche email utilizzano Postmark come provider di invio transazionale.

Template di oggetto e corpo

Ogni tipo di notifica ha template nelle 3 lingue supportate:

{
  "template_id": "task_assigned",
  "subject": {
    "es": "Nueva tarea asignada: {task_title}",
    "en": "New task assigned: {task_title}",
    "it": "Nuovo compito assegnato: {task_title}"
  },
  "body": {
    "es": "Se te ha asignado la tarea '{task_title}' con prioridad {priority}.",
    "en": "You have been assigned the task '{task_title}' with priority {priority}.",
    "it": "Ti è stato assegnato il compito '{task_title}' con priorità {priority}."
  }
}

Le variabili tra parentesi graffe {variable} vengono sostituite dinamicamente al momento dell'invio con i dati reali della notifica.

Configurazione Postmark

Il server Postmark viene configurato a livello di tenant con il server_token corrispondente.

WhatsApp (Evolution API)

Le notifiche WhatsApp vengono inviate tramite Evolution API, che si collega a un'istanza di WhatsApp Business.

Template dei messaggi

{
  "template_id": "alarm_triggered",
  "message": {
    "es": "Alarma activada en {asset_name}: {alarm_message}. Severidad: {severity}.",
    "en": "Alarm triggered on {asset_name}: {alarm_message}. Severity: {severity}.",
    "it": "Allarme attivato su {asset_name}: {alarm_message}. Gravità: {severity}."
  }
}

Il numero WhatsApp del destinatario deve essere verificato e in formato internazionale (es: +56912345678). I numeri senza codice paese verranno rifiutati.

In-App

Le notifiche in-app appaiono in tempo reale all'interno della dashboard.

Componenti

Icona campana nell'header con badge dei non letti
Dropdown con lista delle notifiche recenti
Navigazione alla risorsa correlata al clic

Aggiornamenti in tempo reale

Le notifiche in-app vengono consegnate tramite Ably, garantendo la consegna istantanea senza necessità di ricaricare la pagina.

Risoluzione della lingua

La lingua della notifica viene risolta nel seguente ordine:

Preferenza lingua dell'utente (se configurata)
Lingua del tenant (configurazione generale)
Spagnolo (fallback predefinito)

Tracciamento dei risultati

Ogni notifica inviata registra il suo risultato per canale:

Stato	Descrizione
`sent`	Consegnato con successo al provider
`failed`	Errore nell'invio (il motivo viene registrato)
`pending`	In coda di invio
`skipped`	Canale non configurato per l'utente

GET /api/v1/notifications/{notification_id}/results

La risposta include lo stato per ogni canale tentato, il timestamp di invio e il messaggio di errore in caso di fallimento.

Vedi anche

Personale — Email e telefono del personale determinano quali canali funzionano
Dipartimenti — Le notifiche vengono inviate al personale del dipartimento assegnato
Gestione SLA — Gli avvisi SLA usano questi canali per l'escalation
Creare un agente WhatsApp — Configura l'agente che gestisce i messaggi WhatsApp
Tempo reale — Tecnologia dietro le notifiche in-app

Canali di Notifica

In questa pagina