manuallatest产品手册 / WhatsApp 渠道使用手册
WhatsApp 渠道使用手册
本文面向 Agentic Engine 平台管理员和普通用户，说明如何在平台中开通 WhatsApp 渠道、绑定个人账号，并在 WhatsApp 私聊或群聊中使用 Agent 与 Team。如果页面入口或渠道状态异常，请联系系统管理员。
警告
合规提醒：Baileys 属于非 WhatsApp 官方支持的 Web 自动化方案，可能存在账号限流、限制或封禁风险。生产使用前请完成合规评估，优先使用专用测试账号，不要关联个人主账号。
一、开始前准备
- 平台管理员：拥有「管理后台 → 渠道管理」权限，并准备一个专门作为公司共享机器人的 WhatsApp 账号。
- 普通用户：拥有可正常登录的 Agentic Engine 账号，并能使用自己的 WhatsApp 私聊共享机器人。
- 群聊使用：共享机器人需要先加入目标 WhatsApp 群聊，群成员需要完成个人账号绑定。
提示
两个身份不要混淆：管理员扫描二维码，是为了把公司的共享机器人接入平台；普通用户不需要扫码，只需在工作台生成一次性绑定码，再用自己的 WhatsApp 私聊机器人完成绑定。
二、管理员添加 WhatsApp 渠道
拥有渠道管理权限的管理员登录 Agentic Engine，进入「管理后台 → 渠道管理」。
- 点击「新建渠道」，渠道类型选择 WhatsApp。
- 填写渠道名称；按需选择默认模型、填写系统提示词，然后保存。
- 打开渠道的「启用」开关。首次启用但尚未扫码时显示「离线」，属于正常状态。
- 返回渠道列表，点击「扫码关联」。
- 在共享机器人手机的 WhatsApp 中进入「设置/菜单 → 已关联设备 → 关联设备」，扫描页面二维码。
- 二维码约 2 分钟过期；过期后在页面点击「重新生成二维码」。
- 扫码成功后刷新渠道列表，确认状态变为「在线」。
| 配置项 | 是否必填 | 操作说明 |
|---|---|---|
| 渠道名称 | 必填 | 用于在渠道列表和用户绑定页面中识别，例如「WhatsApp 机器人」。 |
| 渠道类型 | 必填 | 选择 WhatsApp。 |
| 默认模型 | 可选 | 未选择时使用平台的全局默认模型。 |
| 系统提示词 | 可选 | 仅影响通过该 WhatsApp 渠道发起的 Agent 会话。 |
提示
渠道显示「在线」后，用户才会在工作台看到该 WhatsApp 渠道的绑定入口。
三、用户绑定与解绑
绑定 WhatsApp 账号
- 登录 Agentic Engine，在工作台侧边栏打开「渠道绑定」。
- 选择要使用的 WhatsApp 渠道，点击「绑定」。
- 复制弹窗中的完整绑定命令。绑定码有效期为 10 分钟，并且只能使用一次。
- 使用自己的 WhatsApp 账号私聊共享机器人，发送完整命令，例如
+bind ABC234。 - 看到“WhatsApp 账号绑定成功”后，返回工作台确认状态已刷新为「已绑定」。
警告
绑定命令只能在私聊中发送，群聊发送会被拒绝。同一个 WhatsApp 身份不能同时绑定多个 Agentic Engine 用户。
解绑或更换平台账号
- 在工作台侧边栏打开「渠道绑定」。
- 找到对应 WhatsApp 渠道，点击「解绑」并确认。
- 如需绑定其他 Agentic Engine 账号，请登录新账号并重新生成绑定码。
四、在 WhatsApp 中使用 Agent
私聊使用
- 完成绑定后，直接私聊共享机器人发送问题，回复会返回当前私聊。
- 机器人要求补充信息或确认继续执行时，按照文字提示直接回复即可。
- WhatsApp 不支持会话 thread，所有回复都会留在原私聊中。
| 操作 | 写法 | 说明 |
|---|---|---|
| 直接提问 | 帮我分析本周数据 | 使用渠道默认 Agent。 |
| 开启新会话 | +new | 仅私聊支持。 |
| 指定 Agent | +agent Agent名称 问题 | 例如 +agent rhea 帮我分析数据。 |
| 取消当前任务 | +cancel | 必须整条消息精确发送。 |
群聊使用
- 先确认共享机器人已加入目标群聊，且发消息的成员已经完成个人账号绑定。
- 发送消息时必须使用 WhatsApp 原生 @ 功能选择共享机器人；仅手工输入相似名称不会触发。
- 未 @ 机器人的普通群消息会被忽略，不会进入 Agent 会话。
- 群聊不支持
+new；取消任务时发送@机器人 +cancel。
管理员配置群聊分发
- 进入「管理后台 → 渠道管理」，打开对应 WhatsApp 渠道的「消息分发」。
- 选择默认 Agent 或 Team；启用群聊分发前必须配置默认项。
- 按需添加调用指令和关键词规则，然后保存。
- 在测试群中发送
@机器人 +help，确认当前用户可用的 Agent/Team。
| 用途 | 示例 | 说明 |
|---|---|---|
| 查看可用能力 | @机器人 +help | 展示当前用户可使用的 Agent/Team。 |
| 指定能力 | @机器人 +analysis 分析本周数据 | 按管理员配置的调用指令分发。 |
| 按关键词分发 | @机器人 帮我检查埋点方案 | 命中规则时使用对应能力，未命中时使用默认项。 |
群聊上下文：系统只参考近期明确 @ 机器人并实际进入处理的公开群聊轮次；未 @ 的普通群消息、其他群聊和个人私聊不会混入。
五、附件与任务通知
发送和接收附件
- 可以向机器人发送 JPEG/PNG 图片，以及 TXT、Markdown、CSV、JSON、PDF、Word、Excel、PowerPoint 文档。
- 音频、视频和贴纸当前不会交给 Agent，机器人会提示无法处理的原因。
- 默认单个文件不超过 2 MiB、每条消息最多处理 5 个附件；超出时请压缩文件或分开发送。
- Agent 生成的图片或受支持文档会直接发送回原私聊或原群聊。
Agent Team 任务通知
- 创建 Agent Team 即时任务或定时任务时，选择 WhatsApp 作为通知渠道。
- 任务结束后，共享机器人会私聊任务创建者已绑定的 WhatsApp 账号。
- 长结果会自动拆分为多条消息发送。
如果没有收到通知，请检查个人账号是否仍为「已绑定」、WhatsApp 渠道是否在线，以及任务是否选择了 WhatsApp 通知。通知投递失败不会改变任务本身的最终状态。
六、连接管理与常见问题
管理员管理连接
- 渠道关联成功后，渠道列表中的「扫码关联」会变为「管理连接」。
- 渠道显示「需重新关联」或「WhatsApp 已失联」时，在「管理连接」中按提示重新扫码。
- 更换共享机器人账号前，先停用渠道，再执行「重置关联」并扫描新账号。
- 重置关联会解除现有用户绑定并使未使用的绑定码失效。执行前请通知用户，完成后由用户重新绑定。
- 删除渠道会停止该渠道的消息收发；确认不再使用后再删除。
常见问题
| 现象 | 处理方法 |
|---|---|
| 工作台没有 WhatsApp 绑定入口 | 请管理员确认渠道已经启用、扫码成功并显示「在线」。 |
| 绑定码无效或已过期 | 返回工作台重新生成，并在 10 分钟内私聊正确的共享机器人发送完整命令。 |
| 私聊正常，群聊没有响应 | 确认机器人已加入群聊、发送者已绑定，并使用 WhatsApp 原生 @ 选择机器人；如启用了群聊分发，还需配置默认 Agent/Team。 |
| 二维码过期或加载失败 | 点击「重新生成二维码」；仍无法生成时请联系系统管理员。 |
| 扫码后仍显示离线 | 等待片刻并刷新渠道列表；仍未上线时进入「管理连接」重新关联，或联系系统管理员。 |
| 文本正常，附件无法处理 | 检查文件类型、大小和数量；尝试压缩文件或分开发送。 |
| 没有收到 Team 任务通知 | 检查账号绑定状态、渠道在线状态，以及任务是否选择 WhatsApp 通知。 |
| 需要更换绑定的平台账号 | 先在原 Agentic Engine 账号的「渠道绑定」中解绑，再登录新账号重新生成绑定码。 |
警告
如果手机端移除了该共享机器人对应的「已关联设备」，渠道会断开连接，需要管理员在平台中重新扫码关联。
相关页面与下一步
这篇文档对你有帮助吗？