API di WhatsApp Business #

Connetti la tua attività a WhatsApp tramite l’API ufficiale di WhatsApp Business. Questo canale è la scelta consigliata per le aziende che necessitano di una messaggistica WhatsApp affidabile e ad alto volume, con modelli di messaggio pre-approvati e tracciamento della consegna.

Non è necessario un account Twilio separato. Twilio è il servizio di telefonia e messaggistica che gestisce l’invio dei tuoi messaggi WhatsApp dietro le quinte. La piattaforma crea un account Twilio gestito per te in modo automatico, quindi non è necessario registrarsi a Twilio personalmente o collegarlo a Meta manualmente. L’acquisto di un numero o la connessione di uno esistente avviene interamente all’interno dell’app. Se hai specificamente bisogno di utilizzare il tuo account Twilio (ad esempio, se hai già numeri attivi e modelli approvati), apri la scheda Account Twilio nella pagina Canali e passa al tuo account, quindi collega il tuo mittente esistente: entrambi i passaggi sono descritti in SMS Provider (Bring Your Own Twilio). La maggior parte degli utenti dovrebbe mantenere la configurazione gestita.

Prerequisiti #

Prima di iniziare, assicurati di avere quanto segue:

• Un account Meta Business (business.facebook.com) — la verifica dell’attività è facoltativa: le attività non verificate possono attivare un numero, far approvare i modelli e inviare broadcast, partendo dal limite di 250 contatti unici ogni 24 ore (vedi Limiti di messaggistica di seguito). È necessaria anche per l’opzione Gestito da noi: tale opzione fornisce il numero e gestisce i messaggi, ma il numero rimane nel tuo account WhatsApp Business, quindi ne completerai la configurazione in un pop-up di Meta. L’unico modo per collegare WhatsApp senza alcun account Meta è WhatsApp Web.
• Un account con crediti sufficienti
• Un numero di telefono che non sia già registrato su WhatsApp (app personale o Business) e che non sia già un numero Twilio di un altro account

Aggiungi prima il nome e l’indirizzo della tua azienda. Prima di poter acquistare il tuo primo numero, inserisci il nome e l’indirizzo della tua azienda in Impostazioni → Azienda (gruppo Area di lavoro). L’operatore convalida questo indirizzo, quindi assicurati che sia accurato e completo: l’acquisto non andrà a buon fine finché non sarà impostato. Alcuni paesi accettano solo un indirizzo stradale all’interno dello stesso paese: quando il paese del numero ne richiede uno, il paese dell’indirizzo viene fissato di conseguenza (ad esempio, un numero del Lussemburgo richiede un indirizzo in Lussemburgo), e un numero del tuo stesso paese è il modo per utilizzare il tuo indirizzo.

Passaggio 1: Acquista un numero di telefono #

1. Nella barra laterale sinistra, fai clic su Settings vicino alla parte inferiore.
2. Nella barra laterale sinistra di Settings, sotto Channels, fai clic su Channels.
3. Trova la scheda WhatsApp Business API e fai clic sul pulsante verde Connect WhatsApp.
4. Scegli Get a new number from us, quindi Managed by us.

4. Si apre una finestra pop-up Acquista numero di telefono. Scegli un paese (i numeri e i prezzi in tempo reale provengono direttamente dal nostro operatore per quel paese) e, facoltativamente, filtra per Contiene cifre.

5. Sfoglia l’elenco dei numeri disponibili che appare, ognuno con il costo di acquisto una tantum e il costo mensile mostrati a fianco.

6. Fai clic su un numero e inserisci il suo Nome visualizzato: il nome dell’attività che le persone vedranno su WhatsApp. Deve contenere lettere e dovrebbe corrispondere al nome della tua attività o del tuo brand; WhatsApp rifiuta i numeri di telefono nudi e qualsiasi nome che includa la parola “WhatsApp”. Quindi conferma il costo mostrato e completa l’acquisto.

Un numero acquistato qui è destinato a WhatsApp, non agli SMS. I numeri acquistati tramite la piattaforma vengono utilizzati per WhatsApp Business. Non sono numeri per SMS e non sono nemmeno numeri per chiamate: una chiamata in entrata raggiunge un registratore automatico (presente per rispondere alla chiamata di verifica di WhatsApp durante la configurazione), non c’è una segreteria telefonica da ascoltare e non è possibile effettuare chiamate dal numero. Gli SMS vengono gestiti tramite il tuo account Twilio: consulta SMS. Non dire ai clienti che un numero acquistato può fare entrambe le cose; non è così.

I crediti vengono detratti dal tuo account per l’acquisto. Ogni numero ha poi un canone mensile per mantenerlo attivo: almeno 50 crediti al mese, e i numeri premium costano di più, in linea con quanto addebitato dall’operatore. La scheda del numero in Impostazioni → Canali mostra sempre il suo prezzo mensile esatto, e la finestra di dialogo di acquisto lo mostra prima della conferma.

Tale canone è l’unica tariffa mensile sul numero: include la connessione a WhatsApp, quindi non c’è nulla di extra da pagare per mantenere il numero su WhatsApp. Se noleggi già dei numeri qui, questi passeranno a questa tariffa al ciclo di fatturazione successivo. Vedi Numeri di telefono.

Messico e Argentina: per questi paesi sono offerti solo numeri di cellulare. WhatsApp tratta i numeri in questi paesi come numeri di cellulare e solo un numero di cellulare può ricevere il codice di verifica di WhatsApp; i numeri di rete fissa non possono, quindi non sono elencati. Ciò significa anche che il prefisso della città potrebbe differire da quello della tua città; questo non influisce sul funzionamento di WhatsApp.

Passaggio 2: Connetti il numero a Meta #

Un numero acquistato deve ancora essere attivato con Meta prima di poter inviare e ricevere messaggi:

1. Nella pagina Channels, la scheda WhatsApp Business API mostra il tuo nuovo numero nell’elenco.
2. Fai clic sull’azione di connessione specifica del numero (Finish setup): si aprirà una finestra pop-up di Meta in cui completerai la connessione con l’account Meta proprietario del tuo account WhatsApp Business, seguendo le istruzioni di Meta.
3. Quando Meta conferma la connessione, il numero diventa attivo automaticamente: non c’è un passaggio di “annuncio” separato. Il suo stato passa automaticamente ad Active una volta che la connessione è online.

Ti verrà chiesto di accedere al tuo account Meta Business e di concedere alla piattaforma l’autorizzazione a inviare e ricevere messaggi WhatsApp per tuo conto.

L’attivazione è solitamente automatica. Richiede alcuni minuti e, nella maggior parte dei casi, non sarà necessaria una chiamata o un codice di verifica. Occasionalmente Meta mantiene il numero “In sospeso” o la finestra di Meta termina con “Connessione WhatsApp non completata” anche se il controllo di proprietà è stato superato. Lascia il numero così com’è: viene ricontrollato ogni dieci minuti e una registrazione bloccata dopo un controllo di proprietà riuscito viene registrata nuovamente per te automaticamente, solitamente entro il quarto d’ora successivo. Non eliminare il numero né avviare nuovamente il completamento della configurazione nel frattempo. Se un numero non riesce ripetutamente a registrarsi, WhatsApp potrebbe limitarlo temporaneamente: attendi 24 ore e riprova, oppure contatta l’assistenza se è ancora “In sospeso” dopo un’ora. L’unica eccezione è un account WhatsApp Business che Meta ha bloccato: vedi Bloccato da Meta qui sotto.

Hai già un tuo numero Meta Cloud API? #

Non devi necessariamente acquistare tramite la piattaforma. Nella scheda WhatsApp Business API, fai clic su Connect WhatsApp, scegli Use a number you already have, quindi Managed by us per aprire la finestra modale Connect WhatsApp Business API:

1. Inserisci il numero di telefono nel formato internazionale (ad es. +1 555 123 4567).
2. Facoltativamente, digita un nome visualizzato: il nome mostrato alle persone a cui invii messaggi su WhatsApp.
3. Fai clic su Continua su WhatsApp per completare la connessione nella finestra di Meta.

Consigliamo vivamente di NON collegare il tuo numero WhatsApp Business personale attivo: collegarlo qui potrebbe interrompere il funzionamento della tua app WhatsApp esistente. Usa un numero nuovo.

Nella finestra di Meta, aggiungi e verifica il tuo numero. Non scegliere il numero di test gratuito di Meta (inizia con +1 555): può inviare messaggi solo a una manciata di contatti di test aggiunti manualmente, quindi non potrà mai raggiungere clienti reali. Se inserisci o selezioni il numero di test di Meta, la connessione verrà rifiutata.

Spostare un numero attualmente sull’app WhatsApp #

Un numero che è attivamente registrato nell’app WhatsApp o WhatsApp Business non può essere collegato all’API: devi prima rimuoverlo dall’app. Procedi in questo ordine:

1. Salva prima tutto ciò di cui hai bisogno dall’app. La cronologia delle chat non viene trasferita all’API e l’eliminazione dell’account è permanente: esporta o esegui il backup delle conversazioni importanti prima di continuare.
2. Disattiva la verifica in due passaggi nell’app (Impostazioni → Account → Verifica in due passaggi), in modo che il vecchio PIN non interferisca con la registrazione all’API.
3. Elimina l’account nell’app: Impostazioni → Account → Elimina il mio account. Questo rilascia il numero: un numero può trovarsi solo sull’app o sull’API, mai su entrambe contemporaneamente.
4. Attendi qualche minuto affinché il rilascio venga propagato, quindi segui i passaggi di connessione sopra per collegare il numero.

Vuoi il tuo account WhatsApp Business senza la configurazione da sviluppatore? #

Through our Meta app è un’altra risposta alla seconda domanda dello stesso pulsante Connect WhatsApp. Mantieni il tuo account WhatsApp Business, ma non crei nulla nel sito per sviluppatori di Meta: utilizzi la nostra app Meta. Meta addebita le conversazioni direttamente sul tuo account WhatsApp Business. Se utilizzi un tuo numero: 50 crediti al mese da parte nostra per la connessione. Se noleggi il tuo numero qui: nessun costo aggiuntivo, poiché il noleggio del numero copre già la connessione. Vedi Connect Through Our Meta App.

Preferisci eseguire WhatsApp sulla tua app Meta? #

Esiste un’ulteriore opzione per utenti tecnici e agenzie: creare la propria app nel sito per sviluppatori di Meta e connetterla direttamente. Meta ti addebita le tariffe secondo i propri prezzi, non ci sono commissioni per messaggio da parte nostra e i tuoi clienti vedranno sempre solo il nome della tua azienda. La guida completa è disponibile in Connetti la tua app Meta.

Chi paga le tariffe dei messaggi dipende da come è collegato il numero. Il tuo numero Gestito da noi invia tramite il nostro account di messaggistica, quindi le relative tariffe vengono detratte dai tuoi crediti, esattamente come per un numero a noleggio. Tramite la tua app Meta e la tua app Meta personale, Meta addebita i messaggi al metodo di pagamento collegato al tuo account WhatsApp Business; se non ne è presente uno attivo, Meta blocca le trasmissioni e i messaggi modello finché non ne aggiungi uno. Leggi Costi di WhatsApp e la modifica di ottobre 2026 prima del tuo primo invio: contiene anche informazioni sulla modifica dei prezzi prevista per il 1° ottobre 2026.

Problemi comuni di connessione #

Alcuni problemi ostacolano la maggior parte dei nuovi utenti durante il flusso di connessione a Meta. Leggi queste informazioni prima di iniziare l’attivazione.

Scegli il tuo numero, non quello di prova di Meta #

Durante la procedura di connessione a Meta, Meta ti offrirà un numero di telefono di prova (un numero campione nel range +1 555) insieme all’opzione di usarne uno tuo. Usa sempre il tuo. Il numero di prova di Meta può ricevere messaggi ma può inviarli solo a una manciata di numeri che aggiungi manualmente all’interno di Meta, quindi non invierà mai messaggi a clienti reali: ogni risposta fallisce silenziosamente. L’app blocca questa operazione: se inserisci o selezioni il numero di prova di Meta, la connessione viene rifiutata e ti verrà chiesto di utilizzare un numero reale.

Il tuo numero deve finire all’interno dell’account WhatsApp Business #

Questo è il motivo più comune per cui una connessione fallisce proprio all’ultimo passaggio. Scegliere il numero di prova di Meta, o superare il passaggio del numero di telefono, lascia l’account WhatsApp Business selezionato senza il tuo numero al suo interno e, di conseguenza, non c’è nulla da collegare per noi.

Al passaggio del numero di telefono nella finestra di Meta:

1. Scegli di aggiungere un nuovo numero.
2. Inserisci il tuo numero.
3. Verificalo con il codice che Meta ti invia tramite SMS o chiamata.

Se eseguita correttamente, il tuo numero apparirà sotto Numeri di telefono in quell’account in WhatsApp Manager, contrassegnato come verificato. Se la connessione fallisce, l’app ti indicherà esattamente quale di questi passaggi non è andato a buon fine.

Se fallisce, non eliminare e ricreare le cose #

Quando una connessione fallisce, è forte la tentazione di eliminare l’account WhatsApp Business e ricominciare da capo. Non farlo. Eliminare un account a cui è collegato il tuo numero solitamente rende il problema più difficile da risolvere e i tentativi di connessione ripetuti possono far bloccare temporaneamente un numero da WhatsApp, il che può diventare permanente. Leggi il messaggio di errore: indica il problema specifico e il passaggio successivo. Se continua a non connettersi, contatta l’assistenza indicando il numero di telefono e l’errore.

Ogni account necessita del proprio account WhatsApp Business #

Un account WhatsApp Business può essere collegato a un solo account di messaggistica alla volta, pertanto non è possibile collegare un secondo numero tramite lo stesso account WhatsApp Business da un account diverso qui — il caso più frequente è quello di un’agenzia e uno dei suoi sub-account, o due sub-account, che puntano tutti allo stesso Business Account. Meta mostra comunque la connessione come riuscita, poiché il numero è effettivamente verificato e attivo in quel Business Account, ma l’attivazione si interrompe qui con un messaggio che indica l’account che lo sta già utilizzando.

Due possibili soluzioni:

• Collega il numero all’account che utilizza già quell’account WhatsApp Business. L’aggiunta di ulteriori numeri lì funziona normalmente.
• Assegna a questo account il suo account WhatsApp Business. Avvia nuovamente la connessione e scegli di creare un nuovo account WhatsApp Business invece di selezionare quello esistente. Rimuovi prima il numero dal vecchio Business Account in Meta Business Manager, poiché un numero può appartenere a uno solo di essi.

Non eliminare l’account WhatsApp Business esistente per liberarlo: il numero già attivo su di esso smetterebbe di funzionare.

Non riutilizzare un account WhatsApp Business già collegato a un altro BSP #

Se il tuo account WhatsApp Business (WABA) è già collegato a un altro BSP (Business Service Provider — un’altra piattaforma che vi si è collegata in precedenza), la connessione qui fallirà e non potrà essere risolta riprovando; l’attivazione si interrompe con un messaggio che indica che il Business Account è già collegato altrove. Per evitare ciò, crea un nuovo account WhatsApp Business in Meta Business Manager per questa connessione, invece di riutilizzarne uno che è stato collegato altrove.

Twilio nelle tue impostazioni di Meta Business #

Quando colleghi un numero Gestito da noi, Meta aggiunge Twilio alla tua attività Meta come partner. Appare come Twilio nelle Impostazioni di Meta Business. Twilio è il servizio che trasporta i tuoi messaggi WhatsApp tra WhatsApp e Your AI Connector, quindi deve rimanere lì.

Non rimuovere Twilio. Se viene rimosso, nulla entra o esce da quel numero: i messaggi dei clienti non ti raggiungono mai e le tue risposte falliscono. Your AI Connector rileva questo problema, contrassegna il numero come Offline in Impostazioni → Canali e ti invia un’email. Per risolvere il problema, ricollega il numero in Impostazioni → Canali, operazione che aggiungerà nuovamente Twilio.

Passaggio 3: Configura il tuo profilo WhatsApp Business #

Il tuo profilo WhatsApp Business è ciò che i clienti vedono quando interagiscono con la tua attività.

1. Nella pagina Canali, trova il tuo numero attivo su WhatsApp e apri l’editor del profilo.
2. Compila:

3. Salva per aggiornare il tuo profilo.

Un Agente per Numero #

Se il tuo account ha più di un numero WhatsApp Business API, ognuno può ricevere risposta da un diverso Agente AI. Il pannello Chi risponde alle nuove conversazioni nella pagina Agenti AI mostra un blocco per numero per WhatsApp con un selettore per ogni numero collegato: Come WhatsApp segue l’Agente del canale; scegliere un altro Agente (o Nessuno risponde) si applica solo a quel numero. Le risposte partono sempre dal numero a cui il cliente ha inviato il messaggio, indipendentemente da come ogni numero sia collegato: un numero gestito, uno sulla nostra app Meta e uno sulla tua app Meta possono coesistere nello stesso account, e un nuovo numero gestisce solo le conversazioni che iniziano su di esso. Dettagli: Punti di ingresso → Un Agente per numero WhatsApp. Se un cliente ha scritto a un numero WhatsApp presente nella tua attività Meta ma non collegato a questo account, una risposta non verrà inviata da uno degli altri tuoi numeri (WhatsApp la rifiuterebbe); il messaggio spiega il motivo e collegare quel numero ti permette di rispondere da esso. I modelli vengono comunque inviati.

Il tuo numero principale #

Quando un contatto non ha mai inviato messaggi a nessuno dei tuoi numeri, la risposta viene inviata dal tuo numero principale. Per modificarlo, apri Impostazioni → Canali, trova il numero nella scheda WhatsApp Business API e fai clic su Imposta come principale. Solo un numero che ha completato la connessione a WhatsApp può inviare messaggi: un numero che mostra ancora Configurazione non completata non può inviare messaggi e l’app utilizzerà invece un numero connesso. Gli altri numeri rimangono nel tuo account come numeri secondari e un numero acquistato viene fatturato ogni mese, indipendentemente dal fatto che la sua configurazione sia completata o meno; pertanto, completa la configurazione o rimuovilo se non ti serve.

Informazioni sui limiti di messaggistica #

WhatsApp impone limiti di messaggistica per proteggere gli utenti dallo spam. Questi limiti determinano a quanti contatti unici puoi inviare messaggi entro una finestra temporale mobile di 24 ore.

Sistema a livelli #

Come aumentare i propri limiti #

• Verifica la tua attività su Meta Business Manager per superare il limite iniziale di 250 contatti e arrivare a 2.000.
• Mantieni un’alta qualità dei messaggi: evita di essere segnalato o bloccato dai destinatari.
• Invia messaggi in modo coerente: WhatsApp aumenta automaticamente il tuo livello quando raggiungi circa la metà del tuo limite attuale con buone valutazioni di qualità, solitamente entro 6 ore dal raggiungimento dei criteri.

Tipi di messaggi #

Messaggi di sessione (a formato libero) #

Testo normale, immagini, video, documenti e altri file multimediali che puoi inviare all’interno di una finestra di conversazione attiva.

• Può includere qualsiasi contenuto
• Può essere inviato solo entro la finestra di messaggistica di 24 ore (vedi sotto)
• Nessuna pre-approvazione richiesta

Posizioni condivise #

Quando un contatto condivide una posizione (la graffetta → Posizione in WhatsApp, un segnaposto o un luogo salvato), l’IA la riceve come testo all’interno della conversazione: il nome del luogo e l’indirizzo quando WhatsApp li invia, più le coordinate, nel formato [THE CONTACT SHARED A LOCATION] Playa Delfines, Cancún (21.1619, -86.8515). L’agente può citare l’indirizzo, ragionarci sopra nelle sue istruzioni (“se il contatto è fuori dalla nostra area di consegna, comunicalo”) o trasmettere la latitudine e la longitudine a una funzione personalizzata o a un webhook come parte della conversazione. Lo stesso formato viene utilizzato indipendentemente dal fatto che il numero sia collegato nel modo predefinito (un numero fornito da noi), tramite la nostra app Meta, tramite la tua app Meta o su WhatsApp Web. Le posizioni in tempo reale (live) arrivano una sola volta, con la posizione nel momento della condivisione; l’app non segue il segnaposto in movimento.

Nelle Chat lo vedi come una scheda, non come quella riga di testo: un segnaposto con il nome del luogo e l’indirizzo, e un link Apri in Google Maps che apre il punto esatto in una nuova scheda. Sotto viene mostrata una didascalia digitata dal contatto insieme ad esso. L’elenco delle chat mostra un segnaposto e il nome del luogo come ultimo messaggio.

Messaggi modello #

Formati di messaggio pre-approvati che ti consentono di avviare conversazioni con i clienti al di fuori della finestra di 24 ore.

• Devono essere inviati a Meta per l’approvazione prima dell’uso
• Supportano variabili per la personalizzazione (es. nome del cliente, numero d’ordine)
• Richiesti per avviare nuove conversazioni o riattivare il contatto dopo 24 ore
• Disponibili in più lingue

I modelli ora hanno una pagina dedicata: consulta Modelli di messaggio WhatsApp per la guida completa.

La finestra di messaggistica di 24 ore #

WhatsApp impone una finestra di conversazione di 24 ore per proteggere gli utenti:

• Quando un cliente ti invia un messaggio, si apre una finestra di 24 ore. Durante questa finestra, puoi inviare liberamente qualsiasi tipo di messaggio (messaggi di sessione).
• Dopo 24 ore di inattività (nessun messaggio da parte del cliente), la finestra si chiude. Puoi riprendere il contatto solo utilizzando un modello di messaggio approvato.
• Quando invii un modello di messaggio, si apre una nuova finestra di 24 ore non appena il cliente risponde.

Le risposte all’interno di questa finestra smetteranno di essere gratuite il 1° ottobre 2026. Meta ha annunciato che, a partire da tale data, addebiterà le risposte a formato libero inviate da un’azienda entro la finestra di 24 ore, per messaggio, alla tariffa di ciascun mercato: la stessa tariffa già prevista per i modelli di utilità e autenticazione. Sono state gratuite da novembre 2024. Ogni numero di telefono riceve innanzitutto 1.000 messaggi di servizio gratuiti al mese e solo dal 1.001° in poi viene applicato un addebito; la tariffa è quella di utilità del mercato, già presente nel listino prezzi di Meta. Cosa significa per te e cosa controllare prima di tale data è disponibile su Costi di WhatsApp e la modifica di ottobre 2026.

Test della configurazione #

Prima di rendere tutto operativo con i clienti, verifica che tutto funzioni:

1. Invia un messaggio di prova. Apri l’agente IA o il Broadcast assegnato a questo numero e usa il pannello Prova per inviarti un messaggio di prova, oppure invialo direttamente da Chat.
2. Testa i messaggi in entrata. Invia un messaggio WhatsApp dal tuo telefono personale al tuo numero aziendale e conferma che appaia in Chat.
3. Testa le risposte dell’IA. Conferma che l’agente risponda entro i tempi previsti e che le sue risposte siano in linea con le tue istruzioni e la Knowledge Base.
4. Testa i modelli di messaggio. Crea e approva un modello semplice, invialo al tuo numero di prova e conferma che arrivi con tutte le variabili compilate.

Risoluzione dei problemi #

Il numero non risulta attivo #

• Assicurati di aver completato l’intero processo di attivazione, inclusi l’accesso al tuo account Meta Business e la concessione delle autorizzazioni.
• Verifica che il tuo account Meta Business sia in regola.
• Attendi qualche minuto e aggiorna la pagina: l’attivazione può richiedere del tempo.

In sospeso perché Meta sta ancora esaminando un nuovo account WhatsApp Business #

Se la finestra di Meta ha creato un nuovo account WhatsApp Business, Meta esegue una propria revisione automatica di tale account prima di rendere attivo il numero. Fino all’approvazione della revisione, il numero viene visualizzato come In sospeso nell’app e in WhatsApp Manager. Non c’è nulla da inviare per questa revisione e non c’è modo di accelerarla dall’app. Lascia il numero così com’è: l’app continuerà a controllare e il numero si collegherà automaticamente una volta che Meta avrà approvato l’account, anche se dovessero volerci diversi giorni. La verifica dell’attività è un passaggio separato; aumenta il limite di messaggistica ma non è ciò che questa revisione attende.

Bloccato da Meta #

A volte Meta blocca l’account WhatsApp Business su cui si trova un numero, ad esempio mentre attende che tu completi la verifica dell’attività o risolva una revisione. Un numero su un account bloccato non può connettersi: l’app lo mostra come Bloccato da Meta e passando il mouse sopra il badge ti verrà indicato cosa fare. La ri-registrazione non è utile in questo caso, quindi l’app non ci prova. Apri Home dell’assistenza aziendale in Meta Business Suite, segui i passaggi di Meta per sbloccare l’account (e completa la verifica dell’attività se Meta la richiede), quindi lascia il numero così com’è. L’app continua a controllare e il numero si connette da solo una volta che Meta rimuove il blocco; non è necessario riconnettersi o avviare nuovamente il completamento della configurazione.

Se preferisci non aspettare, puoi utilizzare il numero su WhatsApp Web. Elimina prima il numero in Impostazioni → Canali, quindi eliminalo dall’account WhatsApp Business in WhatsApp Manager (lì è possibile rimuovere un numero che non è mai stato attivato). Dopodiché, registralo nell’app WhatsApp Business su un telefono e collegalo con il codice QR. Spostarlo nuovamente sull’API in un secondo momento significa eliminare di nuovo l’account nell’app, come descritto in Spostamento di un numero attualmente sull’app WhatsApp.

Il numero risulta offline #

Un badge Offline sul numero in Impostazioni → Canali indica che WhatsApp ha impedito al numero di inviare messaggi. Passa il mouse sopra il badge per scoprirne il motivo. La causa più comune è la disattivazione da parte di Meta dell’account WhatsApp Business associato al numero, solitamente a causa di una violazione delle norme; in tal caso, il badge lo segnala e ti rimanda al Meta Business Manager, dove puoi esaminare l’avviso e presentare ricorso.

Il badge diventa anche Offline quando Twilio è stato rimosso dalla tua attività Meta (vedi Twilio nelle tue impostazioni di Meta Business); per risolvere il problema, ricollega il numero in Impostazioni → Canali.

Mentre il numero è offline, le trasmissioni da esso provenienti vengono trattenute invece di fallire messaggio per messaggio, e anche le risposte automatiche non possono essere inviate. Controlliamo ogni numero collegato tramite questa configurazione su WhatsApp una volta al giorno. Quando un numero precedentemente funzionante va offline con un semplice errore generico di WhatsApp (nessun motivo legato alle policy), quel controllo lo registra nuovamente in automatico e riceverai un’email solo se ciò non dovesse ripristinarlo. Per qualsiasi altro motivo, riceverai un’email la prima volta che il numero va offline. Non appena WhatsApp segnala che è tornato online, il badge diventa di nuovo verde automaticamente, al più tardi al controllo giornaliero successivo. Se il numero rimane offline dopo che hai risolto il problema lato Meta, contatta l’assistenza e provvederemo a ricontrollarlo per te. I messaggi che non è stato possibile inviare perché il numero era offline non vengono addebitati.

Il numero indica che non è in consegna #

Un badge Non in consegna sul numero in Impostazioni → Canali indica che il numero è ancora connesso e i messaggi inviati a te arrivano correttamente, ma WhatsApp non sta consegnando i messaggi che invii da esso. Le risposte, incluse quelle del tuo Agente, rimangono in coda per ore e poi falliscono. In WhatsApp Manager, questo viene visualizzato come un numero senza limite di messaggistica; le cause comuni sono una restrizione o una revisione del numero o dell’Account WhatsApp Business, oppure un metodo di pagamento mancante. Passa il mouse sopra il badge per visualizzare il motivo.

Controlla il numero in WhatsApp Manager e risolvi ciò che Meta indica lì. Finché il badge è presente, le trasmissioni dal numero vengono bloccate prima dell’invio. Controlliamo ogni numero connesso tramite questa configurazione una volta al giorno e ti inviamo un’email la prima volta che ciò accade; una volta che WhatsApp riprende a consegnare dal numero, il badge diventa verde automaticamente. In una chat, una risposta che è ancora in attesa di essere inviata dopo 15 minuti mostra un orologio ambra, così puoi distinguerla da un messaggio che è semplicemente in fase di invio.

I messaggi non vengono inviati #

• Verifica di avere crediti sufficienti sul tuo account.
• Controlla se hai raggiunto il tuo limite di messaggi.
• Assicurati che il numero di telefono del destinatario sia nel formato internazionale corretto (es. +1234567890).
• Se invii messaggi al di fuori della finestra di 24 ore, assicurati di utilizzare un modello approvato.

Trasmissioni e modelli bloccati, ma le risposte funzionano ancora #

Questo schema — puoi rispondere alle persone che ti scrivono per prime, ma nulla di ciò che avvii viene inviato — significa quasi sempre che l’account WhatsApp Business dietro il numero non ha un metodo di pagamento funzionante, e si applica solo alle connessioni che vengono eseguite sul tuo account WhatsApp Business. Meta blocca le conversazioni avviate dall’azienda (trasmissioni, qualsiasi modello) finché non è presente un metodo di pagamento valido sull’account e segnala l’errore in WhatsApp Manager.

L’app ora interrompe una trasmissione prima che venga inviata in questa situazione e ti dice di aggiungere un metodo di pagamento, invece di lasciare che ogni messaggio fallisca. Aggiungi o correggi il metodo di pagamento in WhatsApp Manager e invia di nuovo: riconnettere il numero qui non risolverà il problema. Vedi Costi di WhatsApp e la modifica di ottobre 2026.

Modello rifiutato #

• Rivedi le linee guida di Meta per i modelli: i modelli non possono contenere contenuti promozionali in determinate categorie.
• Controlla eventuali problemi di formattazione, come segnaposto non corrispondenti.
• Leggi il motivo del rifiuto fornito da Meta, correggi e invia nuovamente: consulta Modelli di messaggio WhatsApp.

Valutazione della qualità dei messaggi scarsa #

• Rivedi il contenuto dei tuoi messaggi per verificarne la pertinenza e il valore per i destinatari.
• Evita di inviare messaggi a contatti che non hanno fornito il consenso.
• Riduci la frequenza dei messaggi se i destinatari ti segnalano o ti bloccano.

Errore “Numero di telefono non trovato” #

• Il numero di telefono potrebbe non essere collegato correttamente al tuo account Meta Business.
• Prova a riattivare il numero di telefono tramite il flusso di connessione di WhatsApp.
• Contatta l’assistenza se il problema persiste.

Best practice #

• Ottieni sempre il consenso prima di inviare messaggi ai clienti su WhatsApp.
• Rispondi rapidamente ai messaggi dei clienti per sfruttare al meglio la finestra di 24 ore.
• Mantieni i modelli concisi e utili: i modelli di alta qualità vengono approvati più velocemente e hanno prestazioni migliori.
• Monitora la tua valutazione della qualità in Meta Business Manager per evitare declassamenti di livello.
• Lascia che un Agente AI gestisca le risposte per garantire una reattività 24/7 all’interno della finestra di messaggistica: vedi Agenti AI.