# WhatsApp Business Tools MCP: come collegare WhatsApp Business a un agente AI
> Il server MCP ufficiale di Meta per WhatsApp Business: cosa può fare l’agente, il comando di connessione in Claude Code, la configurazione in Codex e ChatGPT e i limiti della versione beta.
Source: https://ailoot.ai/blog/it/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/it/whatsapp-business-mcp/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-ffcc7a33e4fd91e96028042a1589e146c32bfd6441d11bdfe91660d8ecb8310c
Il 15 settembre 2026, Meta ha rilasciato il server MCP ufficiale WhatsApp Business Tools. Collega un agente AI—Claude Code, Codex, ChatGPT o Cursor—alla WhatsApp Business Platform. Invece di passare dalla Developer Console al Business Manager e alla documentazione API, descrivi l’attività all’agente, che aggiunge un numero, crea un modello di messaggio, configura i webhook e invia un messaggio di prova.
Il server è ancora in beta: l’accesso viene distribuito gradualmente e la versione è destinata allo sviluppo e ai test, non all’invio di messaggi su larga scala in produzione. Di seguito trovi i preparativi e i passaggi per collegare quattro client. I comandi e le impostazioni sono stati verificati rispetto alla documentazione ufficiale di Meta il 18 settembre 2026.
Le informazioni su come lavorare con Ailoot sono disponibili nella [documentazione](https://ailoot.ai/docs/).
## Che cos’è WhatsApp Business Tools MCP?
Punti chiave
È il server MCP remoto ufficiale di Meta, che mette a disposizione di un agente AI strumenti per gestire la WhatsApp Business Platform: account, numeri di telefono, modelli di messaggio, webhook e invio di messaggi di prova. L’accesso avviene tramite OAuth: accedi con il tuo account Meta e selezioni le aziende con cui autorizzi il server a lavorare.
MCP (Model Context Protocol) è uno standard aperto per collegare sistemi esterni agli agenti AI. Scopri di più nell’articolo [Server MCP per Claude Code: 7 integrazioni pronte all’uso](https://ailoot.ai/blog/it/mcp-servers-claude-code/). Le connessioni verificate con i comandi di installazione si trovano nel catalogo MCP.
Prima di questa versione, configurare un’integrazione WhatsApp significava aprire la Developer Console, creare un’app, collegare un’azienda, aggiungere un numero di telefono, verificarlo con un codice, generare un token, configurare un webhook, consultare la documentazione API e solo allora scrivere la prima riga di codice.
Meta descrive così l’idea alla base del server (traduzione dall’inglese):
Descrivi ciò di cui hai bisogno e l’agente individua da solo gli account, i numeri di telefono, i modelli e le chiamate API.
— Meta for Developers, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
Ora Meta ha due server MCP, che è facile confondere. Meta Social Technologies MCP è uno strumento per sviluppatori di uso generale: ricerca nella documentazione, individuazione degli endpoint Graph API e diagnosi degli errori delle app. WhatsApp Business Tools MCP serve per lavorare con account WhatsApp, numeri di telefono, modelli, webhook e messaggi di prova. Sono complementari e, se necessario, puoi collegarli entrambi.
## Cosa può fare esattamente l’agente dopo la connessione?
Punti chiave
Il server supporta quattro gruppi di attività. Collegare un numero di telefono da zero: aggiungerlo, inviare un codice di verifica, verificarlo e registrarlo. Modelli di messaggio: crearne uno, modificarlo e controllarne lo stato di approvazione. Webhook: specificare un URL di callback e iscriversi ai campi. Verifiche preliminari: l’agente rileva quando non sono stati accettati i termini o non è stato configurato il pagamento e fornisce un link diretto per risolvere il problema.
Gli strumenti del server sono raggruppati sotto il prefisso `whatsapp_biz_`. Secondo la documentazione ufficiale:
- Panoramica: `whatsapp_biz_businesses`, `whatsapp_biz_accounts`, `whatsapp_biz_phone_numbers`—quali aziende, account e numeri di telefono sono disponibili.
- Configurazione del numero di telefono: `whatsapp_biz_add_phone_number`, `whatsapp_biz_send_verification_code`, `whatsapp_biz_verify_phone_number`, `whatsapp_biz_register_phone_number`.
- Modelli: `whatsapp_biz_list_templates`, `whatsapp_biz_get_template`, `whatsapp_biz_create_template`, `whatsapp_biz_update_template`, `whatsapp_biz_delete_template`.
- Messaggi: `whatsapp_biz_send_message`—testo libero durante la finestra di conversazione di 24 ore oppure un modello approvato al di fuori della finestra; prima dell’invio, l’agente ti conferma il destinatario.
- Webhook: `whatsapp_biz_configure_webhooks`, `whatsapp_biz_subscribe_webhook`.
- Configurazione dell’account: `whatsapp_biz_configure_payments`, `whatsapp_biz_verify_business`, `whatsapp_biz_system_user_token`—un link per creare un token utente di sistema e chiamare direttamente la Cloud API.
Quando un cliente invia per primo un messaggio all’azienda, si apre una finestra di assistenza: puoi rispondere con testo libero per 24 ore. Ogni nuovo messaggio del cliente prolunga la finestra. Una volta chiusa, puoi contattare il cliente solo con un modello approvato. L’agente conosce questa regola e, se il destinatario non rientra nella finestra, suggerisce di inviare un modello invece di un normale messaggio di testo.
Il server include controlli di accesso. Accedi con il tuo account Meta e selezioni aziende specifiche; i token non vengono inclusi nella cronologia della conversazione. Ogni lettura viene eseguita nel tuo contesto, le chiamate vengono registrate e le azioni che apportano modifiche richiedono una persona autenticata: la sola chiave dell’app server non è sufficiente.
## Cosa controllare prima di connettersi?
Punti chiave
Tre prerequisiti: il ruolo MANAGE nell’azienda Meta che vuoi gestire; i diritti di amministratore su un’app con lo scenario WhatsApp abilitato; e l’accettazione dei termini della WhatsApp Business Cloud API. Se manca qualcosa, lo strumento restituisce un errore che spiega il problema e include il link alla pagina in cui puoi risolverlo.
Il server agisce per tuo conto e lavora solo con le tue risorse, quindi prima della prima chiamata controlla quanto segue:
1. Hai un’azienda Meta in cui sei amministratore (il ruolo MANAGE).
2. Hai un’app Meta con lo scenario WhatsApp Business Messaging abilitato (oppure il prodotto WhatsApp nelle app meno recenti) e sei amministratore di quella specifica app; le sole autorizzazioni a livello aziendale non bastano.
3. L’azienda ha accettato i termini della WhatsApp Business Cloud API; senza questa accettazione, la registrazione del numero di telefono e l’invio sono bloccati.
Secondo Meta, spesso si verificano problemi relativi ai termini di utilizzo, ai metodi di pagamento e alla verifica aziendale senza una spiegazione chiara. L’agente li controlla in anticipo e fornisce un link diretto per accettare i termini, specificare un metodo di pagamento o avviare la verifica aziendale.
## Come si collega il server a Claude Code?
Punti chiave
Esegui il comando `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`, poi digita `/mcp` nella sessione, seleziona il server e accedi tramite Meta. Dopo aver riavviato il client, dovrai accedere di nuovo.
Se non hai ancora installato Claude Code, inizia dalla guida [Come installare Claude Code dal sito ufficiale](https://ailoot.ai/blog/it/install-claude-code/).
1. ### Aggiungi il server
Nel terminale, esegui:
```bash
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
```
Il server è remoto, quindi non devi installarlo localmente.
2. ### Accedi tramite Meta
In una sessione di Claude Code, digita `/mcp` e seleziona `whatsapp_business_tools`. Si aprirà una finestra del browser per accedere al tuo account Meta. Se il browser non si apre, copia il link dal client e aprilo manualmente.
3. ### Concedi le autorizzazioni
Nella schermata di consenso, seleziona le aziende e le app con WhatsApp a cui consenti l’accesso. Il server richiederà tre autorizzazioni: `business_management` (individuare le aziende in cui sei amministratore), `whatsapp_business_management` (account, numeri di telefono, modelli, webhook) e `whatsapp_business_messaging` (inviare messaggi dai tuoi numeri).
4. ### Verifica la connessione
Riavvia Claude Code, accedi di nuovo tramite `/mcp` e chiedi all’agente quali strumenti vede sul server `whatsapp_business_tools`. Poi esegui una lettura sicura: «Elenca le aziende che posso gestire»—l’agente chiamerà `whatsapp_biz_businesses`. Se non ci sono strumenti o compare un errore di accesso, controlla l’indirizzo del server e accedi di nuovo.
L’accesso OAuth è legato all’avvio del client: dopo aver riavviato Claude Code, dovrai accedere di nuovo. Puoi revocare l’accesso in qualsiasi momento nelle impostazioni su facebook.com, alla voce «Integrazioni aziendali».
## Come si collegano Codex, ChatGPT e Claude Desktop?
Punti chiave
Tutti e tre usano lo stesso indirizzo del server e l’accesso OAuth; cambia solo la posizione nelle impostazioni. Codex App: Impostazioni, MCP Servers, aggiungi un server Streamable HTTP. ChatGPT: Impostazioni, Plugin, aggiungilo tramite URL. Claude Desktop: Impostazioni, Connettori, connettore personalizzato.
**Codex App.** Apri le impostazioni (l’ingranaggio in basso a sinistra), vai a MCP Servers e seleziona Add servers. Scegli Streamable HTTP e inserisci:
- Nome: `WhatsApp Business Tools`
- URL: `https://mcp.facebook.com/whatsapp_business_tools`
- Autenticazione: OAuth
Fai clic su Authenticate e accedi nel browser.
**ChatGPT.** Impostazioni, Plugin, Browse plugins, icona «+» nell’angolo in alto a destra. Inserisci un nome, lo stesso URL e OAuth come tipo di autenticazione.
**Claude Desktop.** Impostazioni, Connettori, Aggiungi connettore personalizzato. Nome: `WhatsApp Business Tools`; URL: lo stesso indirizzo del server.
Dopo averlo aggiunto in qualsiasi client, segui la stessa sequenza di verifica: riavvia, accedi di nuovo, visualizza l’elenco degli strumenti e leggi in sicurezza l’elenco delle aziende.
## Cosa succede nella prima sessione: dall’elenco delle aziende a un messaggio di prova?
Punti chiave
La sequenza è: elencare le aziende, sceglierne una, visualizzarne account e numeri di telefono, aggiungere un numero di telefono, inviare un codice di verifica via SMS o chiamata, verificare il numero con il codice, registrarlo, creare un modello, inviare un messaggio di prova e configurare un webhook. Comunichi tu il codice SMS all’agente.
Una tipica prima sessione con il server collegato:
1. «Elenca le aziende che gestisco»—l’agente chiama `whatsapp_biz_businesses` e tu scegli quella che ti serve.
2. «Mostrami gli account WhatsApp e i numeri di telefono di questa azienda»—`whatsapp_biz_accounts` e `whatsapp_biz_phone_numbers`, con i relativi stati.
3. «Aggiungi il mio numero di prova all’account»—`whatsapp_biz_add_phone_number`.
4. «Invia un codice di verifica via SMS»—`whatsapp_biz_send_verification_code`. Il codice arriva sul tuo telefono.
5. «Verifica il numero con il codice 123456»—`whatsapp_biz_verify_phone_number`, poi registralo con `whatsapp_biz_register_phone_number`.
6. «Crea un modello `order_update` nella lingua preferita dai destinatari per le notifiche degli ordini»—`whatsapp_biz_create_template`; l’agente fornirà un link allo stato di approvazione.
7. «Invia un messaggio di prova al mio numero»—`whatsapp_biz_send_message`; prima dell’invio, l’agente ti confermerà il destinatario.
8. «Configura un webhook all’indirizzo [https://example.com/webhook](https://example.com/webhook)»—`whatsapp_biz_configure_webhooks` e iscrizione tramite `whatsapp_biz_subscribe_webhook`.
Dopodiché, i messaggi in arrivo dai clienti saranno recapitati all’indirizzo specificato—di solito, un CRM, un servizio di assistenza clienti o un bot li recupera da lì. La gestione dei messaggi a quell’indirizzo va realizzata separatamente; il server si occupa solo della configurazione.
## Quali sono i limiti della beta?
Punti chiave
Il server è in beta: l’insieme degli strumenti può cambiare e l’accesso viene distribuito gradualmente, non a tutti contemporaneamente. La versione è destinata allo sviluppo e ai test; non è adatta all’invio di messaggi in produzione su larga scala. Ogni strumento ha limiti di richieste per utente e, dopo aver riavviato il client, devi accedere di nuovo.
Ci sono quattro limiti del server da tenere presenti.
**Stato beta.** Meta dichiara che l’interfaccia e l’insieme degli strumenti possono cambiare e che l’accesso viene distribuito gradualmente. Se non riesci ancora a connetterti al server, è possibile che non sia ancora stato reso disponibile per te.
**Finalità.** La versione è destinata allo sviluppo e ai test; non è pensata per l’invio massivo in produzione. Per inviare messaggi in produzione, ti servirà un’integrazione completa con la Cloud API, per esempio usando un token utente di sistema, il cui link è fornito dallo strumento `whatsapp_biz_system_user_token`.
**Limiti.** Le richieste sono limitate per utente e per ciascuno strumento. Se superi il limite, lo strumento restituisce un errore relativo al limite—attendi e riprova.
**Regola della finestra di 24 ore.** Al di fuori della finestra di conversazione con il cliente, puoi inviare solo modelli approvati.
## Perché è importante per un’azienda?
Punti chiave
Ora puoi completare la configurazione iniziale dell’integrazione WhatsApp in un’unica conversazione con un agente: conosce la sequenza dei passaggi e comprende gli errori della piattaforma. I principali casi d’uso sono l’assistenza clienti, le notifiche di ordini e appuntamenti e la preparazione di modelli.
Uno scenario tipico per una piccola azienda: i clienti scrivono su WhatsApp e vuoi rispondere rapidamente e inviare notifiche sullo stato degli ordini. Prima, per la configurazione iniziale dovevi lavorare autonomamente in diverse dashboard di Meta o assumere uno sviluppatore. Ora puoi completare questa parte in una conversazione con un agente. La gestione dei messaggi in arrivo al tuo indirizzo va comunque realizzata separatamente: è il passaggio successivo alla configurazione del webhook.
Il server è utile anche se la tua integrazione è già attiva. I modelli di messaggio richiedono aggiornamenti regolari: una nuova promozione, un nuovo testo per le notifiche. Tramite il server, l’agente crea o modifica un modello e ne mostra lo stato di approvazione senza rimandarti alla dashboard.
Un approccio simile—un agente si collega a un sistema esterno e ci lavora sulla base delle tue indicazioni—è illustrato con la documentazione nella guida Come collegare NotebookLM a Claude Code tramite MCP.
## E adesso?
Punti chiave
Controlla i prerequisiti, collega il server con un comando, accedi e leggi in sicurezza l’elenco delle aziende. Poi aggiungi un numero di telefono di prova e invia il primo messaggio. Ricorda che è in beta: per inviare messaggi in produzione, prepara un’integrazione completa con la Cloud API.
Sono passati tre giorni dall’annuncio del server. Puoi iniziare con un comando e accedere tramite Meta, poi chiedere all’agente l’elenco delle tue aziende. In seguito, a seconda delle tue esigenze: numeri di telefono, modelli, webhook, messaggi di prova.
Altri modi per collegare un agente a sistemi esterni sono raccolti nella guida [Server MCP per Claude Code](https://ailoot.ai/blog/it/mcp-servers-claude-code/)—ci sono altre sette integrazioni funzionanti per attività diverse.
### Fonti
- [Meta for Developers: annuncio di WhatsApp Business Tools MCP (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: documentazione di WhatsApp Business Tools MCP](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: panoramica dei server MCP per sviluppatori](https://developers.facebook.com/documentation/mcp)
- [WhatsApp Business Platform: documentazione](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Scopri [Ailoot](https://ailoot.ai/).
## Domande frequenti
### Qual è la prima verifica di connessione più prudente?
Dopo l’accesso OAuth, esamina l’elenco degli strumenti e leggi le aziende che puoi gestire. Così verifichi l’accesso prima di aggiungere un numero, creare modelli di messaggio, configurare webhook o inviare un messaggio di prova.
### Configurare un webhook realizza anche la gestione dei messaggi?
No. Il server MCP configura callback e sottoscrizioni, ma devi realizzare separatamente il CRM, il servizio di assistenza o il bot che riceve ed elabora i messaggi in arrivo a quell’indirizzo.
## Ailoot · L’azienda e il suo portafoglio di progetti
Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.
L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.
Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.