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

Mặc dù Chatwoot hiện hỗ trợ native (tích hợp sẵn) cho Facebook, Telegram, Zalo (qua Official Account), nhưng Viber vẫn chưa có mặt trong danh sách “out-of-the-box”. Tuy nhiên, đừng lo lắng! Với kiến trúc mở của Chatwoot thông qua API Channel, ,完全可以将Viber消息引入Chatwoot进行集中管理。.

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

为什么还没有内置集成？

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

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

1. Viber Webhook nhận tin nhắn từ người dùng -> Gửi đến Middleware.
2. Middleware chuyển đổi định dạng -> Gọi API Chatwoot để tạo tin nhắn.
3. Chatwoot Webhook (khi nhân viên trả lời) -> Gửi đến Middleware.
4. Middleware gọi API Viber -> Gửi tin nhắn đến người dùng.

为了简单且无需编写代码（No-code/Low-code），本指南建议使用 n8n – một công cụ tự động hóa mạnh mẽ mà chúng tôi thường xuyên giới thiệu.

准备

开始前，您需要：

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

Bước 1: Tạo Viber Bot & Lấy Token

Đầu tiên, bạn cần tạo một “con bot” trên Viber. Đây sẽ là bộ mặt doanh nghiệp của bạn trên Viber.

1. 访问 Viber 管理面板.
2. 使用您的 Viber 电话号码登录。.
3. 点击 创建机器人账户.
4. Điền đầy đủ thông tin: Tên Bot, Hình đại diện, Mô tả, Website…
5. 创建完成后，您将收到一个 令牌 （如下图）。. 请仔细保存此代码, 这是 Chatwoot 敲开 Viber 大门的钥匙。.

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

Trên Chatwoot, chúng ta không chọn kênh “Facebook” hay “Telegram”, mà sẽ chọn kênh đặc biệt là API.

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

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

Bước 3: Xây dựng “Cầu nối” (Bridge)

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

Luồng 1: Từ Viber -> Chatwoot (Khách nhắn tin)

您需要创建一个 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 发送的消息中。.

Luồng 2: Từ Chatwoot -> Viber (Nhân viên trả lời)

您需要在 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. Kiểm tra trên Chatwoot xem tin nhắn có hiện lên không? -> Nếu có: 流程 1 成功.
3. 从 Chatwoot 回复客户消息。.
4. Kiểm tra điện thoại xem Bot Viber có phản hồi không? -> Nếu có: 流2成功.

结论

Việc tích hợp Viber vào Chatwoot tuy cần một chút thao tác kỹ thuật (“cầu nối”) nhưng sẽ mang lại hiệu quả to lớn trong việc tập trung hóa CSKH. Bạn không cần phải mở ứng dụng Viber riêng lẻ nữa, mọi thứ đều nằm trong dashboard chuyên nghiệp của Chatwoot.

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