Creare e gestire le notifiche

La gestione delle notifiche si basa sulla creazione di un Evento (per ricevere e interpretare i dati da fonti esterne) e sulla configurazione di Output (per inviare comunicazioni condizionali a destinatari specifici).

Disponibile solo per utenti con permesso backoffice. Per creare un evento è necessario che nel sistema siano già presenti le entità a cui l’evento deve essere collegato: progetto, oggetto, sensore o dispositivo.

Creare un Evento

Un Evento consente alla piattaforma di ricevere e interpretare informazioni (tipicamente JSON) da provider esterni, collegandole a un'entità (Organizzazione, Progetto, Oggetto, Sensore, Dispositivo).

Passaggi

Accedi al Backoffice e clicca su Eventi.
Clicca sul bottone Nuovo evento.
Configurazione di Base:
- Inserisci il Nome evento.
- Collega l'entità: Seleziona l'entità a cui l'evento è associato (es. Progetto, Oggetto).
Sezione Mapping:
- Questa sezione definisce come i dati in arrivo (payload JSON) devono essere interpretati.
- Carica il payload di esempio: Incolla o carica un file JSON di esempio nella textbox e clicca Conferma per generare le chiavi di mappatura.
- Mappa le chiavi: Associa le chiavi del provider ai livelli di informazione previsti (Es. livello informativo, messaggio, priorità).
Salva l'evento cliccando Salva.

📝 Nota: Una volta salvato, appare un link URL nella lista che deve essere fornito al provider esterno per l'invio dei dati.

Gestione Rapida dalla Lista

Duplica: Appare se è selezionato un singolo Evento.
Elimina: Appare se è selezionato uno o più Eventi.
Copia URL: Bottone disponibile per copiare il link da fornire al provider.

Sezione 2: Impostare un Output per l'Evento (Direct List)

L'output, gestito tramite Direct List, definisce configurazioni condizionali per l'invio di notifiche (push o email) a specifici destinatari. Se nessun output è configurato, l'evento viene registrato ma non invia comunicazioni.

Passaggi

Dopo aver salvato l'evento, riaprilo e clicca sulla tab Output.
Clicca sul bottone Nuova lista (icona +).
Configura la Direct List:
- Inserisci un Nome lista descrittivo.
- Seleziona il Tipo di comunicazione (Email o Push).
- Seleziona l'Evento a cui si riferisce l'output.
Aggiungi Destinatari:
- Scegli gli utenti/gruppi che riceveranno la notifica e trascinali nella sezione Destinatari.
- Per Email, puoi aggiungere anche indirizzi email esterni.
Imposta la Condizione (Opzionale):
- Se vuoi limitare l'invio solo a specifiche occorrenze, clicca Aggiungi condizione.
- Definisci la Chiave (dell'evento) e il Valore che deve essere verificato per attivare l'invio (es. priorità = alta).
Salva la Direct List cliccando Salva.

💡 Suggerimento: È possibile creare un numero illimitato di Direct List per lo stesso evento, differenziando i destinatari e/o le condizioni.

Suggerimenti Utili

💡 Nomi Descrittivi: Usa nomi descrittivi sia per gli Eventi che per le Direct List per facilitare l'identificazione.
💡 Controlla il JSON: Prima di salvare l'Evento, assicurati che il JSON di esempio sia corretto per generare chiavi di mappatura valide.
💡 Evita duplicati: Quando duplichi una Direct List, modifica sempre almeno un parametro (es. i destinatari o la condizione) per evitare comunicazioni doppie.
💡 Condizioni d'invio: Imposta le condizioni sull'output solo se vuoi limitare l'invio; se non ci sono condizioni, la notifica viene inviata per ogni occorrenza dell'evento.

Problemi Comuni

Problema	Soluzione
Il bottone Salva resta disattivato (Evento)	Controlla che tutti i campi obbligatori (Nome, Entità collegata) siano compilati.
Le chiavi di mappatura non compaiono	Dopo aver incollato il JSON nella sezione Mapping, clicca Conferma.
I destinatari non vengono aggiunti (Output)	Verifica che il tipo di comunicazione sia coerente: gli indirizzi email esterni sono accettati solo nelle Direct List di tipo Email.
Le notifiche arrivano due volte	Controlla se esistono due Direct List identiche (stesso evento, stessi destinatari, stesse condizioni) e modificane una.

Collegamenti

Ultimo aggiornamento: Ottobre 2025