Skip to main content

​
Prima di iniziare

Twilio è il servizio che permette alla tua applicazione di effettuare e ricevere chiamate e di inviare SMS. La tua app fornisce l’interfaccia; Twilio fornisce l’infrastruttura telefonica globale che c’è dietro. Per collegarlo, ti serviranno due credenziali del tuo account Twilio: Account SID e Auth Token. Sono le “chiavi” che autorizzano la tua applicazione a utilizzare il tuo account Twilio. Requisiti:
  • Un account Twilio attivo.
  • Accesso amministratore al CMS della tua applicazione.
  • Consigliato: abilita l’autenticazione a due fattori in Twilio e conserva le credenziali in un password manager sicuro.

​
Passaggio 1: Aprire il CMS e accedere a Integrazioni

Apri il CMS da questo link diretto: vai al CMS.
Nel menu a sinistra, seleziona Integrations e poi Twilio. Vedrai un pannello con due voci: account_sid e auth_token. Twilio è contrassegnato come “Required” perché senza di esso le funzionalità di telefonia non funzioneranno.

​
Passaggio 2: Recuperare le credenziali da Twilio

Accedi alla tua Twilio Console.
Nella Dashboard del progetto vedrai Account SID e Auth Token sotto “Project Info” (il token potrebbe essere nascosto; fai clic su “show” per visualizzarlo). Copia entrambi i valori. Assicurati di usare le credenziali live, non quelle di test. Esempi: Account SID: YOUR_ACCOUNT_SID
Auth Token: YOUR_AUTH_TOKEN Suggerimento: tratta l’Auth Token come una password. Non condividerlo via email o chat.

​
Passaggio 3: Aggiungere le chiavi nel CMS

Nella sezione Twilio del CMS:
Fai clic su Add API Key. Inserisci i dati dell’Account SID esattamente così:
  • Key Name: account_sid (valore predefinito – non modificarlo)
  • Key Value: YOUR_ACCOUNT_SID
  • Description: Twilio Account SID
  • Active: selezionato
Salva con Save Key. Ripeti lo stesso processo per l’Auth Token:
  • Key Name: auth_token (valore predefinito – non modificarlo)
  • Key Value: YOUR_AUTH_TOKEN
  • Description: Twilio Auth Token
  • Active: selezionato
Salva con Save Key. Note importanti:
  • I nomi delle chiavi devono restare esattamente account_sid e auth_token (tutto minuscolo, con underscore).
  • Mantieni entrambe le chiavi Active. Se una delle due è inattiva, l’integrazione non funzionerà.

​
Passaggio 4: Verificare che l’integrazione sia attiva

Dopo aver salvato, vedrai entrambe le chiavi elencate con stato Active. Controlli rapidi:
  • Aggiorna la pagina Integrations e verifica che Twilio non mostri avvisi.
  • Se hai già un agente configurato, avvia una chiamata di test dalla sezione Agents. Se la chiamata si connette, Twilio è integrato correttamente.

​
Configurazione avanzata (opzionale)

  • Rotazione del token: se sospetti che l’Auth Token sia stato esposto, generane uno nuovo in Twilio e aggiornalo immediatamente nel CMS.
  • Subaccount: se gestisci più ambienti o clienti, puoi usare un subaccount Twilio separato (SID e token) per ogni progetto, così separi fatturazione e utilizzo.
  • Buone pratiche di sicurezza: conserva l’Auth Token in un password manager, limita chi può visualizzarlo e controlla gli accessi alla Twilio Console.

​
Errori comuni e soluzioni

  • Chiavi lasciate inattive: sia account_sid che auth_token devono essere impostate su Active.
  • Modifica dei nomi chiave: devono restare esattamente account_sid e auth_token. Qualsiasi variazione rompe l’integrazione.
  • Copia/incolla con spazi: assicurati che non ci siano spazi iniziali o finali nei valori.
  • Uso di credenziali di test: in produzione servono credenziali live.
  • Dimenticare di salvare: fai sempre clic su Save Key dopo aver inserito i valori.
  • Token rigenerato ma non aggiornato: se rigeneri l’Auth Token in Twilio ma non lo aggiorni nel CMS, le chiamate falliranno.

​
Comunicazione affidabile con Twilio

Una volta collegato, la tua applicazione potrà effettuare chiamate e inviare SMS in modo affidabile. Mantieni le chiavi attive, sicure e aggiornate, e avrai una base solida per scalare i tuoi flussi di comunicazione.