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
Collegamenti
Nozioni di base sulle notifiche
Ultimo aggiornamento: Ottobre 2025