WATI su MCP: gestisci la inbox WhatsApp Business da qualsiasi agente AI

💡 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

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.

Setup

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.

Prerequisiti: WATI_API_ENDPOINT, WATI_ACCESS_TOKEN

Installazione locale del connettore

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, scegli WATI e inserisci le variabili elencate nei Prerequisiti.

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."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT