Skip to main content

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

 

  1. Accedi al Backoffice e clicca su Eventi.

  2. Clicca sul bottone Nuovo evento.

  3. Configurazione di Base:

    • Inserisci il Nome evento.

    • Collega l'entità: Seleziona l'entità a cui l'evento è associato (es. Progetto, Oggetto).

  4. 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à).

  5. 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

 

  1. Dopo aver salvato l'evento, riaprilo e clicca sulla tab Output.

  2. Clicca sul bottone Nuova lista (icona +).

  3. 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.

  4. Aggiungi Destinatari:

    • Scegli gli utenti/gruppi che riceveranno la notifica e trascinali nella sezione Destinatari.

    • Per Email, puoi aggiungere anche indirizzi email esterni.

  5. 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).

  6. 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

 

ProblemaSoluzione
Il bottone Salva resta disattivato (Evento)Controlla che tutti i campi obbligatori (Nome, Entità collegata) siano compilati.
Le chiavi di mappatura non compaionoDopo 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 volteControlla se esistono due Direct List identiche (stesso evento, stessi destinatari, stesse condizioni) e modificane una.

 

Collegamenti

 

Ultimo aggiornamento: Ottobre 2025

Back to top