Whatsapp Business mit Gemini verbinden — über MCP

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → WhatsApp Business klicken, dauerhaftes System-User-Access-Token + WhatsApp Business Account ID einfügen, Gemini verbinden — fertig. Kein Docker, kein git clone, kein lokaler Server. Du kannst die lokalen Installationsschritte unten überspringen und direkt zur Client-Konfiguration weitergehen.

WhatsApp Business mit Gemini verbinden

Die WhatsApp Business Cloud API ist Metas gehostetes Gateway zum programmatischen Versenden von WhatsApp-Nachrichten — Text, Vorlagen, Medien, Sprachnachrichten, interaktive Buttons, Standorte. Mit AnythingMCP steuerst du alles aus Gemini CLI in Klartext. Kein SDK zu kleben, kein JSON-von-Hand für jeden Nachrichtentyp.

Was du Gemini fragen kannst

• "Sende 'Deine Bestellung wurde verschickt — verfolge sie auf https://acme.com/t/12345' an +49 151 5123 4567." Nutzt whatsapp_send_text_message (nur im 24-Stunden-Fenster, siehe unten).
• "Sende die Vorlage bestellbestaetigung (de) an +49 30 12345678, fülle 'Anna' und 'ORD-9912' ein." Nutzt whatsapp_send_template_message.
• "Sende das Rechnungs-PDF von https://acme.com/inv/9912.pdf an meinen Kunden mit Untertitel 'Rechnung 9912'." Nutzt whatsapp_send_document.
• "Liste die genehmigten Vorlagen auf meinem WABA und sende dann die Willkommensvorlage auf Deutsch an diesen neuen Lead." Nutzt whatsapp_list_message_templates, dann whatsapp_send_template_message.
• "Lass den Kunden ein Lieferfenster wählen: vormittags, nachmittags oder abends." Nutzt whatsapp_send_interactive_buttons (bis zu drei Antwort-Buttons).
• "Aktualisiere unser WhatsApp-Unternehmensprofil: neue Adresse und Öffnungszeiten in der Beschreibung." Nutzt whatsapp_update_business_profile.

Was du brauchst

• Ein WhatsApp Business Account (WABA) mit mindestens einer verifizierten Absende-Nummer. Metas Test-Nummer reicht zum Ausprobieren, sendet aber nur an Nummern, die du als Tester eingetragen hast.
• Ein dauerhaftes System-User-Access-Token mit whatsapp_business_messaging + whatsapp_business_management-Berechtigungen (das temporäre 24h-Dev-Token taugt zum Testen, läuft aber aus).
• Genehmigte Nachrichtenvorlagen für alles, was du außerhalb des 24-Stunden-Fensters sendest. Du legst sie in der Meta Business Suite an; Meta muss sie freigeben, bevor sie versendet werden können.
• AnythingMCP lokal oder auf cloud.anythingmcp.com (3-Minuten-Setup).
• Gemini CLI installiert.

Meta berechnet WhatsApp-Business-Nachrichten nach seiner eigenen Preisliste, unabhängig von AnythingMCP; die Preise für deine Länder findest du auf Metas WhatsApp-Preisseite.

Schritt 1 — WhatsApp-Business-Zugangsdaten holen

1. Öffne https://developers.facebook.com/ → deine App → WhatsApp → API Setup. Notiere die WhatsApp Business Account ID (WABA ID).
2. Gehe zu Meta Business Suite → Unternehmenseinstellungen → System Users, erstelle einen System User, weise dein WABA zu und Generiere ein neues Token mit whatsapp_business_messaging + whatsapp_business_management. Kopiere es — du siehst es nicht noch einmal.
3. Stelle sicher, dass deine Absende-Nummer in API Setup verifiziert ist (die Test-Nummer funktioniert sofort; für Produktion eigene Nummer hinzufügen und verifizieren).

Schritt 2 — WhatsApp-Business-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

Öffne http://localhost:3000/connectors/store, klicke WhatsApp Business und trage ein:

Klicke Install — der Adapter ist nun mit 14 Tools in deinem Katalog.

Schritt 3 — phoneNumberId einmalig ermitteln

Bitte Gemini, whatsapp_list_phone_numbers aufzurufen. Das Tool liest die Nummern des eingerichteten WABA und liefert die id jeder Absende-Nummer — diesen Wert fixieren, jedes Send-Tool braucht ihn als phoneNumberId. Eine Standardnummer wählt der Connector nicht für dich.

Empfänger kommen im internationalen Format ins Feld to, Ländervorwahl zuerst und ohne +: 4915151234567 für ein deutsches Handy, 15551234567 für die USA.

Schritt 4 — Connector in Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

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

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die WhatsApp Business-Tools aufrufen.

Verfügbare Tools (14 insgesamt)

Das 24-Stunden-Fenster — was dein Agent wissen muss

WhatsApp erlaubt Freitext-Nachrichten (Text, Medien, interaktiv, Standort) nur in den 24 Stunden nach der letzten eingehenden Nachricht des Nutzers an deine Nummer. Außerhalb dieses Fensters sind nur vorab genehmigte Vorlagen erlaubt — rufe whatsapp_send_template_message mit Name und Sprache der Vorlage auf.

Das instructions-Feld des Adapters teilt Gemini diese Regel mit, sodass Gemini bei "sende ein Follow-up an diesen Kunden" Tage nach der letzten Antwort whatsapp_send_template_message statt Freitext nutzt.

Sprachnachrichten

Nutze whatsapp_send_audio mit link auf eine OGG-Opus-Datei auf einer öffentlichen HTTPS-URL. WhatsApp rendert OGG-Opus als echte Sprachnachricht (Wellenform + Play-Button). MP3 und AMR funktionieren, erscheinen aber als reine Audio-Anhänge.

Fehlerbehebung

• Gestern ging alles, heute wird jeder Aufruf abgelehnt. Wahrscheinlich nutzt du noch das temporäre Access-Token aus API Setup, das nach 24 Stunden abläuft. Erzeuge ein dauerhaftes System-User-Token und ersetze WHATSAPP_ACCESS_TOKEN.
• Senden scheitert, Vorlagen lesen klappt. Dem System-User-Token fehlt whatsapp_business_messaging, oder der System User ist diesem WABA nicht zugewiesen. Du brauchst beide Berechtigungen: whatsapp_business_management für Vorlagen und Nummern, whatsapp_business_messaging zum Senden.
• Eine Vorlage wird abgelehnt. Die Vorlage ist noch nicht APPROVED, oder Name oder Sprachcode stimmen nicht exakt. Lass Gemini das vorher mit whatsapp_list_message_templates prüfen.
• Ein Bild oder Dokument kommt nie an. Der link muss eine öffentliche HTTPS-URL sein, die Metas Server herunterladen können, innerhalb der WhatsApp-Größenlimits (Bild 5 MB, Audio und Video 16 MB, Dokument 100 MB).
• Die Empfängernummer wird abgelehnt. Nutze das internationale Format ohne +, Leerzeichen oder führende Null, zum Beispiel 4915151234567.

FAQ

Funktioniert das ohne verifizierte Geschäftsnummer? Metas Test-Nummer funktioniert zum Testen (nur Versand an als Tester hinzugefügte Nummern). Für Produktionsversand an beliebige Empfänger muss deine Absende-Nummer verifiziert und auf deinem WABA registriert sein.

Was passiert, wenn ich Freitext außerhalb des 24h-Fensters sende? Meta antwortet mit Fehlercode 131047 ("Re-engagement message"). Nutze whatsapp_send_template_message.

Kann der Adapter eingehende Nachrichten empfangen? Nicht direkt — Meta nutzt Webhooks für Inbound, und die AnythingMCP REST-Engine ist nur outbound. Betreibe einen kleinen Webhook-Receiver neben AnythingMCP und nutze diesen Connector für outbound + whatsapp_mark_message_as_read für Lesebestätigungen.

Ist das kostenlos? AnythingMCP ist Open Source unter AGPL-3.0: Self-Hosting ist kostenlos, auch für die kommerzielle Nutzung in deinem eigenen Unternehmen; AnythingMCP Cloud kannst du 7 Tage kostenlos testen. Die WhatsApp-Nachrichten selbst rechnet Meta nach seinen Preisen ab.

Speichert AnythingMCP meine Daten? Dein Meta-Access-Token liegt verschlüsselt (AES-256-GCM) in deinem Workspace und wird Gemini nie gezeigt. AnythingMCP reicht jede Sendeanfrage an Meta weiter und die Antwort zurück an Gemini, und jeder Aufruf landet im Audit-Log deines Workspaces. Eingehende Nachrichten erreichen AnythingMCP nie; sie gehen an deinen eigenen Webhook.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Landingpage
• Verbinde mit Claude
• Verbinde mit ChatGPT
• Verbinde mit Cursor
• Verbinde mit Meta Muse