Collegare WhatsApp Business MCP a Microsoft Copilot

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → WhatsApp Business, inserisci il System User access token permanente + l'ID del WhatsApp Business Account, genera una MCP API key — fatto. Niente Docker, niente git clone, niente server locale da avviare. Salta i passi di installazione locale qui sotto e vai direttamente alla configurazione del client.

Collegare WhatsApp Business a Copilot

La WhatsApp Business Cloud API è il gateway ospitato da Meta per inviare messaggi WhatsApp via API — testo, template, media, messaggi vocali, pulsanti interattivi, geolocalizzazione. Con AnythingMCP guidi tutto da Microsoft Copilot in italiano. Niente SDK da incollare, niente JSON-a-mano per ogni tipo di messaggio.

Cosa puoi fare

• "Invia 'Il tuo ordine è stato spedito — traccialo su https://acme.com/t/12345' al +39 348 5123 456."
• "Invia il template conferma_ordine (it) al +39 333 123 4567, compila 'Mario' e 'ORD-9912'."
• "Invia il PDF di fattura su https://acme.com/inv/9912.pdf al mio cliente con didascalia 'Fattura 9912'."
• "Lista i template approvati sul mio WABA, poi invia quello di benvenuto in italiano a questo nuovo lead."

Prerequisiti

• Un WhatsApp Business Account (WABA) con almeno un numero mittente verificato.
• Un System User access token permanente con i permessi whatsapp_business_messaging + whatsapp_business_management (il token dev temporaneo di 24h va bene per test ma scade).
• AnythingMCP in locale o su cloud.anythingmcp.com (setup di 3 minuti).
• Un account di lavoro con accesso a Copilot Studio (per aggiungere il connettore a Microsoft Copilot).

Step 1 — Ottieni le credenziali WhatsApp Business

1. Apri https://developers.facebook.com/ → la tua App → WhatsApp → API Setup. Annota il WhatsApp Business Account ID (WABA ID).
2. Vai su Meta Business Suite → Impostazioni Business → System Users, crea un System User, assegna il tuo WABA e Genera un nuovo token con i permessi whatsapp_business_messaging + whatsapp_business_management. Copialo — non lo rivedi più.
3. Verifica che il numero mittente sia verificato in API Setup (il numero di test funziona subito; per la produzione aggiungi e verifica il tuo).

Step 2 — Installa l'adapter WhatsApp Business

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, clicca WhatsApp Business e compila:

Clicca Install — l'adapter è ora nel tuo catalogo con 14 tool.

Step 3 — Scopri il tuo phoneNumberId

Chiedi a Copilot di chiamare whatsapp_list_phone_numbers (con il tuo WABA ID come businessAccountId). Riceverai l'id di ciascun numero mittente — fissa quel valore, ogni tool di invio lo richiede come phoneNumberId.

Step 4 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di WhatsApp Business.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Tool disponibili (14 totali)

La finestra di 24 ore — cosa deve sapere il tuo agente

WhatsApp consente l'invio di messaggi free-form (testo, media, interattivi, posizione) solo nelle 24 ore successive all'ultimo messaggio in entrata dell'utente verso il tuo numero. Fuori da quella finestra puoi inviare solo template pre-approvati — chiama whatsapp_send_template_message con il nome del template e la lingua.

Il campo instructions dell'adapter comunica questa regola a Copilot, così quando chiedi "manda un follow-up a quel cliente" giorni dopo la sua ultima risposta, Copilot userà whatsapp_send_template_message invece del testo libero.

Messaggi vocali

Usa whatsapp_send_audio con link puntato a un file OGG-Opus ospitato su un URL HTTPS pubblico. WhatsApp renderizza OGG-Opus come vero messaggio vocale (forma d'onda + pulsante play). MP3 e AMR funzionano ma compaiono come allegati audio normali.

FAQ

Funziona senza un numero business verificato? Il numero di test di Meta funziona per le prove (solo verso numeri aggiunti come tester). Per inviare in produzione a qualsiasi destinatario, il tuo numero mittente deve essere verificato e registrato sul tuo WABA.

Cosa succede se invio testo libero fuori dalla finestra 24h? Meta risponde con codice 131047 ("Re-engagement message"). Usa whatsapp_send_template_message.

L'adapter può ricevere messaggi in entrata? No direttamente — Meta usa webhook per l'inbound, e il REST engine di AnythingMCP è outbound-only. Fai girare un piccolo receiver webhook accanto a AnythingMCP e usa questo connettore per outbound + whatsapp_mark_message_as_read per le ricevute.

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT
• Collega a Cursor
• Collega a Gemini
• Collega a Meta Muse