MCP 工具参考
该连接器可处理账户中的每个号码,共提供 11 个工具。list_numbers 排在首位,因为其他工具都需要使用它返回的 connection_id。其中 4 个工具会影响外部系统,付款逾期时会受限;另外 7 个只读取信息,仍可使用。
每个工具有什么作用?
读取: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 格式返回产品文档。
为什么 connection_id 很重要?
因为它把一条指令关联到特定号码,而助手无法自行猜出这个值。
所有针对号码执行操作的工具都需要 connection_id,而它只能来自 list_numbers。实际使用时,助手收到发送消息的请求,会先调用 list_numbers,所以一个会话中的首次请求通常比后续请求慢。
这也让拥有多个号码的账户从设计上保持明确。系统没有默认号码,也不会隐式选择号码,因此没有说明目标号码的指令会被询问,而不会被猜测。
付款逾期时会发生什么?
会影响外部系统的 4 个工具会受限:send_message、send_template、create_template 和 set_webhook_destination。所有读取功能仍可用。
这是有意的设计,并非遗漏。如果账户无法查看受限原因,也无法检查号码是否正常,就只能提交支持请求。这些读取功能也是连接状态监控的基础,因此在最需要监控时关闭它们,反而会让监控停止。
实际结果是,付款逾期的账户仍能回答有关自身状态的问题,也仍会受到监控。停止的是所有触达客户的操作。
常见错误
- 以为连接器会接收消息。MCP 使用请求和响应;收到的消息需要通过 Webhook 传入。
- 将 connection_id 写死。它来自 list_numbers,不应手动记录。
- 以为付款逾期的账户会完全离线。读取功能和监控会按设计继续运行。
一个连接器覆盖账户中的所有号码,通过 OAuth 授权,无需粘贴密钥。每个号码每月 US$ 9 起,量大时降至 US$ 2,前 7 天免费。
常见问题
我需要选择要调用的工具吗?
不需要。您用自然语言提出请求,助手会自行选择工具,这正是工具说明的用途。
它能读取我的对话吗?
不能。收到的消息会路由到您指定的 Webhook 目标。连接器读取的是账户和号码状态。
get_docs 有用吗?
比听起来更有用。它会把我们的文档以 markdown 格式交给助手,因此关于 Coexistence 规则的答案来自我们的文档,而不是助手凭记忆回答。
一个连接器可以覆盖多个客户吗?
可以。一个账户可以存放您需要的任意数量的号码,list_numbers 会返回全部号码。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间