如何将 Whatsapp Business 连接到 Gemini — 通过 MCP

💡 无需安装？直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → WhatsApp Business、粘贴永久 System User 访问令牌 + WhatsApp Business Account ID、生成 MCP API Key — 完成。无 Docker、无 git clone、无本地服务器。你可以跳过下方的本地安装步骤，直接进入客户端接入章节。

将 WhatsApp Business 连接到 Gemini

WhatsApp Business Cloud API 是 Meta 托管的网关，用于通过程序发送 WhatsApp 消息——文本、模板、媒体、语音消息、交互按钮、位置。使用 AnythingMCP，你可以从 Gemini CLI 以自然语言驱动一切。无 SDK 拼接、无需为每种消息类型手写 JSON。

你能做什么

• "把『你的订单已发货 — 跟踪 https://acme.com/t/12345』发送到 +86 138 0013 8000。"
• "把 order_confirmation 模板（en_US）发送到 +1 555 123 4567，填入 'John' 和 'ORD-9912'。"
• "把 https://acme.com/inv/9912.pdf 的发票 PDF 发送给我的客户，附加说明 'Invoice 9912'。"
• "列出我 WABA 上已批准的模板，然后用意大利语向这位新线索发送欢迎模板。"

前提条件

• 一个 WhatsApp Business Account (WABA)，至少有一个已验证的发送号码。
• 一个具有 whatsapp_business_messaging + whatsapp_business_management 权限的 永久 System User 访问令牌（临时 24 小时开发令牌可用于测试但会过期）。
• 在本地或 cloud.anythingmcp.com 上运行的 AnythingMCP（3 分钟设置）。
• 已安装 Gemini CLI。

步骤 1 — 获取 WhatsApp Business 凭证

1. 打开 https://developers.facebook.com/ → 你的 App → WhatsApp → API Setup。记下 WhatsApp Business Account ID (WABA ID)。
2. 前往 Meta Business Suite → Business Settings → System Users，创建 System User，分配你的 WABA，并使用 whatsapp_business_messaging + whatsapp_business_management 权限 生成新令牌。复制它 — 不会再显示。
3. 确认你的发送号码已在 API Setup 中 验证（测试号码立即可用；生产环境需添加并验证自己的号码）。

步骤 2 — 安装 WhatsApp Business adapter

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

打开 http://localhost:3000/connectors/store，点击 WhatsApp Business 并填入：

点击 Install — adapter 现在已在你的目录中，包含 14 个工具。

步骤 3 — 一次性查找你的 phoneNumberId

请 Gemini 调用 whatsapp_list_phone_numbers（将你的 WABA ID 作为 businessAccountId）。你会得到每个发送号码的 id — 固定这个值，每个发送工具都需要它作为 phoneNumberId。

步骤 4 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list）— anythingmcp 应显示为已连接。
4. 开始输入提示 — Gemini CLI 现在可以调用 WhatsApp Business 的工具。

可用工具（共 14 个）

24 小时窗口 — 你的代理需要知道的

WhatsApp 仅允许 自由格式 消息（文本、媒体、交互式、位置）在用户最后向你的号码发送消息后的 24 小时 内发送。该窗口外仅允许 预审核模板 — 使用模板名称和语言调用 whatsapp_send_template_message。

adapter 的 instructions 字段将这条规则告诉 Gemini，因此当你在用户最后回复几天后请求"给那位客户发个跟进"时，Gemini 会使用 whatsapp_send_template_message 而非自由文本。

语音消息

使用 whatsapp_send_audio，将 link 指向托管在公开 HTTPS URL 上的 OGG-Opus 文件。WhatsApp 将 OGG-Opus 显示为真正的语音消息（波形 + 播放按钮）。MP3 和 AMR 也可用，但显示为普通音频附件。

FAQ

没有已验证的企业号码也能用吗？ Meta 的测试号码可用于测试（仅发送给作为测试者添加的号码）。在生产环境向任何收件人发送，你的发送号码必须在 WABA 上已验证并已注册。

在 24 小时窗口外发送自由文本会怎样？ Meta 返回错误代码 131047（"Re-engagement message"）。使用 whatsapp_send_template_message。

adapter 能接收入站消息吗？ 不能直接接收 — Meta 通过 webhook 处理入站，而 AnythingMCP REST 引擎仅支持出站。在 AnythingMCP 旁边运行一个小型 webhook 接收器，使用此连接器处理出站 + whatsapp_mark_message_as_read 用于确认。

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器登陆页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse