> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# WhatsApp 工具

## 概述

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

WhatsApp 集成提供 3 种工具：

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

## 设置

#### 导入账户

按照[此处](/docs/zh/eleven-agents/whatsapp)的说明导入 WhatsApp Business
账户。

#### 添加集成

前往[集成页面](https://elevenlabs.io/app/agents/integrations)，点击 **\_添加
集成 \_** 按钮，选择 WhatsApp 并连接账户：

![WhatsApp 集成](/docs/_fern-img/e560b1b2a4345bd2fbe9519f7146b87d195268955d2b2aa2c6221629d97e4384.webp)

#### 添加工具

前往[工具页面](https://elevenlabs.io/app/agents/tools)，点击 **\_添加集成
工具 \_** 按钮，选择 WhatsApp 集成和 **\_ 发送消息 \_** 工具：

![WhatsApp 工具](/docs/_fern-img/e85dcc3a3e3581250604311c516e080fb7f61f100b98b4b55be5f6071866e888.webp)

## 使用工具

#### 创建消息模板

前往 [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/)，打开
***管理模板*** 页面并创建消息模板：

![WhatsApp 消息模板](/docs/_fern-img/e2d2c8bcab0b4c664261a57658627fd4368fc00e4768e4bd4c16264c59d07e16.webp)

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

#### 配置智能体

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

![智能体配置：工具](/docs/_fern-img/0e078a4206030111493387ec6c9bc2235106ac3cb763d4555dd1ae7307c6d46a.webp)

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

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

![智能体配置：提示词](/docs/_fern-img/893aa34f7bd3e01a0cbb919f08f801398de318d46e1d8d1a6c72a945193f7de9.webp)

#### 测试

测试工具配置：

![测试对话](/docs/_fern-img/47d48232a04cd47112d5637288c6225761f7f66f3016f5fc7d9cf38a34b3782d.webp)![收到的测试消息](/docs/_fern-img/6b3809101caa5d38cf7ea761feb38f4ee316bfde4bef20e2e22eca6b14d0262f.webp)

## 参数和语言代码

该工具仅填充模板的 **正文** 参数——不支持含参数化页眉或按钮的模板。收件人是 WhatsApp 用户 ID：仅包含数字、含国家/地区代码且不含 `+`（例如 `14155552671`）——有关各国家/地区的注意事项，请参阅[收件人号码格式规则](/docs/zh/eleven-agents/whatsapp/outbound#recipient-number-format)。

模板语言代码必须与 WhatsApp Manager 中创建模板时使用的语言一致——请参阅[支持的语言代码](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages/)。常见错误是为使用 `en_US` 创建的模板传入 `en`（或反过来）；Meta 会将其视为不同模板。

## 故障排除

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