Come collegare WATI a Gemini 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 + Gemini

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di WATI.

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

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT