使用指南

Viber 机器人接入配置指南：连接工作区凭据、核对用户订阅状态与自动回复设置

Viber 通道连接一个 Viber 机器人（Bot）（或企业账号），订阅者与其他渠道一同出现在团队收件箱中。Viber 在东欧、希腊和东南亚广泛使用；它运行与 WAthink 其余部分相同的自动回复、流程、AI 助手和广播 — 并支持 Viber 自带的键盘与轮播富回复。

整理于 2026.10.02WAthink 万智客

实际入口、可用参数与操作权限，请结合所用版本、套餐及已启用模块核对。

本篇内容

概览

Viber 通道连接一个 Viber 机器人（Bot）（或企业账号），订阅者与其他渠道一同出现在团队收件箱中。Viber 在东欧、希腊和东南亚广泛使用；它运行与 WAthink 其余部分相同的自动回复、流程、AI 助手和广播 — 并支持 Viber 自带的键盘与轮播富回复。

接入最简单的渠道。Viber 只需一个值 — 认证 token — WAthink 会替你向 Viber 注册 Webhook。无需复制任何 URL。

Token 来自 Viber 自己的管理面板。步骤如下：

打开 Viber 管理面板。前往 partners.viber.com 并登录。系统会要求你用手机上的 Viber App 确认，请把手机放在手边 — 账号与你的手机号绑定。
创建机器人。选择 Create Bot Account。
填写信息。上传头像，并为机器人设置名称、URI（唯一标识）、分类、简短描述和国家/地区。客户看到的就是名称和头像。
创建账号。确认并提交表单。
复制 token。机器人创建后，Viber 会显示你的认证 token — 形如 4c04ba1b3fa1f3d0-1a2b3c4d5e6f7a8b-9c0d1e2f3a4b5c6d 的长字符串。复制它。之后可随时从面板中机器人的页面查看。

Token 就是机器人的密码。任何持有它的人都能以你的品牌发送消息。如果泄露，请在 Viber 面板中重新生成，并在 WAthink 中重新连接。

机器人与企业账号。免费的 Bot 即可支持双向聊天，是大多数团队需要的。Viber Business Messages（大规模事务性/营销消息，按条计费）是需与 Viber 或其合作伙伴另行开通的独立商业产品。

打开 Viber 页面 — 菜单中的渠道 → Viber。
粘贴认证 token 并保存。
WAthink 会自动注册 Webhook，并获取机器人的名称、头像和 URI，无需再向 Viber 粘贴任何内容。
测试。在 Viber App 中打开你的机器人（搜索名称或使用其深链），点击订阅（Subscribe），然后发送一条消息 — 几秒内它就会出现在团队收件箱中。

每个机器人只能有一个 Webhook。一个 Viber 机器人同一时间只能指向一个 Webhook。在其他工具中使用同一 token 连接，会悄悄从 WAthink 抢走事件。

规则	含义
必须已订阅	你只能给已订阅你机器人的用户发消息。只是打开过聊天但从未订阅的用户无法接收消息 — WAthink 会显示该会话，但拦截发送并给出明确原因。
没有 24 小时窗口	一旦有人订阅，你可以随时给他发消息；没有类似 WhatsApp 的会话过期。
广播批次大小	Viber 的广播接口每次调用最多接受 300 个收件人。WAthink 会将更大的受众拆分为批次并自动控制节奏。
退订	用户可以随时退订；向其发送会失败，WAthink 会在下一次广播中跳过他们。
速率限制	Viber 会对高发送量者限流。WAthink 会为广播控制节奏以保持在限制之内，而不是被拦截。

Viber 广播编辑器可触达你机器人的每一位订阅者。选择机器人、选定受众、撰写消息并实时预览，然后发送。因为没有 24 小时窗口，你可以触达整个订阅者群体 — WAthink 按 Viber 每次调用 300 人的上限拆分发送、控制节奏以符合速率限制，并跳过已退订的用户。

现象	原因与解决方法
收不到消息	token 错误或已被重新生成，或 Webhook 已被其他工具占用。重新粘贴新的 token；WAthink 会重新注册 Webhook。
保存时 Webhook 注册失败	Viber 要求可通过公网访问的 HTTPS URL 且证书有效。自签名证书、纯 HTTP 或 IP 地址都会被拒绝。
回复时提示“Not subscribed”	该用户打开过聊天但从未点击订阅。在其订阅前你无法给他发消息。
提示“Receiver is not registered”	用户已退订或删除了机器人。后续发送会跳过他们。
广播很慢	属正常现象 — WAthink 按 300 个收件人分批并控制调用节奏，以免机器人被限流。