ConverZAP — WhatsApp (official API)

ConverZAP MCP 服务

通过 ConverZAP 将 AI 助手和 Agent（Claude、ChatGPT、Cursor、Cline、Agent 框架……）连接到 WhatsApp——官方 WhatsApp Business Platform（Meta Cloud API），并作为 Meta 验证的技术服务提供商。

此服务将 ConverZAP 工作区作为 MCP 工具开放：读取和管理联系人、读取会话并发送 WhatsApp 消息和已批准的模板、管理 CRM 销售流程、运行营销活动、将联系人加入自动化流程以及读取报告。每个工具在内部都通过 ConverZAP 公共 API (v1) 运行，因此，每项操作都遵循与你的账户相同的权限、作用域和速率限制——连接的权限绝不会超出成员的角色。

此代码库包含托管服务的文档和连接设置。服务本身运行在 ConverZAP 的基础设施上——无需安装或自行托管。

工具

共 15 个工具。读取工具可放心随时调用；写入工具支持 dry_run 模式，可在不执行操作的情况下进行验证；send_message / start_campaign 标记为破坏性操作，因此助手会先请求确认。

工具	类型	功能
whoami	读取	账户、你的角色、已授予的权限、套餐和已连接的 WhatsApp 号码
find_contacts	读取	按电话号码、姓名、电子邮件或标签搜索联系人
get_contact	读取	完整联系人卡片，包含近期会话和未完成的交易
list_conversations	读取	列出收件箱会话（未关闭、等待人工处理、等待回复……）
read_conversation	读取	读取会话消息和状态（包括 24 小时窗口）
list_templates	读取	列出已批准的 WhatsApp 模板
get_results	读取	收件箱报告和营销活动结果
send_message	写入 · 破坏性操作	发送文本或已批准的模板
schedule_message	写入	安排稍后发送消息
update_conversation	写入	分配、解决、重新打开、暂缓处理、添加标签、添加备注，以及将会话移交给 AI Agent 或从 AI Agent 接管
upsert_contact	写入	创建或更新联系人
manage_deal	写入	创建、更新 CRM 交易，或将交易移至不同阶段
create_campaign_draft	写入	创建营销活动草稿
start_campaign	写入 · 破坏性操作	启动营销活动
enroll_in_automation	写入	将联系人加入自动化流程（或将其移除）

消息速率限制： 每个连接每分钟 30 条、每天 300 条（此外还受套餐自身限制约束）。

要求

• ConverZAP 账户，且所用套餐包含公共 API。
• 使用在应用中通过 Settings → Public API 创建的 API 密钥（czk_live_…），或使用账户通过 OAuth 登录。访问权限受成员角色限制；免费试用期间为只读。

连接

这是一个位于以下地址的远程 MCP 服务（Streamable HTTP）：

https://mcp.converzap.com

它支持两种身份验证方式——选择客户端更便于使用的一种即可。

选项 A — OAuth（建议用于支持远程 MCP 的客户端）

Claude（作为自定义连接器）等支持远程 MCP 的客户端会自动处理 OAuth：只需按 URL 添加服务并登录。你将登录 ConverZAP，选择工作区并确认要授予的权限——写入权限默认不勾选。

Server URL: https://mcp.converzap.com
Auth:       OAuth (the client opens the login automatically)

无需复制或保存 API 密钥——令牌由客户端保管。

选项 B — API 密钥（适用于所有客户端，包括仅支持 stdio 的客户端）

将密钥作为 bearer 请求头发送。对于仅支持 stdio 的客户端（某些桌面端配置），可使用 mcp-remote 桥接远程服务：

{
  "mcpServers": {
    "converzap": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.converzap.com",
        "--header", "Authorization: Bearer ${CONVERZAP_API_KEY}"
      ],
      "env": { "CONVERZAP_API_KEY": "czk_live_…" }
    }
  }
}

支持原生远程 MCP 的客户端也可以直接添加 URL https://mcp.converzap.com，并设置请求头 Authorization: Bearer czk_live_…。

示例提示词

• “列出我待人工处理的未结束 WhatsApp 对话。”
• “向联系人发送已批准的 lembrete 模板。”
• “创建联系人，并将其商机移至 Negotiation 阶段。”
• “本周有多少条消息已送达？”

安全

• 访问权限受成员的角色和范围限制——使用 OAuth 时，仅授予最低限度的权限（默认不勾选写入权限）；使用 API 密钥时，只创建包含所需范围的密钥。
• 请像对待密码一样保护 API 密钥，并将其保存在服务器端。你可以随时在 Settings → Public API 中撤销密钥，或断开 OAuth 连接——两者都会立即生效。
• 发现漏洞？请发送邮件至 [email protected]，不要公开提交 issue。参见 SECURITY.md。

链接

• API 文档：https://developers.converzap.com
• OpenAPI：https://api.converzap.com/v1/openapi.json
• SDK：https://github.com/converzap/converzap-sdk
• 网站：https://converzap.com

许可证

MIT