Twilio SMS
Twilio SMS serve a far arrivare promemoria e avvisi brevi sul telefono del paziente, anche senza smartphone o app. Il numero mittente e il credito sono del laboratorio. È la scelta tipica per ridurre i mancati appuntamenti e per le conferme della segreteria telefonica.
Chiave del laboratorioCosa fa
Promemoria e notifiche via SMS.
Categoria: comunicazioni — Email, SMS, WhatsApp, telefono e notifiche push verso pazienti e operatori.
Cosa serve
- Account Twilio intestato al laboratorio, con credito attivo
- Account SID e Auth Token della console Twilio, inseriti dal laboratorio nell’app: Integrazioni → «Twilio — SMS, WhatsApp, centralino»
- Numero mittente con capacità SMS sul tuo account, indicato nello stesso pannello (molti numeri italiani non hanno la capacità SMS)
- Invio di SMS verso l’Italia abilitato nella console Twilio (Messaging → Settings → Geo permissions)
Come funziona
Il gestionale chiama una rotta interna protetta da ruolo, che invia l’SMS con l’account Twilio del laboratorio. Nelle installazioni precedenti, senza credenziali salvate nell’app, passa ancora dalla funzione di invio SMS.
La funzione parla con l’API di Twilio e restituisce l’identificativo del messaggio e lo stato. L’esito viene registrato accanto alla notifica.
Lo stesso canale è usato dalle automazioni: promemoria a 24, 2 e 1 ora dall’appuntamento e conferme della segreteria telefonica automatica. L’avviso dei valori critici al medico per SMS è predisposto e va attivato in installazione.
Il promemoria della segreteria telefonica chiede una risposta: il paziente scrive «1» per confermare o «2» per disdire, e la risposta torna al gestionale tramite un webhook verificato con la firma.
Quando serve
Quando la posta elettronica non basta: pazienti anziani, promemoria last minute, avvisi che devono essere letti subito.
Quando un valore critico deve raggiungere il responsabile anche fuori dal gestionale: l’avviso va attivato in installazione.
Limiti
Ogni SMS ha un costo a messaggio sul tuo account Twilio. La lunghezza del testo incide sul numero di segmenti fatturati: per questo i testi escono nell’alfabeto GSM-7, dove un segmento vale 160 caratteri invece di 70.
Senza credenziali le schermate che inviano SMS mostrano un banner “non configurato” e la rotta risponde con un errore, mai con un finto invio.
Numero e testo passano da Twilio: nei messaggi vanno evitati dati clinici, basta l’avviso con rimando all’area riservata.
Come si attiva
- Aprite un account Twilio a nome del laboratorio.
- In LabBox andate su Integrazioni → «Twilio — SMS, WhatsApp, centralino» e incollate le credenziali dell’account.
- Premete «Verifica»: LabBox chiede a Twilio lo stato dell’account e controlla che il numero sia vostro. Nessun riavvio del programma.
Per il tecnico
- Solo per installazioni precedenti: le variabili `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN` e `TWILIO_PHONE_NUMBER` restano come ripiego, usate solo se il laboratorio non ha salvato credenziali nell’app
- Apri un account Twilio a nome del laboratorio e ricaricalo.
- Acquista o registra un numero mittente con capacità SMS e abilita l’invio verso l’Italia (Messaging → Settings → Geo permissions).
- In LabBox apri Integrazioni → «Twilio — SMS, WhatsApp, centralino» e inserisci Account SID, Auth Token e numero mittente. Il token resta sul server: il pannello mostra solo «presente» o «assente». Non serve alcun nuovo deploy.
- Per le risposte «1» / «2» ai promemoria: sul numero mittente, in Twilio, Messaging Configuration → «A message comes in» → Webhook → `https://<indirizzo pubblico>/api/sms/incoming`, HTTP POST. Il pannello della segreteria telefonica mostra l’indirizzo esatto.
- Invia un SMS di prova a un numero interno e verifica lo stato restituito.
Domande frequenti
Chi paga gli SMS?
Il laboratorio, sul proprio contratto Twilio. Il gestionale non rivende traffico e non applica margini.
Se non configuro Twilio perdo i promemoria?
Perdi solo il canale SMS. Le notifiche restano nel gestionale e, se configurata, l’email continua a partire.
Posso scrivere l’esito dell’esame nell’SMS?
Tecnicamente sì, ma è sconsigliato: il testo transita dall’operatore. Il messaggio standard avvisa e rimanda all’area riservata.
Ho già le variabili d’ambiente Twilio: devo cambiare qualcosa?
No, continuano a valere finché il laboratorio non salva le credenziali nell’app. Da quel momento vale solo la configurazione salvata: i campi mancanti non vengono presi dalle variabili, così due account non si mescolano.
Moduli che la usano
Twilio SMS lavora insieme a questi moduli di LabBox.
Promemoria, richiami e fidelizzazione automatizzati.
Segreteria telefonica automaticaRisponde al numero del laboratorio e prenota sui posti liberi veri dell’agenda.
Accettazione, CUP e agendePrenotazioni, code e front-office senza attriti.
LIMS — gestione campioni e risultatiIl flusso analitico dall’accettazione tecnica alla validazione.
Vuoi vedere Twilio SMS collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.