Zalo — 使用技巧
在 Zalo 上使用 OpenMax 员工。Zalo 是越南最受欢迎的即时通讯平台，拥有超过 7500 万用户。
两种接入方式
OpenMax 支持两种方式接入 Zalo。默认推荐 Zalo（官方）：走官方 API，账号不会有风险。Zalo 个人版（非官方）是进阶选项，只有在你确实需要用一个真实 Zalo 账号对话时才考虑。
| Zalo（官方） | Zalo 个人版（非官方） | |
|---|---|---|
| 是什么 | 在手机 Zalo 的 Zalo Bot Creator 小程序里创建一个机器人，走官方 Zalo Bot Platform API | 使用真实 Zalo 账号通过扫码登录（类似 WhatsApp Web） |
| 协议 | 官方 API — 由 Zalo/VNG 官方支持 | 逆向工程协议（zca-js）— 未经 Zalo/VNG 官方认可 |
| 所需账号 | 一个 Zalo 账号用于在 Bot Platform 上注册机器人 | 一个专用 Zalo 账号（必须与对话用户的账号不同） |
| 设置方式 | 创建机器人 → 在 Workspace 粘贴 Bot Token | 扫描二维码 — 无需 Token 或开发者设置 |
| 账号风险 | 无 — 使用官方 API | 可能被限制或封号 |
| 部署时间 | 私聊约 5 分钟，进群再加约 3 分钟 | 约 2 分钟 |
| 部署指南 | Zalo（官方）部署指南 → | Zalo 个人版（非官方）部署指南 → |
该选哪个？
默认选 Zalo（官方）。 它由 Zalo/VNG 官方 API 支持，账号不会被限制或封禁，设置一次即可长期使用。
只有在你必须用一个真实 Zalo 账号（而不是机器人）来对话时，才考虑 Zalo 个人版（非官方）。它使用逆向工程协议，未经 Zalo/VNG 认可，可能导致账号被限制或封禁。
Zalo（官方）— 使用方法
私信
直接向你的 Zalo 机器人发送消息，无需特殊命令，机器人会立即回复。
开始使用
在 Zalo 中搜索你的机器人名称
开始对话 — 机器人自动回复
第一个发送私信的用户将成为管理员（Owner）
群聊
不能在群里用「添加成员」搜索机器人把它加进来——Zalo 不支持这种方式。必须由群主在手机 Zalo 上分享机器人链接到群里、再点链接确认。完整步骤见 Zalo（官方）部署指南 — 第4步 →
权限管理
默认情况下，只有管理员可以与机器人对话。如需允许其他人使用：
白名单模式 — 仅指定用户可以对话：
发送给机器人：
开启白名单模式，添加手机号 +84 xxx
开放模式 — 所有人均可对话：
发送给机器人：
开启开放模式，所有人都可以跟你聊天
Zalo 个人版（非官方）— 使用方法
私信
任何向你的专用机器人 Zalo 账号发送消息的人都会收到 AI 回复。
开始使用
设置时 AI 员工会发送一个二维码给你
使用专用机器人 Zalo 账号扫描
连接建立 — 开始对话
权限管理
与 Zalo（官方）相同：默认仅管理员可用，支持白名单和开放模式。
连接稳定性
Zalo 个人版使用非官方协议，连接可能偶尔断开。如果发生这种情况，让你的 AI 员工重新连接：
"重新连接 Zalo 个人版"
进阶技巧
语音消息：发送语音消息——机器人会转录并回复。
图片：发送照片，机器人可以分析图片内容。
文件与文档（仅 Zalo 个人版）：发送文档，机器人可以分析其内容。Zalo（官方）不支持收发文件。
多语言：机器人会根据你使用的语言回复——支持越南语、英语、中文等。
多渠道：你可以在同一个 AI 员工上同时连接 Zalo（官方）和 Zalo 个人版（非官方），以及 Telegram、WhatsApp 等其他渠道。
故障排除
| 问题 | 解决方案 |
|---|---|
| 机器人无响应（官方） | 确认 Bot Token 是否正确，在 OpenMax Workspace 检查连接状态 |
| 机器人无响应（个人版） | 让你的 AI 员工重新连接——会话可能已过期 |
| 其他人无法与机器人对话 | 默认仅管理员可用，开启白名单或开放模式即可 |
| 账号被警告（仅个人版） | 停止使用非官方集成，切换到 Zalo（官方） |
| 想要断开连接 | 在 Agent 详情页【对话入口】点击对应 Zalo 卡片的断开连接按钮，或告诉你的 AI 员工 |