Connector-Anleitung3 Minuten Lesezeit11 MCP-Tools7 Sprachen

Z-API MCP-Server für WhatsApp-Chats und Nachrichten

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

HCVom HelpCode-TeamAktualisiert 3 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Z-API

Z-API

Z-API WhatsApp gateway from Brazil: check the instance connection, browse chats and contacts, verify numbers on WhatsApp and send text, image and document messages through a WhatsApp number linked by QR code.

Tools

11

Region

BR

Kategorie

Messaging

Authentifizierung

API Key

Benötigte Env-Vars

ZAPI_INSTANCE_IDZAPI_INSTANCE_TOKENZAPI_CLIENT_TOKEN
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

Zusammenfassung

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Geführte Einrichtung

Z-API in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Z-API in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Frag einfach

Beispiel-Prompts für Z-API

Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.

Z-API · live via MCP
Teilen
Opus 4.7

Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.

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

Z-API

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Einrichtung

  1. Öffne im Z-API-Panel (app.z-api.io) Instances, lege eine Instanz an oder wähle eine aus und klicke auf Bearbeiten. Kopiere die Instanz-ID in ZAPI_INSTANCE_ID und das Instanz-Token in ZAPI_INSTANCE_TOKEN.
  2. Öffne den Tab Security, Modul Account Security Token, klicke auf Set Up Now und kopiere das Token in ZAPI_CLIENT_TOKEN. Klicke danach auf Activate Token, damit jede Anfrage es mitsenden muss.
  3. Verknüpfe das Telefon: Scanne den QR-Code der Instanz mit WhatsApp (Linked devices). Solange die Nummer nicht verknüpft ist, schlägt jeder Versand fehl.
  4. Beginne mit z_api_get_status: connected: false bedeutet, dass der QR-Code erneut gescannt werden muss, smartphoneConnected: false, dass das Telefon offline ist.

Z-API ist ein Gateway eines Drittanbieters, das eine WhatsApp-Web-Sitzung für deine Nummer betreibt. Es ist nicht die offizielle WhatsApp Business API von Meta, und WhatsApp kann Nummern einschränken, die Massennachrichten versenden. Telefonnummern bestehen nur aus Ziffern, mit Länder- und Ortsvorwahl und ohne +, Leerzeichen oder Bindestriche (5511999999999). Die Sende-Tools verschicken echte WhatsApp-Nachrichten: Bestätige vorher Empfänger und Text, und wiederhole nie einen Versand, der eine messageId zurückgegeben hat. Wenn du im Security-Tab von Z-API die IP-Beschränkung aktiviert hast, gib die ausgehende Adresse von AnythingMCP frei.

Voraussetzungen: ZAPI_INSTANCE_ID, ZAPI_INSTANCE_TOKEN, ZAPI_CLIENT_TOKEN

Connector lokal 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, wähle Z-API und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

ToolWhat it does
z_api_get_statusCheck whether the Z-API instance is linked to a WhatsApp account and whether the phone is online
z_api_get_instanceGet the Z-API instance name, connection flag, payment status and expiry date (Unix timestamp in due)
z_api_get_deviceGet the phone linked to the instance: its number, profile name, device model and whether it is a WhatsApp Business account
z_api_check_phone_existsCheck whether a phone number has a WhatsApp account
z_api_list_chatsList the WhatsApp chats of the linked number (people and groups) with phone or group ID, name, unread count and last message time
z_api_get_chatGet metadata of one chat: unread count, last message time, mute and spam flags, profile status and notes (WhatsApp Business only)
z_api_list_contactsList WhatsApp contacts known to the linked number, including people from shared groups, with phone, saved name and WhatsApp profile name
z_api_list_queueList messages still waiting in the instance's send queue, with phone, text and IDs
z_api_send_textSend a WhatsApp text message to a contact or group from the linked number
z_api_send_imageSend an image by public HTTPS URL to a contact or group, with an optional caption
z_api_send_documentSend a document (PDF, XLSX, DOCX...) by public HTTPS URL to a contact or group

Nächste Schritte

War dieser Guide hilfreich?

Z-API in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Z-API in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

Z-API MCP mit Microsoft Copilot verbinden

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Connectors

Z-API MCP mit ChatGPT verbinden

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Connectors

Z-API MCP mit Claude verbinden

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Connectors

Z-API MCP mit Cursor verbinden

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Connectors

Z-API MCP mit Gemini CLI verbinden

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.

Connectors

Z-API MCP mit Meta Muse verbinden

Z-API, das WhatsApp-Gateway aus Brasilien: Verbindung der Instanz prüfen, Chats und Kontakte durchsuchen, Nummern auf WhatsApp verifizieren und Text-, Bild- und Dokumentnachrichten über eine per QR-Code verknüpfte WhatsApp-Nummer senden.