Twilio WhatsApp
Twilio WhatsApp porta promemoria e risposte automatiche sul canale che i pazienti usano davvero. Il numero WhatsApp Business e il traffico sono del laboratorio. Serve quando la segreteria riceve molte domande ripetitive su orari, preparazione esami e ritiro referti.
Chiave del laboratorioCosa fa
Messaggi e chatbot su WhatsApp.
Categoria: comunicazioni — Email, SMS, WhatsApp, telefono e notifiche push verso pazienti e operatori.
Cosa serve
- Account Twilio del laboratorio con canale WhatsApp attivo
- Numero WhatsApp Business approvato e profilo aziendale verificato
- Template di messaggio approvati per gli invii fuori dalla finestra di 24 ore
- Indirizzo pubblico dell’installazione impostato in Integrazioni → «Indirizzo pubblico»: è l’indirizzo su cui si verifica la firma del webhook
Come funziona
In uscita il gestionale invia il messaggio tramite Twilio, usando il numero WhatsApp del laboratorio.
In ingresso Twilio inoltra i messaggi del paziente a un webhook del gestionale. La firma della richiesta viene verificata prima di leggere qualsiasi contenuto.
Il risponditore riconosce alcune richieste ricorrenti — referto, prenotazione, orari, prezzi, urgenza — e risponde con il testo previsto. La conversazione resta tracciata nel registro chat.
Quando serve
Per assorbire le domande di primo livello senza occupare il telefono della segreteria.
Per i promemoria a pazienti che leggono WhatsApp e ignorano email e SMS.
Limiti
Il risponditore lavora su parole chiave: non prenota da solo e non interpreta richieste complesse. È un filtro, non un operatore.
WhatsApp consente il testo libero solo entro la finestra di 24 ore dall’ultimo messaggio del paziente. Fuori da quella finestra servono template approvati da Meta.
Senza l’Auth Token del laboratorio il webhook risponde 503 e non legge nulla: nessun messaggio viene elaborato.
Come si attiva
- Aprite un account Twilio a nome del laboratorio e attivate il canale WhatsApp (Twilio chiede la verifica del profilo aziendale).
- In LabBox andate su Integrazioni → «Twilio — SMS, WhatsApp, centralino» e incollate le credenziali e il mittente WhatsApp.
- Premete «Verifica»: LabBox chiede a Twilio lo stato dell’account. Nessun riavvio del programma.
Per il tecnico
- Account SID, Auth Token e mittente WhatsApp (`whatsapp:+39…`) inseriti dal laboratorio in Integrazioni → «Twilio — SMS, WhatsApp, centralino»; senza mittente le risposte WhatsApp non sono configurate
- Solo per installazioni precedenti: `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `TWILIO_WHATSAPP_FROM` e `NEXT_PUBLIC_SITE_URL` restano come ripiego, se il laboratorio non ha salvato nulla nell’app
- Attiva il canale WhatsApp sul tuo account Twilio e completa la verifica del profilo aziendale.
- In LabBox apri Integrazioni → «Twilio — SMS, WhatsApp, centralino» e inserisci Account SID, Auth Token e il mittente WhatsApp approvato. Non serve alcun nuovo deploy.
- In Integrazioni → «Indirizzo pubblico» verifica che l’indirizzo coincida con quello con cui Twilio raggiunge l’installazione: la firma si verifica su quello.
- In Twilio imposta come webhook in ingresso `https://<indirizzo pubblico>/api/webhooks/whatsapp`, HTTP POST.
- Fai approvare i template per promemoria e avvisi fuori finestra.
- Scrivi al numero da un telefono di prova e controlla la risposta e il registro conversazioni.
Domande frequenti
Il traffico WhatsApp chi lo paga?
Il laboratorio, sul proprio account Twilio, secondo le tariffe per conversazione di WhatsApp Business.
Se non lo configuro cosa perdo?
Solo il canale WhatsApp. Il webhook resta chiuso e le altre notifiche non cambiano.
Il chatbot può dare un risultato di esame?
No. Risponde su orari, preparazione e stato del ritiro, e rimanda sempre all’area riservata per il referto.
Moduli che la usano
Twilio WhatsApp lavora insieme a questi moduli di LabBox.
Vuoi vedere Twilio WhatsApp collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.