登录开始免费试用
Meta Tech Provider

MCP 工具参考

该连接器覆盖账户中的每个连接,共提供 30 多个工具。WhatsApp 先用 list_numbers,其工具使用它返回的 connection_id;其他渠道先用 list_social_accounts,其工具使用 account_id。付款逾期时有 6 个工具会受限:4 个会影响外部系统的 WhatsApp 工具、返回访问令牌的 get_api_credentials,以及 create_connect_link。其余工具仍可使用。

30+

连接器提供的工具。

6

付款逾期时受限的工具,包括返回访问令牌的 get_api_credentials。

1

通过 OAuth 登录,涵盖账户中的每个号码。

每个工具有什么作用?

读取:list_numbers 返回已连接号码、状态、质量评级和消息层级,也是所有其他调用的起点。get_number_health 会同时返回实时 Meta 快照、近期监控时间线、Webhook 事件和轮询检查结果。get_api_credentials 返回 Graph API 基础 URL、WABA id、phone number id,以及账户自己的访问令牌(如有)。

发送:send_message 会在 24 小时窗口内发送自由文本,窗口内回复免费。send_template 会发送已批准的模板,用于向尚未发来消息的人开启对话。list_templates、create_template 和 get_template_status 覆盖消息模板的完整生命周期。

连接:set_webhook_destination 会将收到的消息和应用回显路由到您的系统,传入 null 即可重置。get_connect_link 返回连接新号码所需的控制台链接和步骤。get_docs 以 markdown 格式返回产品文档。

Partner API 面向让自己的客户连接号码的软件或代理商:get_partner_setup 显示付款状态、API 密钥、事件 URL 和下一步。create_api_key 生成 Partner API 密钥并只显示一次,未经明确确认不会替换现有密钥。revoke_api_key 撤销该密钥,同样需要确认。set_partner_events_url 设置状态事件的发送地址,并只返回一次签名密钥。create_connect_link 为一位客户创建托管连接链接,有效期 1 小时,与 POST /api/v1/connect-sessions 相同。

为什么 connection_id 很重要?

因为它把一条指令关联到特定号码,而助手无法自行猜出这个值。

所有针对号码执行操作的工具都需要 connection_id,而它只能来自 list_numbers。实际使用时,助手收到发送消息的请求,会先调用 list_numbers,所以一个会话中的首次请求通常比后续请求慢。

这也让拥有多个号码的账户从设计上保持明确。系统没有默认号码,也不会隐式选择号码,因此没有说明目标号码的指令会被询问,而不会被猜测。

付款逾期时会发生什么?

有 6 个工具会受限:会影响外部系统的 send_message、send_template、create_template 和 set_webhook_destination;get_api_credentials,因为它返回账户的访问令牌,受限账户可借此直接通过 Graph API 发送;以及用于连接新号码的 create_connect_link。其他读取功能仍可用,Partner API 设置工具也一样:get_partner_setup、create_api_key、revoke_api_key 和 set_partner_events_url。

这是有意的设计,并非遗漏。如果账户无法查看受限原因,也无法检查号码是否正常,就只能提交支持请求。这些读取功能也是连接状态监控的基础,因此在最需要监控时关闭它们,反而会让监控停止。

实际结果是,付款逾期的账户仍能回答有关自身状态的问题,也仍会受到监控。停止的是所有触达客户的操作。

常见错误

  • 以为连接器会接收消息。MCP 使用请求和响应;收到的消息需要通过 Webhook 传入。
  • 将 connection_id 写死。它来自 list_numbers,不应手动记录。
  • 以为付款逾期的账户会完全离线。读取功能和监控会按设计继续运行,但凭据除外,因为其中包含用于发送的访问令牌。
使用 EasyCoexistence 完成这些操作

一个连接器覆盖账户中的所有号码,通过 OAuth 授权,无需粘贴密钥。每个号码每月 US$ 9 起,随号码增加降至 US$ 0.75,前 3 天免费。

常见问题

我需要选择要调用的工具吗?

不需要。您用自然语言提出请求,助手会自行选择工具,这正是工具说明的用途。

它能读取我的对话吗?

不能。收到的消息会路由到您指定的 Webhook 目标。连接器读取的是账户和号码状态。

get_docs 有用吗?

比听起来更有用。它会把我们的文档以 markdown 格式交给助手,因此关于 Coexistence 规则的答案来自我们的文档,而不是助手凭记忆回答。

一个连接器可以覆盖多个客户吗?

可以。一个账户可以存放您需要的任意数量的号码,list_numbers 会返回全部号码。

继续阅读

准备开始了吗?

几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。

开始免费试用

验证时间