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.
7 天免费 · 无需信用卡 · EU 托管
问 Z-API 任何事
通过 AnythingMCP 对 Z-API 试一个真实提示 — Claude 调用工具并返回答案。在你的消息上按 Enter 即可在 Cloud 安装。
在 Cloud 上安装 Z-APIClaude 是 AI，可能会出错。请核对回答。
2 分钟设置
- 1在 cloud.anythingmcp.com 开始免费试用。
- 2在连接器商店点击 Z-API。提示时粘贴凭据。
- 3生成 MCP API 密钥，将 AI 客户端指向生成的 MCP URL。
Z-API 指南
面向主流 AI 客户端的逐步设置。
配置 Z-API
直接来自连接器定义：在哪里获取凭据、需要哪些权限，以及该适配器调用的是哪个 API。 由连接器作者以英文提供。
Z-API is a third-party WhatsApp gateway: it runs a WhatsApp Web session for a number you link yourself. It is not Meta's official WhatsApp Business API, and WhatsApp may restrict or ban numbers that send in bulk.
Getting credentials
- In the Z-API panel, open Instances, create or pick an instance and click edit. Copy the instance ID into
ZAPI_INSTANCE_IDand the instance token intoZAPI_INSTANCE_TOKEN. - Open the Security tab, module Account Security Token, click Set Up Now and copy the token into
ZAPI_CLIENT_TOKEN. Then click Activate Token so every request must carry it. - Link the phone first: scan the instance QR code in the panel with WhatsApp (Linked devices). Until then every send fails.
Workflow: call z_api_get_status first. connected: false means the QR code must be scanned again; smartphoneConnected: false means the phone is offline. Use z_api_list_chats or z_api_check_phone_exists to find the right recipient before sending.
Formats: phone numbers are digits only, country code + area code + number, no +, spaces or dashes: 5511999999999. Group chats use their ID from z_api_list_chats, e.g. 120363019502650977-group. Text supports *bold*, _italic_ and ~strike~. Images and documents are sent by public HTTPS URL; Z-API downloads them (files up to 100 MB).
Sending: the send tools write real WhatsApp messages. Always confirm the recipient and the exact text with the user before calling them, and never retry a send that returned a messageId. Messages go through a queue; z_api_list_queue shows what is still waiting.
Pagination and limits: chats and contacts take page and pageSize (both required by Z-API; the tools default to page 1). Ask for the next page until fewer results than pageSize come back. The queue uses the pagingState cursor until hasMore is false. Z-API sets no message cap, but WhatsApp watches the number: keep volumes modest and space sends minutes apart. Plans are billed per instance, with a 2-day free trial.
Cloud reachability: api.z-api.io is a public HTTPS API, reachable from AnythingMCP Cloud. If you enabled IP restriction in the Z-API Security tab, allow the AnythingMCP outbound address or turn the restriction off.