# 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](whatsapp-business.md) 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](https://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](https://business.facebook.com/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.
## Buono a sapersi
* **La finestra di 24 ore si applica come su ogni connessione WhatsApp Business.** Puoi sempre rispondere a forma libera alle persone che ti hanno inviato messaggi nelle ultime 24 ore. Al di fuori di tale finestra, WhatsApp consente alle aziende di avviare conversazioni solo con un [modello di messaggio](../templates/whatsapp-templates.md) approvato: un messaggio di solo testo sarà accettato da Meta ma non verrà consegnato.
* **Meta ti fattura direttamente** le conversazioni alle tariffe nazionali pubblicate, sul 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, campagne e qualsiasi messaggio modello) e mostra l'errore in WhatsApp Manager. Su questa connessione, un broadcast o una campagna si rifiutano di avviarsi in questo caso e ti suggeriscono 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 in quella data. Il quadro completo è disponibile su [Costi di WhatsApp e il cambiamento di ottobre 2026](whatsapp-pricing.md).
* **La tua stima dei costi appare diversa qui.** Poiché queste commissioni non toccano mai i tuoi crediti, la stima nel passaggio di revisione di un broadcast (e nel passaggio di avvio di una campagna) 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 test sono gratuiti.** Il numero di test 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 puntarvi 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](../templates/whatsapp-templates.md#using-templates-with-your-own-meta-whatsapp-account).
## Se qualcosa non funziona
* **"Non siamo riusciti a connetterci con quei dettagli"** — copia nuovamente ogni valore; spesso la causa è uno spazio di troppo. Il messaggio include la risposta di Meta, che solitamente indica il valore errato.
* **L'errore dice 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 dettagli. Rigenerare il token senza quel 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.
* **I messaggi che avvii non arrivano** — controlla la nota sulla finestra di 24 ore 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ò trovarsi in un solo posto alla volta, quindi se è ancora connesso all'**app** WhatsApp Business su un telefono, rimuovilo prima da lì, quindi premi **Verifica connessione** sulla scheda di connessione. Your AI Connector lo attiva per te e ti comunica immediatamente se a Meta manca ancora qualcosa.
* **"Questo numero ha già un PIN di verifica in due passaggi"** — il numero è stato configurato altrove in precedenza 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.