# Viber 连接您自己的 **Viber 机器人**，让您的 Viber 对话流入本应用，并由 AI 智能体进行回复。您只需粘贴一个值（机器人的身份验证令牌），我们即可为您处理其余的设置工作。 --- ## 什么是 Viber 集成？ Viber 集成使用 Viber 官方的 Bot API 将您拥有的 **Viber 机器人**连接到本平台。这是 Viber 用于自动发送和接收消息的系统，无需您手动输入。您的机器人与关注者之间的对话将在本应用内显示，AI 智能体和共享收件箱将在此基础上协同工作。 这是一个**官方**集成，因此它非常稳定且符合 Viber 的规则。 > **可用性。** Viber 在菲律宾、越南及东南亚其他地区、东欧和希腊最为常用。 --- ## 开始之前 **您需要拥有自己的 Viber 机器人，且 Viber 仅在付费商业计划中提供机器人服务。** 自 2024 年 2 月起，Viber 不再创建免费机器人。您需要直接在 Viber 设置账户，该账户及其费用由您与 Viber 直接结算。我们不转售、不加价、不抽成，也无法代您创建机器人。 在撰写本文时，Viber 对每个机器人收取月费，并对机器人主动发起的每条消息收取费用（请参阅下方的 [费用](#cost)）。请在注册时查看 Viber 的最新条款，因为其定价可能会随时更改。 没有自助注册表单。Viber 会人工审核每一份聊天机器人申请，您可以通过以下两种方式之一进行申请： - **通过 Viber 认证合作伙伴**，这是 Viber 推荐的途径，通常也是最快的方式。 - **直接联系 Viber**，发送电子邮件至 `partners@viber.com`。如果您已经与 Viber 有合作，您的商务客户经理也可以代为发起申请。 申请获批后，您需要签署 Viber 的协议并接受其商业条款，随后您的机器人就会被创建。 之后，您可以在 Viber 应用的 **更多 → 设置 → 机器人 → 编辑信息 → 您的应用密钥** 下找到其令牌。Viber 将其称为您的*应用密钥*；他们的 API 文档将相同的值称为*身份验证令牌*，机器人管理员也可以在 Viber 自己的管理面板中看到它。无论它如何标记，它都是此应用所要求的唯一值。 该令牌是您从 Viber 获取的唯一所需信息。在此处的设置大约需要一分钟。 --- ## 设置 Viber ### 第 1 步：复制机器人的身份验证令牌 找到它的最快方法是在手机上的 Viber 应用中。 1. 在拥有该机器人账户的手机上打开 Viber。 2. 前往 **更多 → 设置 → 机器人**。 3. 选择您的机器人并点击 **编辑信息**。 4. 复制 **您的应用密钥** 下方显示的数值。这就是令牌。 > 请妥善保管此令牌。任何拥有它的人都可以以您的机器人身份发送消息。 ### 第 2 步：在本应用中连接 Viber 1. 在左侧边栏中，点击底部的 **Settings**（设置）。 2. 在“设置”左侧导航栏的 **Channels**（渠道）下，点击 **Channels**（渠道）。 3. 找到 **Viber** 卡片并点击 **Connect**（连接）。 4. 粘贴您的 **auth token**（身份验证令牌）。 5. 点击 **Connect**（连接）。 6. 应用程序会向 Viber 验证该令牌，并显示 **"Connected to: <您的机器人名称>"**（已连接至：<您的机器人名称>）。 **无需设置 Webhook。** 与大多数其他渠道不同，我们在连接过程中会为您在 Viber 完成所有注册工作，因此无需将任何内容复制到其他控制台。连接屏幕显示的地址是您的消息到达的地址，仅供您在需要时提供给支持团队查看。 ### 第 3 步：测试机器人 1. 使用另一部手机打开 Viber 并 **关注您的机器人**（搜索它或使用其链接）。 2. **向它发送一条消息。** 3. 打开应用程序并进入 **Chats**（聊天）。收到的消息会出现在对话列表中。 4. 如果有 AI 智能体正在处理此渠道，您会看到它 **自动回复**。 连接成功后，您的 Viber 机器人会在“渠道”页面显示为 **Connected**（已连接），且 AI 会响应收到的消息。 --- ## 您的机器人可以向谁发送消息 这是关于 Viber 最重要的一点，它与其他所有渠道都不同： **您的机器人只能向关注它的人发送消息。** 用户必须先找到并关注您的机器人，您才能向他们发送任何内容。无法向尚未关注您机器人的 Viber 用户发送消息。 如果有人取消关注或屏蔽了您的机器人，在他们重新关注并向您发送消息之前，您无法再次向他们发送消息。当这种情况发生时，应用程序会标记该对话以停止尝试，您发送的任何回复都会显示为失败并附带说明，而不是悄无声息地消失。 因此，Viber 非常适合作为 **支持和回复渠道**（用户向您发送消息，AI 进行回答），而不适合作为冷启动外呼渠道。 --- ## 费用 Viber 是应用程序中的一个 **免费** 渠道：没有按消息收费，我们也不收取月度连接费。 您的费用来自 **Viber**，由您自己的账户承担： - **每个机器人的月费**（撰写本文时约为 100 欧元）。 - **在用户发起的对话中进行回复是免费且无限制的。** 这涵盖了 AI 智能体执行的几乎所有操作。 - **由您的机器人主动发起的、在用户发起对话之外的消息**，将按消息收费，费率取决于接收者所在的国家/地区。 实际结论：除了月费外，回复用户不会产生额外费用。广播和主动跟进才会增加成本。 --- ## 媒体消息 系统可以识别传入的照片、视频、文件、贴纸、位置和共享联系人，以便 AI 知道已发送了媒体（对话中会添加简短说明）。在此版本中，AI 的外发回复支持 **文本和图像**。长回复会自动截断至 Viber 的 7,000 字符限制。 --- ## 会话管理 ### 检查连接状态 您的 Viber 连接状态显示在“渠道”页面的 **Viber** 卡片上： | 状态 | 含义 | |---|---| | **已连接** | 一个 Viber 机器人已关联到此账户 | | **已连接，需要操作** | 其他工具已接管您的机器人；消息无法送达我们 | | **未连接** | 未设置连接 | 每次您打开“渠道”页面时，卡片都会重新检查您的机器人。**一个 Viber 机器人一次只能向一个地方发送消息**，因此如果您将同一个机器人连接到另一个工具，该工具就会接管它，您的消息将停止发送到此处，且 Viber 不会发出任何警告。这就是 **“已连接，需要操作”** 的含义。打开卡片并重新连接以将其取回。 ### 断开连接 打开 **Viber** 卡片并点击 **管理**，然后点击 **断开连接** 并确认 **移除 Viber？**。这将停止我们接收该机器人的消息，并将其从您的账户中移除。您的机器人本身仍归您所有。您的 Viber 账户不会有任何变化。 --- ## 限制 - **仅限关注者。** 您的机器人只能向关注它的人发送消息。请参阅 [您的机器人可以向谁发送消息](#who-your-bot-can-message)。 - **您需要拥有自己的付费 Viber 机器人。** 我们无法提供。 - **每个连接对应一个机器人。** 请分别连接每个机器人；一个机器人只能关联到一个账户。 - **支持发送文本 + 图片。** AI 回复包含文本和图片；此版本不支持发送轮播图和富媒体卡片。 - **无欢迎消息。** 当某人第一次打开您的机器人但尚未关注时，Viber 允许发送一条即时问候语。此版本不会发送问候语。对话从他们发送第一条消息时开始。 --- ## 故障排除 ### 连接时令牌被拒绝 - 请确保您复制的是 Viber 应用中 **编辑信息 → 您的应用密钥 (Edit Info → Your app key)** 的值，而不是其他 ID。 - 检查您的机器人在您的 Viber 账户中是否仍处于活动状态。 - 连接过程还会检查 Viber 是否能访问我们。如果您的令牌确实正确但仍然失败，请稍等片刻再试，如果仍有问题，请联系支持团队。 ### “此 Viber 机器人已连接到另一个账户” 同一个机器人已在应用中关联到了另一个账户。请先在那个账户中将其断开连接，或者使用不同的机器人。 ### 机器人未回复 - 确认卡片显示为 **已连接**，而不是 **已连接，需要操作**。 - 确认您测试的对象已 **关注您的机器人**。Viber 仅向关注者发送消息。 - 检查是否已为该渠道分配了 AI 代理。 ### 消息停止送达 这几乎总是 [检查连接状态](#checking-connection-status) 中描述的接管问题：同一个机器人被连接到了另一个工具。打开 **Viber** 卡片并重新连接。 ### 回复失败并显示“未订阅” 该用户取消关注或屏蔽了您的机器人。在他们重新关注并再次主动向您发送消息之前，您无法向他们发送消息。 --- ## 最佳实践 - **以支持为主，而非主动外呼。** 在用户发起的对话中进行回复是免费且无限制的；您主动发起的对话会收费，且只能送达给关注者。 - **让您的机器人易于关注。** 将其链接放在您的网站、电子邮件签名和其他渠道中。关注是人们联系您的唯一方式。 - **妥善保管您的授权令牌。** 任何拥有它的人都可以以您的机器人身份发送消息。如果令牌泄露，请在 Viber 应用中重新生成，然后在此处重新连接。 - **不要将同一个机器人连接到两个工具。** 第二个工具会静默接管它。