WATI über MCP mit Meta Muse verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → WATI klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

WATI + Meta Muse

Steuere dein WATI-Postfach für WhatsApp Business mit deiner KI: freigegebene Vorlagen auflisten, Kontakte finden, anlegen und aktualisieren, den Chatverlauf eines Kontakts lesen, Unterhaltungen Teammitgliedern zuweisen und eine Vorlagennachricht senden. Session-, interaktive und Massennachrichten sind bei der Installation ausgeschaltet.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

WATI_API_ENDPOINT, WATI_ACCESS_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst einen WATI-Workspace mit dem Growth-Tarif oder höher sowie dessen API Endpoint und Access Token.

1. Melde dich bei WATI an und öffne im Menü API Docs (in neueren Workspaces Connector → API).
2. Kopiere den API Endpoint so, wie WATI ihn zeigt, in WATI_API_ENDPOINT, z. B. https://live-mt-server.wati.io/123456, ohne /api/v1 am Ende. Die Zahl am Ende ist die ID deines Workspace (Tenant).
3. Kopiere den Access Token in WATI_ACCESS_TOKEN, ohne das Wort Bearer: WATI zeigt ihn als Bearer eyJ..., füge also nur den Teil ab eyJ ein.
4. Installiere den Connector und rufe wati_list_message_templates auf: Es listet deine WhatsApp-Vorlagen und zeigt, dass Endpoint und Token zusammenpassen.

Nur API v1: Der Connector arbeitet mit der API v1 von WATI. Die neuere API v3 akzeptiert den Token aus der Ansicht API Docs nicht, deshalb gehören ihre zusätzlichen Funktionen (Tags und Status von Unterhaltungen, Kanäle, Kampagnen, Credits) nicht zu diesem Connector. Der Token geht nur an deinen API Endpoint und funktioniert nicht mehr, sobald das Passwort des Kontos geändert wird.

Was sie liest: deine Nachrichtenvorlagen mit Kategorie, Status (APPROVED, PENDING, REJECTED), Sprache, Kopfzeile, Text mit Platzhaltern, Fußzeile und Buttons; deine Kontakte mit WhatsApp-Nummer, Name, Opt-in, Broadcast-Erlaubnis, eigenen Attributen und Teams, gefiltert nach Name, Attribut oder Erstellungsdatum; und den Chatverlauf mit einem Kontakt, die neuesten Nachrichten zuerst, mit Zustellstatus, Operator- und Ticket-Ereignissen.

Nummern: WhatsApp-Nummern stehen im internationalen Format mit Ländervorwahl und ohne + oder Leerzeichen, z. B. 4915123456789. Wo ein Tool einen Kontakt erwartet, geht auch eine WATI-Kontakt-ID. Hat dein Workspace mehrere WhatsApp-Nummern, kann die KI wählen, welche Business-Nummer sie nutzt.

Vorlagen und das 24-Stunden-Fenster: Außerhalb der 24 Stunden nach der letzten Nachricht des Kunden erlaubt WhatsApp nur freigegebene Vorlagen, und senden lassen sich nur Vorlagen mit dem Status APPROVED. Innerhalb des Fensters sind freier Text und Antwort-Buttons erlaubt. Meta berechnet Vorlagennachrichten pro Unterhaltung.

Fragt vor jeder Änderung: wati_send_template_message schickt eine Vorlage an eine Nummer, und der Kunde bekommt sie sofort; wati_add_contact legt einen Kontakt mit Name und eigenen Attributen an; wati_update_contact_attributes setzt Attribute wie Bestellstatus oder Lead-Phase und lässt die übrigen unverändert. Vor jedem dieser Schritte zeigt dir die KI Nummer, Vorlage und Werte oder die Änderung und wartet auf dein Ja. wati_assign_operator gibt einen Chat per E-Mail an ein Teammitglied oder zurück an den Bot und ändert nur das gemeinsame Postfach.

Bei der Installation deaktiviert: wati_send_session_message (freier Text in einer offenen 24-Stunden-Session), wati_send_interactive_buttons (eine Nachricht mit bis zu drei Antwort-Buttons) und wati_send_template_broadcast (eine Vorlage an bis zu 1.000 Nummern pro Aufruf, jeder Empfänger bekommt sie und wird berechnet). Sie erreichen Kunden direkt, deshalb schaltet ein Administrator sie bewusst ein, und auch dann bestätigt die KI jeden Versand mit dir.

Limits: etwa 10 Anfragen pro 10 Sekunden für Kontakte und Nachrichten und je nach Tarif 30 bis 100 Vorlagenversände pro 10 Sekunden. Ein 429 heißt: ein paar Sekunden warten und erneut versuchen.

Häufige Fehler: 401 bedeutet, dass der Token falsch oder abgelaufen ist oder noch mit Bearer beginnt. 403 heißt, dass der Token oder dein Tarif den Aufruf nicht erlaubt. 404 bedeutet meist einen falschen API Endpoint. Manche Fehler beantwortet WATI mit HTTP 200 und result false, etwa bei einer ungültigen Nummer oder einer nicht freigegebenen Vorlage: Der Connector macht daraus Fehler mit dem Text von WATI. Ein Kontakt, der nie mit dir gechattet hat, hat keinen Chatverlauf (Can't find Conversation). Ein erfolgreicher Versand heißt, dass WATI die Nachricht angenommen hat, nicht, dass sie zugestellt wurde.

Der Connector nutzt nicht die API v3, legt keine Vorlagen an und löscht keine, plant keine Kampagnen oder CSV-Versände, sendet keine Medien, Dateien, Listen- oder CTA-Nachrichten, baut keine Chatbots oder Segmente, richtet keine Webhooks ein, wickelt kein WhatsApp Pay ab und erneuert den Token nicht.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Muse hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die WATI-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Finde den Kontakt Julia Becker und zeig mir ihre letzten WhatsApp-Nachrichten mit uns.“
• „Welche unserer freigegebenen Vorlagen passen für eine Versandbestätigung, und welche Werte brauchen sie?“
• „Schick die Vorlage order_shipped an 4915123456789 mit dem Namen Tobias und der Bestellnummer 4512. Zeig mir alles, bevor sie rausgeht.“
• „Setz lead_stage für 4917612345678 auf qualified und weise den Chat [email protected] zu.“
• „Liste die Kontakte, die heute angelegt wurden und deren Stadt München ist.“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden