Web Push (VAPID)
Le notifiche push avvisano operatori e pazienti direttamente sul dispositivo, anche con l’app PWA chiusa. Le chiavi VAPID si generano in locale durante l’installazione: non c’è nessun fornitore da contrattualizzare. Servono per gli avvisi che non possono aspettare la prossima apertura del gestionale.
Generata in installazioneCosa fa
Notifiche push dell’app PWA.
Categoria: comunicazioni — Email, SMS, WhatsApp, telefono e notifiche push verso pazienti e operatori.
Cosa serve
- Sito servito in HTTPS con service worker attivo
Come funziona
Il browser si registra al servizio push e invia l’abbonamento al gestionale, che lo associa all’utente della sessione.
Quando parte un avviso il server firma il messaggio con la chiave privata VAPID e lo consegna al servizio push del browser.
Il testo che esce dall’infrastruttura è volutamente generico: la notifica dice che c’è un aggiornamento e rimanda alla schermata, senza contenuto clinico.
Gli abbonamenti che il servizio push dichiara scaduti vengono disattivati da soli; gli invii falliti passano in coda con nuovi tentativi scaglionati.
Cosa ottieni
Valori critici, referti da validare e scadenze arrivano senza aprire la posta.
Il paziente riceve l’avviso “referto disponibile” sull’app installata, senza costi per messaggio.
Limiti
Senza coppia VAPID la notifica viene comunque salvata dentro il gestionale, ma nessun avviso raggiunge il dispositivo: la risposta lo dichiara esplicitamente.
Serve HTTPS e, su iPhone, l’installazione dell’app PWA nella schermata home.
Ruotare le chiavi invalida tutti gli abbonamenti esistenti: gli utenti devono riautorizzare le notifiche.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- Nessun account esterno: la coppia di chiavi si genera in locale con `npx web-push generate-vapid-keys`
- `NEXT_PUBLIC_VAPID_PUBLIC_KEY` — metà pubblica, usata anche dal browser
- `VAPID_PRIVATE_KEY` — metà privata, solo lato server
- `VAPID_SUBJECT` — indirizzo `mailto:` di contatto tecnico del laboratorio
- Genera la coppia di chiavi con `npx web-push generate-vapid-keys` (lo script di installazione lo fa per te).
- Scrivi le due metà in `NEXT_PUBLIC_VAPID_PUBLIC_KEY` e `VAPID_PRIVATE_KEY`, e imposta `VAPID_SUBJECT`.
- Rifai il deploy: la chiave pubblica viene inclusa nel bundle al momento della build.
- Apri il gestionale, accetta il permesso notifiche e controlla che l’abbonamento compaia tra i dispositivi registrati.
- Invia una notifica di prova e verifica che il conteggio dei recapiti sia diverso da zero.
Domande frequenti
Ci sono costi?
No. Le chiavi sono generate in locale e la consegna passa dai servizi push dei browser, senza contratto né tariffa a messaggio.
Cosa succede se non genero le chiavi?
Le notifiche restano dentro il gestionale e la risposta segnala che il push non è configurato. Non viene dichiarato un recapito che non è avvenuto.
Il contenuto clinico esce dal mio server?
No. Il testo consegnato al servizio push è una frase generica; il dato si legge solo dopo l’accesso al gestionale.
Moduli che la usano
Web Push (VAPID) lavora insieme a questi moduli di LabBox.
Vuoi vedere Web Push (VAPID) collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.