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 Meta Business account (business.facebook.com) — la verifica dell’attività è facoltativa: le aziende non verificate possono attivare un numero, far approvare i modelli e inviare broadcast, partendo dal limite di 250 contatti univoci ogni 24 ore (vedi Limiti di messaggistica di seguito)
• 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 attività. Prima di poter acquistare il tuo primo numero, inserisci il nome e l’indirizzo della tua attività in Impostazioni → Attività (gruppo Area di lavoro). Il provider convalida questo indirizzo, quindi assicurati che sia accurato e completo: l’acquisto non andrà a buon fine finché non sarà impostato.

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 vedono su WhatsApp. Deve contenere lettere; un numero di telefono semplice viene rifiutato. 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 pochi minuti e nella maggior parte dei casi non avrai bisogno di una chiamata o di un codice di verifica. Occasionalmente Meta mantiene il numero in stato “In sospeso”; se ciò accade, segui le istruzioni a schermo per verificare tramite telefonata. Se un numero non riesce ripetutamente a registrarsi, WhatsApp potrebbe limitarlo temporaneamente: attendi 24 ore e riprova, oppure contatta l’assistenza.

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.

Per qualsiasi connessione che utilizzi il tuo account WhatsApp Business, Meta addebita i messaggi, non noi. Ciò include la connessione del tuo numero Managed by us sopra, Through our Meta app e la tua app Meta personale. Meta addebita il metodo di pagamento collegato a quell’account WhatsApp Business e, se non ce n’è uno funzionante, Meta blocca trasmissioni, campagne e messaggi modello finché non ne aggiungi uno. Leggi WhatsApp Costs & the October 2026 Change prima del tuo primo invio: copre anche la modifica dei prezzi in arrivo 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.

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 dispone di più di un numero WhatsApp Business API, ognuno può essere gestito da un Agente IA diverso. Il pannello Chi risponde alle nuove conversazioni nella pagina Agenti IA mostra un blocco per numero per WhatsApp con un selettore per ogni numero collegato: Come WhatsApp segue l’Agente del canale; la scelta di un altro Agente (o Nessuno risponde) si applica solo a quel numero. Le risposte vengono sempre inviate dal numero a cui il cliente ha scritto. Dettagli: Punti di ingresso → Un Agente per numero WhatsApp.

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

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.

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, campagne, 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 o una campagna 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: ricollegare 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.