连接器指南阅读约 3 分钟14 个 MCP 工具7 种语言

将 WhatsApp Business MCP 连接到 Microsoft Copilot

使用 AnythingMCP 将 Meta 的 WhatsApp Business Cloud API 连接到 Copilot。从 Microsoft Copilot 以自然语言发送文本、模板、媒体、语音消息和交互按钮。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

WhatsApp Business Cloud API

WhatsApp Business Cloud API

Send WhatsApp messages (text, templates, images, audio/voice notes, video, documents, location, interactive buttons) from a WhatsApp Business account using Meta's Cloud API. Free tier of 1000 service conversations per month per business account.

个工具

14

区域

INTL

类别

即时通讯

身份验证

Bearer Token

所需环境变量

WHATSAPP_ACCESS_TOKENWHATSAPP_BUSINESS_ACCOUNT_ID
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

跳过安装。2 分钟内即可运行。

在 cloud.anythingmcp.com 开始免费试用,一键添加 WhatsApp Business Cloud API,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。

开始免费试用

摘要

使用 AnythingMCP 将 Meta 的 WhatsApp Business Cloud API 连接到 Copilot。从 Microsoft Copilot 以自然语言发送文本、模板、媒体、语音消息和交互按钮。

试试这样问

WhatsApp Business Cloud API 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

WhatsApp Business Cloud API · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

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

将 WhatsApp Business 连接到 Copilot

WhatsApp Business Cloud API 是 Meta 托管的网关,用于通过程序发送 WhatsApp 消息——文本、模板、媒体、语音消息、交互按钮、位置。使用 AnythingMCP,你可以从 Microsoft Copilot 以自然语言驱动一切。无 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 分钟设置)。
  • 可以使用 Copilot Studio 的工作账户(用于把连接器添加到 Microsoft Copilot)。

步骤 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 并填入:

字段值
WHATSAPP_ACCESS_TOKEN永久 System User 令牌
WHATSAPP_BUSINESS_ACCOUNT_ID你的 WABA ID(例如 123456789012345)

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

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

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

步骤 4 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 WhatsApp Business 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具(共 14 个)

组工具
发现whatsapp_list_phone_numbers, whatsapp_list_message_templates, whatsapp_get_message_template
文本与模板whatsapp_send_text_message, whatsapp_send_template_message
媒体(URL 或 media ID)whatsapp_send_image, whatsapp_send_audio, whatsapp_send_video, whatsapp_send_document
交互式与位置whatsapp_send_location, whatsapp_send_interactive_buttons
已读确认与资料whatsapp_mark_message_as_read, whatsapp_get_business_profile, whatsapp_update_business_profile

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

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

adapter 的 instructions 字段将这条规则告诉 Copilot,因此当你在用户最后回复几天后请求"给那位客户发个跟进"时,Copilot 会使用 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 用于确认。

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

你的 WhatsApp Business Cloud API 智能体只差一次点击。

安装连接器,粘贴密钥,向 Microsoft Copilot 提问。免费试用 7 天,无需信用卡。

相关指南