跳过安装。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 + Microsoft Copilot
通过 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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name（例如
AnythingMCP）、说明连接器用途的 Server description，以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key，把 Type 设为 Header，请求头名称填
X-API-Key，然后选择 Create。 - 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试：提出需要用到
Viber Bot的工具的请求。 - 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 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
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?