Notifiche push

Jonot invia una notifica di sistema ai clienti quando il loro biglietto passa a CALLED — anche quando la scheda del browser è in background o il telefono è bloccato. Le notifiche vengono inviate anche quando un biglietto saltato viene richiamato e poi chiamato di nuovo.

Come funziona

1. Un cliente sta per mettersi in coda e vede la schermata del selettore di code.
2. Sopra l’elenco delle code appare una scheda di attivazione push — il cliente tocca Avvisami e concede il permesso al browser prima di mettersi in coda.
3. Il suo browser registra un’iscrizione Web Push.
4. Il cliente si mette in coda e riceve un biglietto. L’iscrizione viene collegata al biglietto lato server.
5. Quando uno sportello chiama il biglietto, il server invia un messaggio push a tutte le iscrizioni attive per quel biglietto.
6. Il dispositivo del cliente si riattiva e mostra una notifica di sistema con il numero del biglietto, il nome della coda e la sede. Toccando la notifica si apre la schermata del biglietto.
7. Le iscrizioni vengono eliminate automaticamente quando il biglietto raggiunge uno stato definitivo (COMPLETED, CANCELED o NO_SHOW) oppure quando l’endpoint push scade (il browser si è disiscritto / il permesso è stato revocato).

I clienti che non hanno attivato le notifiche nel selettore di code possono comunque farlo dalla schermata del biglietto — una scheda di notifica viene mostrata mentre il biglietto è WAITING o CALLED.

Notifiche di richiamo per biglietti saltati

Se il biglietto di un cliente viene saltato (passa allo stato SKIPPED), la sua iscrizione push resta attiva. Quando il personale in seguito richiama il biglietto (riportandolo a WAITING) e poi lo chiama, il cliente riceve la notifica push — anche se ha chiuso la pagina del biglietto.

Questo significa che un cliente che ha attivato le notifiche e poi si è allontanato viene comunque avvisato quando il personale lo richiama, senza bisogno di tenere il browser aperto.

Attivazione — esperienza del cliente

Stato	Mostrato
Richiesta (permesso non ancora richiesto)	Scheda di invito all’attivazione (selettore di code + schermata biglietto)
Permesso concesso + iscritto	Conferma “Riceverai una notifica”
Permesso negato	Consiglio di ripiego + link alle impostazioni del browser
Browser non supportato	Niente (saltato silenziosamente)

Una volta iscritto, le notifiche push vengono recapitate dal browser anche quando la scheda è chiusa o il telefono è in background — i clienti non devono tenere aperta la pagina del biglietto.

Indicatore di riconnessione

Se il dispositivo del cliente perde la connessione WebSocket mentre la pagina del biglietto è aperta (ad esempio dopo una breve disconnessione), sullo schermo appare un’etichetta Connessione persa — riconnessione in corso…. Viene mostrata solo per i biglietti non definitivi e mai al caricamento iniziale della pagina. La connessione viene ripristinata automaticamente; non è richiesta alcuna azione manuale.

iOS — richiede la schermata Home

iOS Safari 16.4+ supporta Web Push, ma solo quando l’app è stata aggiunta alla schermata Home (modalità standalone). Nel browser Safari normale su iOS:

• Il selettore di code mostra sopra l’elenco delle code una scheda guida Aggiungi Jonot alla schermata Home per ricevere le notifiche.
• Dopo l’aggiunta alla schermata Home, il cliente riapre Jonot dall’icona della schermata Home e appare l’invito standard all’attivazione.

Attenzione

I clienti su iOS devono aggiungere Jonot alla propria schermata Home prima di poter ricevere notifiche push. L’app rileva automaticamente iOS e guida il cliente attraverso i passaggi.

Solo transazionali — nessun marketing

Le iscrizioni push sono collegate a un singolo biglietto. Sono strettamente transazionali: un’iscrizione esiste per il ciclo di vita di un biglietto. Non esiste alcun meccanismo per inviare push promozionali o di massa — solo gli eventi CALLED di un biglietto attivano una notifica.

GDPR / base di consenso: l’iscrizione è legata al biglietto che il cliente ha appena creato. La stessa base di consenso (interesse legittimo / esecuzione del contratto) che copre il biglietto stesso copre anche questa singola notifica. Non è richiesta alcuna raccolta separata del consenso.

Riferimento tecnico

• Standard: Web Push con crittografia del payload secondo RFC 8291 (AES-128-GCM) e richieste autenticate VAPID secondo RFC 8292.
• Memorizzazione delle iscrizioni: ogni iscrizione è legata a un biglietto e viene eliminata automaticamente quando quel biglietto raggiunge uno stato definitivo.