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