Provider SMS (Porta il tuo Twilio) #

Questa pagina controlla l’account Twilio utilizzato per la WhatsApp Business API. Per impostazione predefinita, la WhatsApp Business API viene eseguita sull’account Twilio gestito dalla piattaforma: non vedrai mai Twilio e non dovrai registrarti personalmente a Twilio. Se hai collegato la tua chiave Anthropic (BYOK), i messaggi WhatsApp tramite Twilio gestito costano 0,05 crediti ciascuno, sia in entrata che in uscita. Su tutti gli altri account, tali costi di consegna sono già coperti dalla tua tariffa di crediti AI, quindi non è previsto alcun addebito separato per messaggio. (I prezzi dei messaggi di WhatsApp cambieranno il 1° ottobre 2026: consulta Costi di WhatsApp e la modifica di ottobre 2026.) Questo è rilevante solo se desideri specificamente che la WhatsApp Business API venga eseguita sul tuo account Twilio personale.

Per gli SMS è sempre necessario utilizzare il proprio account Twilio (Bring Your Own Twilio). La normativa sugli SMS (A2P 10DLC, registrazione del brand, approvazione del mittente) deve essere presentata a nome della tua azienda, pertanto la piattaforma non offre numeri SMS gestiti. Configura gli SMS separatamente utilizzando la scheda SMS via Twilio in Impostazioni → Canali (è disponibile anche un’opzione gateway SMS per telefoni Android). Questa pagina, la scheda Account Twilio, controlla l’account WhatsApp Business API e non modifica il tuo numero SMS.

Perché dovrei passare WhatsApp Business API al mio account Twilio? #

La maggior parte degli utenti non ne ha bisogno. L’account gestito è più semplice:

• Il noleggio del numero WhatsApp, l’invio dei modelli, la registrazione del mittente e l’integrità del numero sono tutti gestiti per te. Un numero noleggiato qui costa almeno 50 crediti al mese e tale noleggio include la connessione WhatsApp: consulta Numeri di telefono.
• Non esiste una fattura Twilio separata. Se hai collegato la tua chiave Anthropic (BYOK), i messaggi WhatsApp tramite Twilio gestito costano 0,05 crediti ciascuno, sia in entrata che in uscita. Su tutti gli altri account, tali costi di consegna sono già coperti dalla tua tariffa di crediti AI, quindi non è previsto alcun addebito separato per messaggio. Consulta Costi di WhatsApp e la modifica di ottobre 2026 per la modifica dei prezzi di WhatsApp in arrivo il 1° ottobre 2026.
• L’assistenza può aiutare a risolvere direttamente i problemi di consegna.

Potresti voler usare il tuo account Twilio se:

• Hai già un account Twilio consolidato con modelli WhatsApp approvati e numeri già attivi che desideri continuare a utilizzare.
• La tua azienda ha motivi di approvvigionamento o conformità per pagare Twilio direttamente.
• Desideri una visibilità completa sull’utilizzo e sui prezzi a livello di operatore sottostante.

Mantenere un numero già attivo è un’operazione in due passaggi. Il cambio dell’account (di seguito) modifica solo l’account Twilio che utilizziamo per l’invio. Il tuo numero WhatsApp esistente non apparirà come canale finché non lo collegherai: vedi Collegare un numero WhatsApp già in tuo possesso. Eseguili in quest’ordine.

Come cambiare #

Come arrivarci: Impostazioni → gruppo Canali → Canali, quindi trova la scheda Account Twilio.

Ciò che vedi dipende dalla tua configurazione attuale:

Se utilizzi l’account gestito (predefinito) #

Vedrai una breve spiegazione e un pulsante Gestisci sulla scheda Account Twilio. Cliccandoci sopra si aprirà il modulo Passa al tuo account Twilio, che richiede il tuo Account SID e Auth Token di Twilio, con l’avviso di azione distruttiva mostrato direttamente nella finestra di dialogo.

Prima di confermare, leggi attentamente gli avvisi: il passaggio è un’operazione distruttiva:

• Tutti i numeri acquistati tramite la piattaforma verranno rilasciati definitivamente. Se desideri continuare a utilizzare un numero, mantienilo nell’account gestito (non effettuare il passaggio) oppure acquistalo/trasferiscilo prima nel tuo account Twilio.
• I modelli WhatsApp approvati non verranno trasferiti. I modelli sono legati all’account WhatsApp Business che possiede il mittente: dovrai inviarli nuovamente sul tuo account e attendere una nuova approvazione.
• Le chat e la cronologia dei messaggi esistenti rimangono visibili, ma le nuove risposte sui numeri rilasciati falliranno (il numero non esiste più).
• Puoi tornare indietro in seguito, ma otterrai un nuovo account gestito senza numeri e senza modelli: quelli vecchi non verranno ripristinati.

Dove trovare il tuo Account SID e Auth Token: accedi alla console Twilio su console.twilio.com. Entrambi si trovano nella dashboard principale, nel pannello “Account Info”. L’Account SID inizia con AC ed è lungo 34 caratteri.

Dopo aver inserito entrambi i valori e confermato, il sistema:

1. Verifica che le credenziali funzionino.
2. Rilascia ogni numero di telefono gestito da Twilio.
3. Chiude il sub-account gestito.
4. Salva le tue credenziali in modo che tutti i futuri messaggi WhatsApp in uscita utilizzino il tuo account. Il tuo numero SMS via Twilio collegato separatamente viene archiviato in modo indipendente e non viene rilasciato o modificato da questo passaggio.

Questa operazione può richiedere da pochi secondi a un paio di minuti se avevi diversi numeri.

Se utilizzi già il tuo account Twilio #

La scheda mostra il tuo account collegato e ti consente di tornare alla configurazione gestita.

Il ritorno alla modalità gestita prevede la creazione di un nuovo sub-account gestito. Come sopra: non ripristina i numeri o i modelli che avevi in precedenza; dovrai ricominciare da zero.

Collegare un numero WhatsApp già in tuo possesso #

Una volta che l’account è sul tuo Twilio personale, il pulsante Connetti WhatsApp sulla scheda WhatsApp Business API cambia ciò che offre: l’opzione gestita diventa Tramite il tuo account Twilio, che collega un mittente WhatsApp all’interno dell’account Twilio che hai connesso, e l’acquisto di un numero gestito non viene più offerto. È una scelta deliberata: acquistare un numero o eseguire la registrazione a Meta creerebbe un secondo account Twilio gestito dalla piattaforma accanto al tuo, e i tuoi messaggi verrebbero quindi inviati da un account mentre il numero risiede nell’altro.

Prima di iniziare #

Il tuo numero deve essere già un mittente WhatsApp funzionante all’interno del tuo account Twilio:

• È registrato come mittente WhatsApp in Twilio, collegato al tuo account WhatsApp Business.
• Twilio mostra quel mittente come Online.

Questa schermata non registra nulla. Non crea un mittente, non comunica con Meta e non invia il tuo numero per l’approvazione: collega un mittente che funziona già. Se non ne hai ancora uno, esegui prima la configurazione del mittente WhatsApp in Twilio.

Passaggi #

1. Vai su Impostazioni → gruppo Canali → Canali.
2. Nella scheda WhatsApp Business API, clicca su Collega il tuo mittente.
3. Inserisci il numero WhatsApp in formato internazionale (ad esempio +31612345678), esattamente come appare sul mittente in Twilio.
4. Facoltativamente, assegna un’Etichetta: un nome per il numero all’interno dell’app. Se lasciato vuoto, verrà utilizzato il nome presente sul profilo del mittente Twilio.
5. Clicca su Collega mittente.

Non è necessario reinserire l’Account SID o il token di autenticazione: li abbiamo già ottenuti dal cambio account.

Cosa succede dietro le quinte #

1. Cerchiamo il mittente per quel numero nel tuo account Twilio e verifichiamo che Twilio lo abbia online.
2. Ci assicuriamo che nel tuo account esista un servizio di messaggistica e puntiamo il suo webhook in entrata verso di noi (creandone uno, denominato come l’app, se non ne hai già uno). Questo è anche ciò che permette l’invio di modelli.
3. Colleghiamo il tuo mittente a quel servizio di messaggistica.
4. Puntiamo il webhook del mittente verso di noi, in modo che i messaggi in arrivo arrivino qui.
5. Il numero appare nel tuo elenco di numeri, contrassegnato come Il tuo Twilio (BYO), pronto per essere assegnato a una campagna o a un agente.

I tuoi modelli approvati rimangono esattamente dove sono, nel tuo account. Nulla viene inviato nuovamente e nulla viene rilasciato.

Costi #

Non ci sono costi di manutenzione mensili per un numero collegato in questo modo: paghi Twilio direttamente per il numero e le relative tariffe per messaggio. Le risposte dell’IA utilizzano comunque i crediti come di consueto.

Se non funziona #

• “No WhatsApp sender for … exists in your Twilio account” — il numero non è registrato come mittente WhatsApp lì, o è scritto in modo diverso. Controlla l’ID mittente esatto nella Console Twilio e reinseriscilo nel formato internazionale.
• “The WhatsApp sender … is not online in Twilio” — il motivo specifico di Twilio è incluso nel messaggio. Risolvilo prima in Twilio; collegare un mittente che Twilio considera offline causerebbe solo un errore successivo e silenzioso.
• “… is already connected to another account” — il numero è collegato a un account diverso qui. Scollegalo prima da lì.
• “This account is still on the managed Twilio account” — esegui prima il passaggio descritto sopra.
• “we could not update its webhook in Twilio” — il numero è collegato e invierà messaggi, ma il mittente punta ancora a qualsiasi webhook tu avessi impostato. Cancella quel webhook sul mittente nella Console Twilio affinché i messaggi in arrivo raggiungano noi.

Limiti #

• Puoi cambiare provider al massimo una volta ogni 24 ore. Questo impedisce che i rimbalzi ripetuti accumulino costi dell’API Twilio e limiti di frequenza.
• L’invio di SMS non è affatto influenzato da questa impostazione: se hai già collegato il tuo Twilio tramite la scheda SMS via Twilio, si tratta di una connessione diversa che rimane invariata indipendentemente da ciò che fai qui.

Cosa succede se qualcosa va storto? #

• “Could not authenticate with the provided Twilio credentials” — ricontrolla il SID (inizia con AC, 34 caratteri) e il token di autenticazione. Entrambi sono sensibili alle maiuscole.
• “Account is not active” — l’account Twilio che stai cercando di utilizzare è sospeso o chiuso. Utilizza un account attivo.
• “Please wait Xh before switching again” — sei all’interno del periodo di raffreddamento di 24 ore. Attendi il termine del periodo.
• Migrazione parziale (alcuni numeri rilasciati, altri no) — riesegui il passaggio. Il sistema è idempotente; riprende da dove si era interrotto e termina il rilascio di tutto ciò che è ancora nel sotto-account gestito.

Se riscontri problemi dopo il passaggio (i messaggi in uscita non vengono inviati, i modelli non appaiono), contatta l’assistenza fornendo il tuo Account SID (mai l’auth token).

Hai bisogno di aiuto? #

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.