跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Viber Bot，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
通过 Viber REST Bot API 从 Viber 机器人发送消息：带键盘的文本、图片、视频、文件、链接、联系人、位置、贴纸和富媒体轮播，向最多 300 个订阅者群发，订阅者详情和在线状态，以及机器人的 webhook。使用机器人身份验证令牌。
试试这样问
Viber Bot 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Viber Bot、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Viber Bot + Meta Muse
通过 Viber REST Bot API 从 Viber 机器人发送消息：带键盘的文本、图片、视频、文件、链接、联系人、位置、贴纸和富媒体轮播，向最多 300 个订阅者群发，订阅者详情和在线状态，以及机器人的 webhook。使用机器人身份验证令牌。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
VIBER_AUTH_TOKEN
步骤 1 — 获取凭证
有了机器人之后，设置大约需要 5 分钟。
- 你需要一个现有的 Viber 机器人。自 2024 年 2 月 5 日起，Viber 只按商业条款创建新机器人：请通过 Rakuten Viber 或其官方合作伙伴申请（参见 https://developers.viber.com/docs/api/rest-bot-api/）。较早的免费机器人可以继续使用。
- 复制机器人的身份验证令牌（app key）：以机器人管理员身份在 Viber 应用的 More > Settings > Bots > Edit Info > Your app key 下找到，或在 Viber Admin Panel 中获取。
- 把它粘贴到
VIBER_AUTH_TOKEN，安装连接器并运行viber_get_account_info进行检查。 - Viber 只有在设置了 webhook 之后才允许机器人给用户发消息。如果你的机器人还没有 webhook，请用
viber_set_webhook设置一个：该 URL 必须以 HTTP 200 响应 Viber 的检查，并使用受信任 CA 签发的证书。
连接器只负责发送，不负责接收。Viber 只会把收到的消息和事件投递到机器人的 webhook，也就是你自己的公共 HTTPS 端点。
谁能收到消息：只有订阅了机器人的用户。用户给机器人发消息或点击订阅即完成订阅，并可随时退订。没有列出订阅者的 API：他们的用户 ID 会到达 webhook，因此 AI 发送的目标 ID 必须来自那里。发送给其他人会失败，返回 receiverNotSubscribed（6）或 receiverNotRegistered（5）。按电话号码给人发消息是另一款付费产品（Viber Business Messages），不属于本连接器。
能发送什么：发给单个订阅者的最多 7,000 个字符的文本（可附带由回复按钮组成的键盘）、图片、视频、文件、链接、联系人卡片、位置、贴纸，以及由带图片和按钮的卡片组成的富媒体轮播。每次发送都需要接收者的用户 ID 和最多 28 个字符的发送者名称。viber_broadcast_message 每次调用可把同一条消息发送给最多 300 个订阅者，在文本需要的位置填入每个接收者的名称或 ID，并列出未收到消息的接收者。
可读取的内容：机器人账户及其 webhook、事件类型和订阅者数量；单个订阅者的名称、国家、语言、设备和 Viber 版本（每个用户 12 小时内最多两次）；以及最多 100 个订阅者的在线状态。它还可以设置或移除 webhook；移除后，用户将无法再与机器人进行一对一聊天。
发送前确认：每条消息都会送达真实的人，而且商业机器人在用户发起的会话之外发送消息需要付费。AI 会展示文本和接收者，并等你同意。
格式：每个响应都有 status（0 = 成功）和 status_message，其他任何状态都会作为错误返回。发送成功的消息会返回 message_token。billing_status 为 0 到 4 表示未计费，为 5 表示会话之外的计费消息。时间为 Unix 毫秒。
限制：单个请求必须小于 30 KB。图片为 JPEG、PNG 或静态 GIF，iOS 上最大 1 MB（Android 上 3 MB），且 URL 中须带扩展名；视频为 MP4，最大 26 MB、180 秒；文件最大 50 MB（可执行文件会被拒绝）。群发允许每 10 秒 500 次请求。freeMessagesExceeded（23）或 noBalance（24）表示每月免费消息或余额已用完。
常见错误（status）：2 令牌无效，5 接收者不是 Viber 用户，6 接收者未订阅，7 机器人被屏蔽，9 机器人被暂停，10 未设置 webhook，11 接收者的 Viber 版本过旧，12 请求过多，21 不支持该国家。
连接器不会接收或读取收到的消息，不会列出订阅者，也不会给电话号码发送消息。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Muse 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器，并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors，选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面：登录并批准访问。
- 在聊天中，向 Muse 提出需要用到
Viber Bot的工具的请求。
你也可以在聊天中完成设置，适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息：
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接，因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
viber_get_account_info | Details of the bot account: id, name, uri, icon, category, country, the webhook URL and its event_types, and subscribers_count |
viber_get_user_details | Details of one subscribed user: name, avatar, country, language, primary device OS, device type, Viber and API version |
viber_get_online | Online status of up to 100 subscribed users. online_status: 0 online, 1 offline (with last_online in Unix ms), 2 hidden by the user, 3 try… |
viber_send_text | Send a text message (up to 7,000 characters) to one subscribed user, optionally with a keyboard of reply buttons |
viber_send_picture | Send a picture (JPEG, PNG or static GIF from a URL) with a caption to one subscribed user |
viber_send_video | Send an MP4 video (H.264, up to 26 MB and 180 seconds) from a URL to one subscribed user |
viber_send_file | Send a file (up to 50 MB, from a URL) to one subscribed user, e.g. a PDF invoice |
viber_send_url | Send a link (up to 2,000 characters) to one subscribed user; Viber shows a preview |
viber_send_contact | Send a contact card (name and phone number) to one subscribed user |
viber_send_location | Send a location pin (latitude and longitude) to one subscribed user |
viber_send_sticker | Send a Viber sticker by its numeric sticker id to one subscribed user |
viber_send_rich_media | Send a rich media message (a carousel of cards with images, text and buttons) to one subscribed user |
viber_broadcast_message | Send the same message to up to 300 subscribed users in one call |
viber_set_webhook | Set the bot's webhook, the HTTPS endpoint where Viber delivers incoming messages and events |
viber_remove_webhook | Remove the bot's webhook |
示例提示
- “我的 Viber 机器人有多少订阅者？它使用的是哪个 webhook？”
- “给订阅者 01234567890A== 发送文本：你的订单已发货。再添加两个回复按钮：是和否。”
- “把我们的周末营业时间群发给这 120 个订阅者 ID，然后告诉我哪些发送失败了。”
- “这 20 个订阅者中，现在有哪些在线？”
- “发送一个包含三个商品的轮播，每个商品都有一张图片、一个价格和一个可打开商品页面的购买按钮。”
FAQ
Muse 在哪些地区可用？ Meta 目前在美国和加拿大提供 Muse，可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗？ 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具，你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?