Twilio Voce
Twilio Voce è il collegamento con cui la segreteria telefonica automatica risponde al numero del laboratorio. Account, numero e traffico sono del laboratorio, e le credenziali le inserisce il laboratorio stesso dall’app. Twilio porta la chiamata e trasforma la voce in testo; quello che l’assistente dice e fa lo decide il gestionale.
Chiave del laboratorioCosa fa
Il numero di telefono su cui risponde la segreteria telefonica automatica.
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 inseriti dal laboratorio in Integrazioni → «Twilio — SMS, WhatsApp, centralino»
- Un numero con capacità voce sull’account, registrato in Integrazioni → «Segreteria telefonica»
- Indirizzo pubblico dell’installazione impostato in Integrazioni → «Indirizzo pubblico»: su quello Twilio chiama i webhook e si verifica la firma
- Facoltativo: un mittente SMS con l’invio verso l’Italia abilitato, per l’SMS di conferma e i promemoria
Come funziona
Quando arriva una chiamata, Twilio avvisa il gestionale sull’indirizzo `/api/voice/incoming`. Il laboratorio viene riconosciuto dal numero chiamato, mai da un dato scelto da chi chiama.
A ogni turno Twilio riconosce il parlato in italiano o i tasti premuti, e il gestionale risponde con le frasi fisse della segreteria, lette con una voce neurale italiana.
Per il trasferimento alla segreteria umana e per «Richiama ora» il gestionale chiede a Twilio di comporre il numero, con il numero del laboratorio come chiamante. La registrazione delle chiamate non viene mai attivata.
Sicurezza
Ogni richiesta di Twilio è verificata con la firma HMAC calcolata con l’Auth Token del laboratorio, prima di leggere o scrivere qualsiasi dato. Firma assente o non valida: la richiesta viene rifiutata.
Senza credenziali Twilio le rotte vocali rispondono 503: il servizio resta chiuso, non si apre mai senza controlli.
L’Auth Token è salvato nel database del laboratorio e letto solo dal server: al pannello arriva soltanto «presente» o «assente».
Limiti
Il riconoscimento vocale lo fa Twilio: l’audio della chiamata passa dai suoi server, sul contratto del laboratorio. Valuta il trattamento con il fornitore.
Per un numero italiano Twilio richiede una documentazione regolamentare prima dell’attivazione: servono alcuni giorni.
Molti numeri italiani non inviano SMS. Senza un mittente SMS la segreteria conferma la prenotazione a voce, ma l’SMS con il codice non parte.
Come si attiva
- Aprite un account Twilio a nome del laboratorio e prendete un numero con la voce.
- In LabBox andate su Integrazioni → «Twilio — SMS, WhatsApp, centralino», incollate le credenziali e premete «Verifica».
- Nel pannello «Segreteria telefonica» scrivete il numero, il nome con cui l’assistente si presenta e il numero della vostra segreteria: il pannello vi mostra gli indirizzi da incollare in Twilio e cosa manca ancora.
Per il tecnico
- Apri un account Twilio a nome del laboratorio e copia Account SID e Auth Token in Integrazioni → «Twilio — SMS, WhatsApp, centralino».
- Acquista un numero con capacità voce (per l’Italia completa la documentazione regolamentare richiesta da Twilio).
- In Twilio, sul numero, Voice Configuration → «A call comes in» → Webhook → `https://<indirizzo pubblico>/api/voice/incoming`, HTTP POST.
- Sullo stesso numero, «Call status changes» → Webhook → `https://<indirizzo pubblico>/api/voice/status`, HTTP POST: chiude subito nel registro le chiamate interrotte da chi riattacca. Non attivare la registrazione delle chiamate.
- Se usi l’SMS: sul numero mittente, Messaging Configuration → «A message comes in» → Webhook → `https://<indirizzo pubblico>/api/sms/incoming`, HTTP POST, per le risposte «1» / «2» ai promemoria.
- In Integrazioni → «Segreteria telefonica» registra il numero, il nome con cui l’assistente si presenta e il numero della segreteria umana. Il pannello mostra gli indirizzi esatti da incollare in Twilio e cosa manca ancora.
- Chiama il numero e prova una prenotazione, la richiesta degli orari e «operatore».
Domande frequenti
Chi paga le telefonate?
Il laboratorio, sul proprio account Twilio e al listino Twilio in vigore. Il gestionale non rivende traffico e non applica margini.
Serve un centralino o un altro fornitore di agenti vocali?
No. Bastano un account Twilio e un numero: la logica della segreteria gira nel gestionale del laboratorio, senza fornitori intermedi.
Le chiamate vengono registrate?
No. La registrazione non viene mai attivata e l’audio non viene conservato dal gestionale.
Moduli che la usano
Twilio Voce lavora insieme a questi moduli di LabBox.
Vuoi vedere Twilio Voce collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.