WhatsApp 工具

概述

可以为智能体添加工具，让它在 WhatsApp 上发送消息，即使当前对话在其他渠道中进行（例如电话）。

WhatsApp 集成提供 3 种工具：

• 发送消息——向任意 WhatsApp 用户发送模板消息。适用于任何渠道，例如电话智能体可以向来电者的 WhatsApp 发送确认消息。本页介绍此工具。
• 发送交互式按钮 和 发送交互式列表——为正在进行 WhatsApp 对话的用户提供可点击的选项。这些工具仅适用于 WhatsApp 消息对话——请参阅交互式消息。

设置

1

导入账户

按照此处的说明导入 WhatsApp Business 账户。

2

添加集成

前往集成页面，点击 _添加 集成 _ 按钮，选择 WhatsApp 并连接账户：

3

添加工具

前往工具页面，点击 _添加集成 工具 _ 按钮，选择 WhatsApp 集成和 _ 发送消息 _ 工具：

使用工具

1

创建消息模板

前往 WhatsApp Manager，打开 管理模板 页面并创建消息模板：

该工具目前仅支持消息正文中的参数。

2

配置智能体

前往智能体配置并添加该工具：

在系统提示词中告知智能体：

• 何时使用该工具
• 使用哪个模板名称和语言代码
• 传入哪些参数

3

测试

测试工具配置：

参数和语言代码

该工具仅填充模板的 正文 参数——不支持含参数化页眉或按钮的模板。收件人是 WhatsApp 用户 ID：仅包含数字、含国家/地区代码且不含 +（例如 14155552671）——有关各国家/地区的注意事项，请参阅收件人号码格式规则。

模板语言代码必须与 WhatsApp Manager 中创建模板时使用的语言一致——请参阅支持的语言代码。常见错误是为使用 en_US 创建的模板传入 en（或反过来）；Meta 会将其视为不同模板。

故障排除

• 未找到模板：模板名称或语言代码与 WhatsApp Manager 中的不完全一致，或者模板属于与已连接账户不同的 WhatsApp Business 账户。
• 消息已接受但未投递：模板未获批准、缺少正文参数，或账户存在付款问题——请参阅故障排除与常见问题。
• 智能体传入了错误参数：在系统提示词中明确模板的准确参数名称和预期值，并提供一个调用示例。