← Torna al Centro Assistenza
Cos'è la pagina Destinatari Notifiche?
È la pagina di Amministrazione Sistema dove configuri, per ogni tipo di evento (es. "scadenza contratto", "assenza addetto segnalata", "DPI in scadenza"), chi deve ricevere la notifica e tramite quale canale (WhatsApp o interno).
💡 A cosa serve: Centralizza la gestione delle notifiche, così puoi decidere con precisione chi viene avvisato per ogni evento, senza dover modificare il codice.
📐 Layout della pagina
La pagina mostra un blocco per ogni tipo di evento configurato nel sistema. Ogni blocco contiene:
- Titolo: descrizione dell'evento (es. "Scadenza contratto cantiere").
- Template: il testo della notifica (con placeholder tipo
{nome_cliente}).
- Tabella destinatari: elenco di chi riceve la notifica, con canale, tipo, valore, note e stato attivo.
- Form "Aggiungi destinatario": in fondo al blocco, per aggiungere nuovi destinatari a quell'evento.
👥 I 6 tipi di destinatario
Puoi scegliere tra 6 modalità di destinazione, ognuna con un campo valore diverso:
👤 Utente specifico
Seleziona un utente dal menu a tendina. Riceve la notifica solo lui.
👷 Addetto specifico
Seleziona un addetto dal menu. Riceve la notifica solo lui (utile per eventi legati a una persona).
👥 Gruppo di lavoro
Seleziona un gruppo da Gruppi di Lavoro. Tutti i membri ricevono la notifica.
📊 Utenti con livello minimo
Scegli un livello (0-10): tutti gli utenti con livello ≥ ricevono la notifica.
📱 Numero WhatsApp manuale
Inserisci un numero di telefono (es. +39 333 1234567). Utile per numeri esterni al sistema.
🎯 L'addetto coinvolto
Automatico: riceve la notifica l'addetto stesso coinvolto nell'evento (es. "il tuo contratto scade").
💡 Nota: quando cambi il "Tipo Destinatario" nel form, il campo "Valore" si aggiorna automaticamente mostrando il campo giusto (select utente, select addetto, select gruppo, select livello o input testo per il numero manuale).
➕ Aggiungere un destinatario a un evento
- Vai su Amministrazione Sistema → Destinatari Notifiche.
- Scorri fino al blocco dell'evento a cui vuoi aggiungere un destinatario.
- Nel form in fondo al blocco, compila:
- Canale: WhatsApp (default) o Interno.
- Tipo Destinatario: scegli tra i 6 tipi disponibili.
- Valore: a seconda del tipo, seleziona utente/addetto/gruppo/livello o inserisci il numero manuale.
- Note (opzionale): descrizione del collegamento (es. "Responsabile di zona").
- Clicca "➕ Aggiungi".
✅ Suggerimento: dopo aver aggiunto il destinatario, la pagina ti riporta automaticamente al blocco dell'evento (scroll all'ID #evt-nome_evento), così vedi subito la nuova riga nella tabella.
🔄 Attivare / Disattivare un destinatario
Nella tabella dei destinatari, ogni riga ha un pulsante "🔄":
- Attivo (Sì, badge verde): il destinatario riceve le notifiche.
- Disattivato (No, badge grigio): il destinatario NON riceve più le notifiche, ma la configurazione resta salvata.
Clicca il pulsante per cambiare lo stato. Utile per sospendere temporaneamente una notifica senza eliminare la configurazione.
🗑️ Eliminare un destinatario
- Nella tabella dei destinatari, clicca "🗑️" sulla riga da rimuovere.
- Conferma nel popup di conferma.
- Il destinatario viene eliminato definitivamente da quell'evento.
⚠️ Attenzione: l'eliminazione è definitiva. Se vuoi solo sospendere temporaneamente, usa il pulsante "🔄" per disattivare il destinatario invece di eliminarlo.
📱 Canali di notifica
Ogni destinatario può essere configurato su uno di questi canali:
- WhatsApp (default): il messaggio viene inviato al numero di telefono dell'utente/addetto/gruppo tramite la coda di invio WhatsApp (gestita dal cron
cron_invia_whatsapp_coda.php).
- Interno: il messaggio appare nella colonna "Notifiche" del Menu Principale, visibile solo agli utenti interni del sistema.
💡 Nota: lo stesso destinatario può essere configurato su entrambi i canali (creando due righe separate), così riceve la notifica sia via WhatsApp sia nel menu interno.
🔗 Collegamento con i Gruppi di Lavoro
Il tipo destinatario "Gruppo di lavoro" si appoggia ai gruppi configurati nella pagina Gruppi di Lavoro. Quando selezioni un gruppo come destinatario:
- Tutti i membri del gruppo ricevono la notifica.
- Il gruppo deve essere già associato a un contesto cantiere completo (Cliente → Filiale → Reparto → Contratto → Turno).
- Se il gruppo viene eliminato, il collegamento al tipo di evento viene rimosso automaticamente.
💡 Alternativa: puoi anche creare il collegamento dalla tab "🔔 Notifiche" del gruppo stesso, nella pagina Gruppi di Lavoro. È la stessa cosa, cambia solo il punto di partenza.
❓ Domande Frequenti
Non vedo nessun tipo di evento nella pagina, perché?
I tipi di evento sono configurati nella tabella sistema_messaggi_tipi del database. Se la pagina è vuota, significa che non sono ancora stati creati tipi di evento per la tua azienda. Contatta l'amministratore di sistema per configurarli.
Posso avere più destinatari per lo stesso evento?
Sì, assolutamente. Puoi aggiungere tutti i destinatari che vuoi per ogni evento, anche combinando tipi diversi (es. un utente specifico + un gruppo di lavoro + un numero manuale). Tutti riceveranno la notifica quando l'evento si verifica.
Cosa significa "L'addetto coinvolto" come destinatario?
È un destinatario automatico: il sistema identifica l'addetto coinvolto nell'evento e gli invia la notifica. Ad esempio, per l'evento "scadenza contratto", l'addetto coinvolto è il dipendente il cui contratto sta per scadere. Non serve selezionare nulla: il sistema fa tutto da solo.
Il numero WhatsApp manuale deve avere il prefisso internazionale?
Sì, è consigliato inserire il numero completo con prefisso (es. +39 333 1234567 per l'Italia). Il sistema compone automaticamente il numero per l'invio WhatsApp, ma se manca il prefisso potrebbe non funzionare correttamente per numeri esteri.
Perché un destinatario attivo non riceve le notifiche?
Controlla: (1) il destinatario è davvero attivo (badge verde, non grigio); (2) l'utente/addetto ha un numero di telefono valido in anagrafica; (3) la coda di invio WhatsApp funziona (verifica il cron cron_invia_whatsapp_coda.php); (4) per i gruppi, verifica che i membri abbiano numeri di telefono configurati.
Posso usare un livello 0 come destinatario?
Sì. Il livello 0 significa "tutti gli utenti dell'azienda", indipendentemente dal loro livello di permesso. Utile per notifiche generali da inviare a tutta l'azienda (es. "chiusura ufficio per ferie").
Come faccio a sapere quali eventi posso configurare?
Ogni blocco nella pagina rappresenta un tipo di evento già configurato nel sistema. I più comuni sono: "scadenza contratto cantiere", "addetto contratto scadenza", "assenza addetto segnalata", "permesso ferie imminente", "dpi_scadenza", "automezzo_scadenza". Se hai bisogno di un nuovo tipo di evento, contatta l'amministratore di sistema.