Connetti la tua app Meta #

Esegui WhatsApp tramite la tua app Meta e paga Meta direttamente alle loro tariffe. Your AI Connector non aggiunge commissioni per messaggio su questa connessione e non c’è alcun account Twilio nel mezzo. Poiché l’account WhatsApp è il tuo, i tuoi clienti vedranno sempre e solo il nome della tua azienda.

Questa è l’opzione di connessione WhatsApp più tecnica: creerai un’app all’interno del sito per sviluppatori di Meta e copierai quattro valori in Your AI Connector. Prevedi circa 20 minuti. Se ti sembra troppo complicato, la connessione gestita WhatsApp Business rimane il modo più semplice per iniziare.

Cosa ti serve #

• Accesso al tuo account Meta Business Manager.
• Un numero di telefono non già in uso sull’app WhatsApp.
• Circa 20 minuti.

Parte 1 — Configura la tua app in Meta #

Esegui prima questi passaggi sul portale Meta. Lungo il percorso raccoglierai quattro valori: un App ID, un App secret, un Access token e un WhatsApp account ID.

1. Crea un’app #

Vai su developers.facebook.com, apri Le mie app e premi Crea app. Scegli il tipo Business e assegna un nome qualsiasi: il nome è visibile solo a te.

2. Aggiungi WhatsApp all’app #

Nella dashboard dell’app, trova WhatsApp nell’elenco dei prodotti e premi Configura. Meta crea un account WhatsApp di prova con un numero di test gratuito, così puoi provare le funzionalità prima di collegare un numero reale.

3. Attiva le autorizzazioni WhatsApp #

Questo è il passaggio che la maggior parte delle guide salta, ed è il motivo più comune per cui la connessione fallisce in seguito.

Nella tua app, apri Revisione dell’app, quindi Autorizzazioni e funzionalità. Cerca whatsapp_business_management. Se dice Nessun accesso, premi Ottieni accesso standard: Meta ti chiederà di reinserire la password e ti concederà l’accesso immediatamente. Non c’è alcun periodo di attesa né revisione dell’app; è un semplice pulsante.

whatsapp_business_messaging solitamente ha già l’accesso Standard. Entrambe le autorizzazioni devono mostrare Accesso standard prima del passaggio successivo, altrimenti al token che genererai ne mancherà una.

4. Crea un utente di sistema #

In Meta Business Settings, apri Utenti, quindi Utenti di sistema. Aggiungine uno e concedigli l’accesso come amministratore sia alla tua app che al tuo account WhatsApp.

5. Genera un token per quell’utente #

Seleziona l’utente di sistema e premi Genera token. Scegli la tua app, seleziona un token che non scada mai e spunta sia whatsapp_business_messaging che whatsapp_business_management. Meta mostra il token una sola volta: copialo immediatamente.

6. Trova il tuo ID account WhatsApp #

In Impostazioni aziendali, apri Account, quindi Account WhatsApp e seleziona il tuo account. Il lungo numero sotto il suo nome è l’ID.

Il tuo ID app e il tuo Segreto app si trovano nelle Impostazioni app dell’app, alla voce Base. Premi Mostra accanto al Segreto app per visualizzarlo.

Parte 2 — Connettilo in Your AI Connector #

Apri Impostazioni, quindi Canali, trova la scheda WhatsApp Business API e premi Connetti WhatsApp. Scegli Usa un numero che hai già, quindi La tua app Meta. La procedura guidata si apre con una breve panoramica: premi Avvia configurazione.

1. I tuoi dettagli. Questo passaggio ripete i cinque passaggi lato Meta della Parte 1 accanto a un modulo per i tuoi quattro valori. Incolla l’ID app, il segreto dell’app, il token di accesso e l’ID account WhatsApp esattamente come li mostra Meta, senza spazi extra, e premi Controlla i miei dettagli. Nulla viene salvato finché non funzionano: Your AI Connector li verifica prima con Meta.

2. Scegli il numero da collegare. La procedura guidata elenca ogni numero presente nel tuo account WhatsApp, ognuno con la valutazione di qualità di Meta. Scegli quello con cui questo spazio di lavoro deve inviare e ricevere messaggi e premi Collega questo numero.

3. Attivazione e consegna. Your AI Connector attiva automaticamente il numero per la Cloud API e registra il suo webhook presso Meta, in modo che i messaggi in arrivo raggiungano la tua casella di posta; nella maggior parte dei casi, verrai reindirizzato direttamente alla scheda di connessione con una conferma di “Numero connesso”. Se il passaggio automatico non può essere completato, la procedura guidata mostrerà l’URL di callback e il token di verifica con i pulsanti di copia, guidandoti nell’inserimento manuale su Meta; gli stessi valori rimarranno visibili sulla scheda di connessione nel caso in cui Meta richieda di reinserirli.
4. La procedura guidata verifica la connessione stessa. Nell’ultimo passaggio, verifica automaticamente la configurazione: non dovrai attendere. Una volta che la scheda mostra lo stato di connessione, inviati un messaggio WhatsApp da un altro telefono e guardalo arrivare nelle tue chat: le conversazioni su quel numero ora fluiranno come qualsiasi altro canale e i tuoi agenti AI potranno rispondere. Se il controllo rileva qualcosa di cui Meta ha ancora bisogno (ad esempio la verifica del numero), la scheda ti indicherà esattamente cosa fare e Verifica connessione eseguirà nuovamente il controllo una volta risolto il problema.

Puoi tornare alla stessa pagina in qualsiasi momento per controllare lo stato della connessione, Riconnetterti con nuovi dettagli o premere Disconnetti: il tuo numero, il tuo account Meta e la tua fatturazione rimangono tuoi.

Passaggio dalla connessione gestita #

Puoi iniziare con la connessione WhatsApp Business gestita e passare alla tua app Meta in un secondo momento. Entrambe risiedono sullo stesso account, quindi non è necessario ricostruire nulla.

• I tuoi contatti e la cronologia delle chat rimangono. Contatti, conversazioni, tag, agenti e la knowledge base appartengono al tuo account, non alla connessione. Rimuovere o sostituire un numero non elimina nulla di tutto ciò e, quando qualcuno che ti ha scritto in precedenza invia di nuovo un messaggio al numero, questo finisce nella stessa conversazione.
• Il numero deve essere spostato prima sul lato Meta. WhatsApp consente a un numero di risiedere in un solo posto alla volta. Chiedi all’assistenza di rilasciare il numero dalla configurazione gestita, aggiungilo al tuo account WhatsApp Business in WhatsApp Manager, quindi segui i passaggi in questa pagina. Aspettati che il numero rimanga offline per un breve periodo durante il trasferimento.
• Usa un numero di tua proprietà se prevedi di effettuare il passaggio. Un numero noleggiato all’interno di Your AI Connector è una linea virtuale che appartiene alla configurazione gestita e non può essere semplicemente trasferita alla tua app Meta, quindi il passaggio comporterebbe un nuovo numero WhatsApp.
• I modelli devono essere approvati di nuovo. Meta approva i modelli per ogni account WhatsApp Business, quindi ricrea quelli che utilizzi sotto il tuo account (vedi Modelli di seguito).
• Agenzie: ogni sotto-account collega la propria app Meta, quindi i clienti possono effettuare il passaggio uno alla volta.

Buono a sapersi #

• Si applica la finestra di 24 ore, come per ogni connessione WhatsApp Business. Puoi sempre rispondere liberamente alle persone che ti hanno inviato un messaggio nelle ultime 24 ore. Al di fuori di tale finestra, WhatsApp consente alle aziende di avviare conversazioni solo con un modello di messaggio approvato: un messaggio di solo testo verrà accettato da Meta ma non sarà recapitato.
• Meta ti fattura direttamente le conversazioni alle tariffe nazionali pubblicate, utilizzando il metodo di pagamento collegato al tuo account WhatsApp in Meta. Your AI Connector non addebita costi per messaggio su questa connessione; l’utilizzo dell’IA viene fatturato in crediti come di consueto.
• Mantieni un metodo di pagamento valido su quell’account WhatsApp. Senza di esso, Meta blocca ogni conversazione avviata dalla tua azienda (broadcast e qualsiasi messaggio modello) e mostra l’errore in WhatsApp Manager. Su questa connessione, un broadcast si rifiuta di avviarsi in tale situazione e ti suggerisce di aggiungere un metodo di pagamento invece di fallire messaggio per messaggio. Le risposte alle persone che ti hanno scritto per prime continuano a essere inviate per ora, ma dal 1° ottobre 2026 Meta addebiterà anche quelle, quindi un account senza un metodo di pagamento funzionante diventerà completamente silenzioso a partire da tale data. Il quadro completo è disponibile su Costi di WhatsApp e la modifica di ottobre 2026.
• La tua stima dei costi appare diversa qui. Poiché queste commissioni non intaccano mai i tuoi crediti, la stima nella fase di revisione di un broadcast mostra il conteggio dei contatti e la suddivisione per paese con una nota che indica che Meta li fattura sul tuo account WhatsApp Business, invece di un totale in crediti.
• I numeri di prova sono gratuiti. Il numero di prova che Meta fornisce a ogni nuova app può inviare messaggi fino a cinque destinatari verificati senza alcun costo: un modo pratico per provare l’intera configurazione prima di collegarvi un numero reale.

Modelli #

I modelli di messaggio funzionano su questa connessione e risiedono nel tuo account WhatsApp Business. Creane uno nella pagina Modelli; verrà creato su quell’account e revisionato da Meta, con il risultato approvato, in attesa o rifiutato mostrato qui. I modelli che hai già in WhatsApp Manager appaiono automaticamente nell’elenco e un pulsante Sincronizza da Meta importa tutto ciò che hai appena modificato lì. L’invio funziona come su ogni altra connessione WhatsApp: scegli un modello approvato per avviare una conversazione o riaprirne una al di fuori della finestra di 24 ore. I dettagli sono disponibili in Utilizzo dei modelli con il proprio account Meta WhatsApp.

Se qualcosa non funziona #

• “Non siamo riusciti a connetterci con questi dettagli” — ricopia ogni valore; spesso la causa è uno spazio di troppo. Il messaggio include la risposta di Meta, che solitamente indica il valore errato.
• L’errore indica che il token manca di whatsapp_business_management — alla tua app non è ancora stata concessa tale autorizzazione. Torna alla Parte 1, passaggio 3, premi Ottieni accesso standard, quindi genera un nuovo token con entrambe le autorizzazioni selezionate e ricontrolla i tuoi dati. Rigenerare il token senza eseguire questo passaggio continuerà a produrre lo stesso errore.
• Il tuo token è scomparso — Meta mostra un token una sola volta. Generane uno nuovo dallo stesso utente di sistema; quello vecchio continua a funzionare finché non lo revochi, ma solo quello nuovo è visibile.
• Le risposte falliscono con “Questa conversazione è arrivata sul numero WhatsApp Business …, che non è il numero collegato” — la tua app Meta ha più di un numero e gli utenti stanno scrivendo a un numero che non è quello collegato qui. I loro messaggi vengono comunque visualizzati, perché Meta invia i messaggi dell’app per ogni numero, ma le risposte possono essere inviate solo dal numero collegato, quindi l’IA non risponde. La scheda WhatsApp nella pagina Canali mostra un avviso che indica quel numero mentre i messaggi continuano ad arrivare. La riga del numero su quella scheda non ha il pulsante Riconnetti (solo Imposta come principale ed elimina): apri di nuovo la pagina di connessione della tua app Meta (Collega WhatsApp sulla scheda WhatsApp Business API, quindi Usa un numero che hai già, quindi La tua app Meta), premi Riconnetti sulla scheda di connessione in quella pagina e seleziona il numero a cui scrivono effettivamente i tuoi clienti. Il token dell’utente di sistema deve avere accesso a quell’account WhatsApp. Se quel numero non dovrebbe affatto raggiungere Your AI Connector, rimuovilo (o rimuovi il suo account WhatsApp) dalla tua app Meta.
• I messaggi che invii non arrivano — controlla la nota sulla finestra di 24 ore qui sopra: al di fuori di tale finestra, vengono consegnati solo i messaggi modello.
• Non arriva nulla — probabilmente il numero non è ancora attivato per la Cloud API. Un numero può essere attivo in un solo posto alla volta, quindi se è ancora collegato all’app WhatsApp su un telefono, rimuovilo da lì, quindi premi Verifica connessione sulla scheda di connessione. Your AI Connector lo attiverà per te e ti comunicherà immediatamente se a Meta manca ancora qualcosa.
• “Questo numero ha già un PIN di verifica in due passaggi” — il numero è stato configurato in precedenza da qualche parte e ha mantenuto il suo PIN. Disattiva la verifica in due passaggi per quel numero in WhatsApp Manager, quindi premi Riconnetti.
• “Meta non ha ancora verificato questo numero” — completa la verifica del numero in WhatsApp Manager (Meta invierà un codice), quindi premi Riconnetti.
• “Questo numero è ospitato sull’API On-Premises” — è in esecuzione sul vecchio prodotto self-hosted di WhatsApp, che non può condividere un numero con la Cloud API. Esegui prima la migrazione alla Cloud API in WhatsApp Manager.