Messaggi SMS/WhatsApp (Twilio)
Invia e ricevi SMS e WhatsApp usando il tuo account Twilio (modello BYO), direttamente dal contatto o dal lead.
L'integrazione Messaggi usa il TUO account Twilio (modello BYO, cioè porta il tuo account). I messaggi partono e vengono addebitati sul tuo account Twilio: non c'è alcun costo, margine o intermediazione da parte nostra. Noi programmiamo soltanto i campi e il pulsante per inviare SMS/WhatsApp e per registrare le risposte.
L'integrazione nasce inerte: non parte nulla finché non compili i campi e non la attivi. L'Auth Token resta cifrato nel CRM e non viene mai mostrato di nuovo.
Prerequisiti
- Un account Twilio con credito o piano attivo e un numero Twilio abilitato agli SMS (e, per WhatsApp, un sender WhatsApp approvato su Twilio).
- L'accesso alla Console Twilio per leggere l'Account SID e l'Auth Token e per configurare il webhook del numero.
- In Sellio, essere amministratore per salvare le credenziali e attivare l'integrazione in Impostazioni → Integrazioni.
Che cosa devi compilare
- Account SID: l'identificativo del tuo account Twilio, che trovi nella Console Twilio (inizia con AC...).
- Auth Token: il token di autenticazione dell'account, sempre nella Console Twilio (resta cifrato nel CRM).
- Numero SMS (mittente): un numero Twilio abilitato agli SMS, in formato E.164 (es.: +15005550006). Serve per inviare SMS.
- Numero WhatsApp (mittente): il tuo sender WhatsApp approvato su Twilio, in formato E.164 (senza il prefisso whatsapp:). Serve per inviare WhatsApp.
Come si configura
- Apri Impostazioni → Integrazioni e individua la scheda "Messaggi SMS/WhatsApp (Twilio)".
- Incolla l'Account SID e l'Auth Token, indica il numero SMS e/o WhatsApp e clicca su "Salva credenziali".
- Copia l'"URL del webhook (Twilio)" che compare e, nella Console Twilio, sul tuo numero, punta il campo "A message comes in" (webhook) e lo "Status callback URL" a quell'indirizzo.
- Torna nel CRM e clicca su "Attiva".
Come si invia un messaggio
- Apri un Contatto o un Lead che abbia un numero di telefono (campo Telefono o Cellulare).
- Nel riquadro "Messaggi (SMS/WhatsApp)" clicca su "Invia SMS/WhatsApp".
- Scegli il canale (SMS o WhatsApp), controlla il numero, scrivi il messaggio e clicca su "Invia".
- Il messaggio viene registrato nella cronologia del record (e nella timeline). Le risposte del cliente arrivano dal webhook e compaiono nella stessa cronologia.
Tratta l'URL del webhook e l'Auth Token come dati segreti (per sicurezza il CRM non ti rimostra il token salvato). Il CRM verifica la firma X-Twilio-Signature delle chiamate in arrivo usando il tuo Auth Token.
Come testare
- Apri un Contatto o un Lead con numero di telefono e, nel riquadro "Messaggi (SMS/WhatsApp)", clicca su "Invia SMS/WhatsApp".
- Scegli il canale, scrivi un messaggio breve e invialo a un tuo numero.
- Verifica che il messaggio sia arrivato sul cellulare e che sia rimasto registrato nella cronologia del record.
- Rispondi dal cellulare e controlla che la risposta compaia nella stessa cronologia: così validi il webhook in entrata.
Risoluzione dei problemi
- 401/authenticate: Account SID o Auth Token sbagliati. Reincolla l'Auth Token (il server non lo restituisce) e controlla l'Account SID (inizia con AC).
- Errore in invio o numero non valido: usa il formato E.164 (es.: +393331112233) nel mittente e verifica che il numero Twilio sia abilitato per quel canale (SMS o WhatsApp) e per il paese di destinazione.
- WhatsApp non invia: il sender WhatsApp deve essere approvato su Twilio e va indicato senza il prefisso whatsapp:. Fuori dalla finestra di 24 ore, WhatsApp richiede un template approvato.
- Non ricevo le risposte: nella Console Twilio, sul tuo numero, punta "A message comes in" e lo "Status callback URL" all'"URL del webhook (Twilio)" del CRM.
- Chiamata in arrivo rifiutata: la firma X-Twilio-Signature non corrisponde (Auth Token diverso). Reinserisci nel CRM lo stesso Auth Token.
Collegare GoTo (VoIP · SMS · Riunioni)
GoTo è un'alternativa BYO (porta il tuo account) per voce, SMS e riunioni: colleghi il tuo account GoTo e inizi a chiamare con un clic, inviare SMS e generare link di riunione dal CRM. L'integrazione resta inerte finché non salvi la credenziale dell'app OAuth e non ti colleghi. Il collegamento avviene in una finestra popup, quindi non esci mai dal CRM.
- Nel GoTo Developer Center crea un'app OAuth e aggiungi il "Redirect URI" esatto mostrato nella scheda GoTo (Impostazioni → Integrazioni) agli URI di reindirizzamento autorizzati.
- Nella scheda GoTo incolla il Client ID e il Client Secret (e, se vuoi, un numero di origine predefinito) e clicca su "Salva credenziali".
- Clicca su "Collega": un popup apre la schermata di consenso di GoTo. Approva e il popup si chiude da solo, mentre la scheda passa a mostrare "Collegato".
- Per revocare l'accesso usa "Rimuovi credenziali" nella scheda. Usa "Ricollega" per rinnovare l'autorizzazione.