您正在使用Chatwoot管理多渠道客户服务，但缺少越南一个重要渠道： Viber?

虽然 Chatwoot 当前已原生支持 Facebook、Telegram、Zalo（通过 Official Account）等渠道，但 Viber 仍未出现在“开箱即用’列表中。不过，不用担心！借助 Chatwoot 的开放架构，通过 API Channel, ,完全可以将Viber消息引入Chatwoot进行集中管理。.

本文将详细指导您如何实现这一点。.

为什么还没有内置集成？

Chatwoot是开源平台，社区集成正在开发中。在等待官方更新期间，我们将使用方法 “桥接器” (Bridge).

工作原理：
我们需要一个中间站（Middleware）来居中：

1. Viber Webhook 接收来自用户的消息 -> 发送到 Middleware。.
2. Middleware 转换格式 -> 调用 Chatwoot API 创建消息。.
3. Chatwoot Webhook （当客服回复时）-> 发送到 Middleware。.
4. Middleware 调用 Viber API -> 向用户发送消息。.

为了简单且无需编写代码（No-code/Low-code），本指南建议使用 n8n —— 一个我们经常介绍的强大自动化工具。.

准备

开始前，您需要：

1. Viber Admin Panel账户: 用于创建机器人并获取Token。.
2. Chatwoot: 已安装并运行（Cloud版或Self-hosted版）。.
3. n8n（或中间服务器）: 运行连接工作流。.

步骤 1：创建 Viber Bot 并获取 Token

首先，您需要在 Viber 上创建一个“机器人”。它将作为您企业在 Viber 上的形象。.

1. 访问 Viber 管理面板.
2. 使用您的 Viber 电话号码登录。.
3. 点击 创建机器人账户.
4. 填写完整信息：Bot 名称、头像、描述、网站等。
5. 创建完成后，您将收到一个 令牌 （如下图）。. 请仔细保存此代码, 这是 Chatwoot 敲开 Viber 大门的钥匙。.

步骤2：在Chatwoot上安装API通道

在 Chatwoot 中，我们不会选择“Facebook’或”Telegram’频道，而是选择特殊的 API.

1. 进入 设置 (Settings) > 邮箱 (Inboxes).
2. 选择 添加收件箱 (Add Inbox).
3. 选择频道类型为 API.
4. 命名：例如“Viber Support”。.
5. Webhook URL: 暂时留空或填写 n8n 的 URL（后续步骤将更新）.
6. 完成并将员工 (Agents) 添加到此收件箱。.

创建完成后，您将拥有 收件箱 ID 和 API 访问令牌 的 Chatwoot（在该收件箱设置中）。.

步骤 3：构建“桥接器” (Bridge)

这是最重要的一步。如果您会编程 (NodeJS、Python)，可以编写一个小服务器。如果不会，请使用 n8n.

流程 1：Viber -> Chatwoot（客户发送消息）

您需要创建一个 n8n 工作流来监听来自 Viber 的 Webhook。.
注意：Viber 要求 Webhook 必须是有效的 HTTPS。.

处理流程：

1. Webhook 节点: 接收来自 Viber 的 POST 数据。.
2. IF 节点: 检查 事件 是不是 message 不。.
3. HTTP Request (Chatwoot):
   • 调用： POST /api/v1/accounts/{account_id}/conversations （用于创建或查找对话）。.
   • Body: 发送 source_id 是 Viber 用户 ID（用于识别客户）。.
   • 然后调用： POST /api/v1/accounts/{account_id}/conversations/{conversation_id}/messages.
   • 内容：获取 text 从 Viber 发送的消息中。.

流程 2：Chatwoot -> Viber（客服回复）

您需要在 Chatwoot 中配置 Webhook（在刚刚创建的 Inbox API 设置部分），以便每次有新消息时发送数据到 n8n。.

处理流程：

1. Webhook 节点: 从 Chatwoot 接收数据。.
2. IF 节点: 检查 message_type 是不是 outgoing （发出的消息）并且 private 是 false 否（以避免向客户发送内部笔记）。.
3. HTTP Request (Viber):
   • 调用： https://chatapi.viber.com/pa/send_message
   • Header: X-Viber-Auth-Token:
   • Body:

     {
        "receiver": "",
        "type": "text",
        "text": ""
     }
     

步骤4：测试和运行

在设置完上述两个流程后：

1. 使用个人手机向您的 Viber Bot 发送消息。.
2. 检查 Chatwoot 中是否显示消息？ -> 如果是： 流程 1 成功.
3. 从 Chatwoot 回复客户消息。.
4. 检查手机上的 Viber Bot 是否有回复？ -> 如果是： 流2成功.

结论

将 Viber 集成到 Chatwoot 虽然需要一些技术操作（“桥接器”），但能够大幅提升客户服务集中化效率。您无需再单独打开 Viber 应用，所有内容都将在 Chatwoot 的专业仪表板中统一管理。.

如果您在配置n8n时遇到困难，, 不要犹豫留下评论或联系我们的技术团队 以获得详细的设置支持！