Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Z-API mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
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.
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.
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
- Ö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_IDund das Instanz-Token inZAPI_INSTANCE_TOKEN. - Ö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. - 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.
- Beginne mit
z_api_get_status:connected: falsebedeutet, 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
| Tool | What it does |
|---|---|
z_api_get_status | Check whether the Z-API instance is linked to a WhatsApp account and whether the phone is online |
z_api_get_instance | Get the Z-API instance name, connection flag, payment status and expiry date (Unix timestamp in due) |
z_api_get_device | Get the phone linked to the instance: its number, profile name, device model and whether it is a WhatsApp Business account |
z_api_check_phone_exists | Check whether a phone number has a WhatsApp account |
z_api_list_chats | List 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_chat | Get metadata of one chat: unread count, last message time, mute and spam flags, profile status and notes (WhatsApp Business only) |
z_api_list_contacts | List WhatsApp contacts known to the linked number, including people from shared groups, with phone, saved name and WhatsApp profile name |
z_api_list_queue | List messages still waiting in the instance's send queue, with phone, text and IDs |
z_api_send_text | Send a WhatsApp text message to a contact or group from the linked number |
z_api_send_image | Send an image by public HTTPS URL to a contact or group, with an optional caption |
z_api_send_document | Send a document (PDF, XLSX, DOCX...) by public HTTPS URL to a contact or group |
Nächste Schritte
War dieser Guide hilfreich?
