摘要
想要在 Wati 上部署您自己的自定义 AI 代理吗？通过 自带 AI（BYOA） 功能，您可以直接将您的 AI 代理集成到 Wati 中，作为 AI 操作员。这使得您的代理能够与您的人类操作员一起工作——接收、回应和管理客户对话，就像团队的一员一样。
注意:
BYOA 功能为 Wati 用户提供付费附加组件（100 USD/月）。
如果您已经在使用 Astra 并希望通过 BYOA 连接至 Wati，则无需此附加组件。您只需在 Wati 的 Pro 或 Business 计划中即可启用此集成。
您可以在 Wati 的 用户管理 页面中找到它！
操作指南
请遵循本指南，了解如何使您的 AI 代理发送和接收消息、管理聊天上下文以及通过 API 与 Wati 互动。
将您的自定义 AI 代理添加到 Wati
您可以在 Wati 中将您的 AI 代理注册为 AI 操作员。添加后，您的代理将获得一个专门的 访问令牌，允许其与 Wati 的公共 API 进行互动，例如发送消息、更新联系人信息或结束聊天。
您的 AI 操作员将出现在 团队收件箱操作员列表 中，您可以手动或通过 Wati 自动化 将对话分配给它。
例如，您可以创建一个自动化规则，自动将所有新聊天分配给您的 AI 操作员。
您的 AI 代理如何接收客户消息
要接收消息，请向 Wati 提供一个 Webhook URL。Wati 将通过此 Webhook 将相关的消息事件推送到您的 AI 代理。
您的 AI 代理不会收到不必要的数据——Wati 仅发送特定分配给您的 AI 代理的对话事件。由人类操作员处理的对话不会触发您的代理的 Webhook 事件。
支持的 Webhook 事件
目前，您的 AI 代理可以接收 2 种 Webhook 事件：
聊天已分配 – 当聊天分配给您的 AI 代理时触发。
分配的对话收到消息 - 当分配给您的 AI 代理的对话中有新消息时触发。
您的 AI 代理如何回应客户
注册后，将生成一个专门的访问令牌。您可以使用此 专门的访问令牌 与 Wati 的公共 API 互动，发送消息、更新联系人信息或管理聊天状态。
您可以在 Wati API 文档 中找到完整的 API 列表。
以下是开始时最常用的几个端点：
/sendSessionMessage向客户发送消息响应。
/getContacts在对话分配给您的 AI 代理时，检索联系人详细信息（如电话号码和自定义属性）。
/updateContactAttributes将对话中收集的新信息存储为 Wati 中的联系人属性。
/updateChatStatus在您的 AI 代理解决对话后更新聊天状态。
/assignOperator如果您的 AI 代理无法处理对话，可以重新分配给人类操作员。
访问对话历史
当您的 AI 代理被分配到聊天时，可以使用 /getMessages API 端点检索 历史上下文。这有助于您的 AI 根据过去和最近的消息生成更准确和上下文相关的响应。
处理媒体消息
如果客户发送了图片、文档或语音笔记，Wati 将在 Webhook 事件中包含一个 文件名。您的 AI 代理可以使用 /getMedia API 下载文件并相应地处理。
在哪里找到您的 AI 操作员
设置后，您的 AI 操作员将出现在 团队收件箱操作员列表 中，可以像任何其他团队成员一样分配聊天。
您也可以使用 Wati 自动化 将消息自动路由到您的 AI 操作员。
常见问题解答 (FAQs)
概述
1. Wati 中的自带 AI（BYOA）功能是什么？
自带 AI（BYOA）功能允许您将自定义 AI 代理集成到 Wati 中，作为 AI 操作员，接收、回应和管理客户对话，与人类操作员一起工作。
2. BYOA 功能是否免费使用？
BYOA 功能作为付费附加组件提供，价格为 100 USD/月。
3. 使用 BYOA 与 Astra 集成有哪些计划要求？
要通过 BYOA 连接 Astra 与 Wati，您必须在 Wati 的 Pro 或 Business 计划中。
4. 在 Wati 中在哪里可以找到 BYOA 功能？
BYOA 功能在 Wati 的用户管理页面中可用。
设置和分配
5. 如何在 Wati 中添加和使用自定义 AI 代理？
您可以在 Wati 中将自定义 AI 代理注册为 AI 操作员。注册后，代理将获得一个专门的访问令牌，用于与 Wati API 互动，并出现在团队收件箱中，可以通过手动或自动化规则分配对话。
6. 聊天可以自动分配给 AI 代理吗？
是的，您可以在 Wati 中创建自动化规则，自动将新聊天分配给 AI 操作员。
消息处理和 Webhooks
7. AI 代理如何接收客户消息？
AI 代理通过提供给 Wati 的 Webhook URL 接收消息，Wati 将发送与分配给 AI 代理的对话相关的消息事件。
8. AI 代理支持哪些 Webhook 事件？
AI 代理支持两种 Webhook 事件：“聊天已分配”，当聊天分配给代理时触发；“分配的对话收到消息”，当分配给代理的对话中有新消息时触发。
9. AI 代理是否接收所有对话的事件？
不，AI 代理仅接收分配给它的对话的 Webhook 事件。
API 和功能
10. AI 代理如何与客户互动并管理聊天？
AI 代理使用其专门的访问令牌与 Wati 的公共 API 互动，发送消息、检索联系人详细信息、更新联系人属性、管理聊天状态、将聊天重新分配给人类操作员、使用 /getMessages 端点访问对话历史以及使用 /getMedia 端点下载媒体文件。