Come collegare WATI a Microsoft Copilot via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → WATI, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

WATI + Microsoft Copilot

Gestisci la inbox WhatsApp Business di WATI dalla tua AI: elenca i modelli approvati, trova, aggiungi e aggiorna i contatti, leggi la cronologia chat di un contatto, assegna le conversazioni ai membri del team e invia un messaggio modello. Gli invii di sessione, interattivi e massivi sono disattivati all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

WATI_API_ENDPOINT, WATI_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un workspace WATI con piano Growth o superiore, con il suo API Endpoint e il suo Access Token.

1. Accedi a WATI e apri API Docs nel menu (nei workspace più recenti Connector → API).
2. Copia l'API Endpoint in WATI_API_ENDPOINT così come lo mostra WATI, per esempio https://live-mt-server.wati.io/123456, senza /api/v1 alla fine. Il numero finale è l'id del tuo workspace (tenant).
3. Copia l'Access Token in WATI_ACCESS_TOKEN senza la parola Bearer: WATI lo mostra come Bearer eyJ..., quindi incolla solo la parte da eyJ in poi.
4. Installa il connettore ed esegui wati_list_message_templates: elenca i tuoi modelli WhatsApp e conferma che endpoint e token vanno insieme.

Solo API v1: il connettore usa l'API v1 di WATI. La più recente API v3 non accetta il token della schermata API Docs, quindi le sue funzioni aggiuntive (tag e stato delle conversazioni, canali, campagne, crediti) non fanno parte di questo connettore. Il token viene inviato solo al tuo API Endpoint e smette di funzionare quando cambia la password dell'account.

Cosa legge: i tuoi modelli di messaggio con categoria, stato (APPROVED, PENDING, REJECTED), lingua, intestazione, testo con i segnaposto, piè di pagina e pulsanti; i tuoi contatti con numero WhatsApp, nome, opt-in, permesso per i broadcast, attributi personalizzati e team, filtrabili per nome, attributo o data di creazione; e la cronologia chat con un contatto, dai messaggi più recenti, con stato di consegna, eventi di operatore e ticket.

Numeri: i numeri WhatsApp vanno in formato internazionale con il prefisso del paese e senza + né spazi, per esempio 393331234567. Dove uno strumento chiede un contatto puoi passare anche un id contatto di WATI. Se il tuo workspace ha più numeri WhatsApp, l'AI può scegliere quale numero aziendale usare.

Modelli e finestra di 24 ore: fuori dalle 24 ore successive all'ultimo messaggio del cliente WhatsApp consente solo modelli approvati, e si possono inviare solo modelli con stato APPROVED. Dentro la finestra sono consentiti testo libero e pulsanti di risposta. Meta addebita i messaggi modello per conversazione.

Chiede prima di ogni modifica: wati_send_template_message invia un modello a un numero e il cliente lo riceve subito; wati_add_contact aggiunge un contatto con nome e attributi personalizzati; wati_update_contact_attributes imposta attributi come stato dell'ordine o fase del lead e lascia invariati gli altri. Prima di ognuno l'AI ti mostra numero, modello e valori o la modifica e aspetta il tuo sì. wati_assign_operator passa una chat a un membro del team tramite email, o di nuovo al bot, e modifica solo la inbox condivisa.

Disattivati all'installazione: wati_send_session_message (testo libero in una sessione di 24 ore aperta), wati_send_interactive_buttons (un messaggio con fino a tre pulsanti di risposta) e wati_send_template_broadcast (un modello a fino a 1.000 numeri per chiamata, e ogni destinatario riceve il messaggio e viene addebitato). Raggiungono direttamente i clienti, quindi un amministratore li attiva consapevolmente, e anche allora l'AI conferma con te ogni invio.

Limiti: circa 10 richieste ogni 10 secondi per contatti e messaggi, e da 30 a 100 invii di modelli ogni 10 secondi a seconda del piano. Un 429 significa aspettare qualche secondo e riprovare.

Errori comuni: 401 significa che il token è sbagliato, scaduto o inizia ancora con Bearer. 403 significa che il token o il tuo piano non consentono la chiamata. 404 di solito indica un API Endpoint sbagliato. WATI risponde ad alcuni errori anche con HTTP 200 e result false, per esempio un numero non valido o un modello non approvato: il connettore li trasforma in errori con il testo di WATI. Un contatto che non ha mai chattato con te non ha cronologia (Can't find Conversation). Un invio riuscito significa che WATI ha accettato il messaggio, non che sia stato consegnato.

Il connettore non usa l'API v3, non crea né elimina modelli, non pianifica campagne o invii da CSV, non invia media, file, messaggi a elenco o CTA, non crea chatbot o segmenti, non configura webhook, non gestisce WhatsApp Pay e non rinnova il token.

Step 2 — Installa l'adapter

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

Step 3 — 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 WATI.
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

Esempi di prompt

• "Trova il contatto Chiara Ferri e mostrami i suoi ultimi messaggi WhatsApp con noi."
• "Quali dei nostri modelli approvati vanno bene per avvisare che un ordine è stato spedito, e quali valori richiedono?"
• "Invia il modello order_shipped a 393331234567 con nome Luca e numero ordine 4512. Fammi vedere tutto prima che parta."
• "Imposta lead_stage a qualified per 393479876543 e assegna la chat a [email protected]."
• "Elenca i contatti creati oggi che hanno come città Milano."

FAQ

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

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse