# Viber Kết nối **bot Viber** của riêng bạn để các cuộc trò chuyện trên Viber đổ về ứng dụng và một AI Agent có thể trả lời. Bạn chỉ cần kết nối bằng cách dán một giá trị (mã xác thực bot của bạn) và chúng tôi sẽ xử lý phần thiết lập còn lại cho bạn. --- ## Tích hợp Viber là gì? Tích hợp Viber liên kết **bot Viber** mà bạn sở hữu với nền tảng bằng cách sử dụng Bot API chính thức của Viber, hệ thống riêng của Viber để gửi và nhận tin nhắn tự động thay vì bạn phải nhập thủ công. Các cuộc trò chuyện giữa bot của bạn và những người theo dõi nó sẽ khả dụng bên trong ứng dụng, đồng thời một AI Agent và hộp thư đến dùng chung sẽ hoạt động trên các cuộc trò chuyện đó. Đây là một tích hợp **chính thức**, vì vậy nó ổn định và tuân thủ các quy tắc của Viber. > **Tính khả dụng.** Viber được sử dụng rộng rãi nhất tại Philippines, Việt Nam và các khu vực khác của Đông Nam Á, cũng như trên khắp Đông Âu và Hy Lạp. --- ## Trước khi bắt đầu **Bạn cần có bot Viber của riêng mình và Viber chỉ cấp bot cho các gói doanh nghiệp trả phí.** Kể từ tháng 2 năm 2024, Viber không còn tạo bot miễn phí nữa. Bạn thiết lập tài khoản trực tiếp với Viber, và tài khoản đó cùng các khoản phí liên quan là thỏa thuận giữa bạn và Viber. Chúng tôi không bán lại, tăng giá hay hưởng hoa hồng, và chúng tôi không thể tạo bot thay cho bạn. Tại thời điểm viết bài, Viber tính phí hàng tháng cho mỗi bot cộng với phí cho mỗi tin nhắn mà bot của bạn khởi tạo (xem [Chi phí](#cost) bên dưới). Hãy kiểm tra các điều khoản hiện tại của Viber khi bạn đăng ký, vì họ có quyền thay đổi chính sách giá của mình. Không có biểu mẫu đăng ký tự phục vụ. Viber xem xét thủ công mọi ứng dụng chatbot và bạn có thể đăng ký theo một trong hai cách: - **Thông qua đối tác Viber đã được xác minh**, đây là cách Viber khuyến nghị và thường là cách nhanh hơn. - **Trực tiếp với Viber**, bằng cách gửi email đến `partners@viber.com`. Nếu bạn đã làm việc với Viber, người quản lý tài khoản doanh nghiệp của bạn có thể bắt đầu quy trình này thay cho bạn. Sau khi đơn đăng ký của bạn được phê duyệt, bạn sẽ ký thỏa thuận của Viber và chấp nhận các điều khoản thương mại của họ, sau đó bot của bạn sẽ được tạo. Sau đó, bạn sẽ tìm thấy token của nó trong ứng dụng Viber tại mục **Thêm → Cài đặt → Bot → Chỉnh sửa thông tin → Khóa ứng dụng của bạn**. Viber gọi đó là *khóa ứng dụng* (*app key*); tài liệu API của họ gọi cùng giá trị đó là *mã xác thực* (*authentication token*), và quản trị viên bot cũng có thể thấy nó trong bảng điều khiển quản trị của Viber. Dù được gắn nhãn là gì, thì đó chính là giá trị duy nhất mà ứng dụng này yêu cầu. Mã thông báo đó là thứ duy nhất bạn cần từ Viber. Việc thiết lập tại đây chỉ mất khoảng một phút. --- ## Thiết lập Viber ### Bước 1: Sao chép mã xác thực bot của bạn Nơi nhanh nhất để tìm thấy nó là ứng dụng Viber trên điện thoại của bạn. 1. Mở Viber trên điện thoại sở hữu tài khoản bot. 2. Đi tới **Thêm (More) → Cài đặt (Settings) → Bot**. 3. Chọn bot của bạn và nhấn vào **Chỉnh sửa thông tin (Edit Info)**. 4. Sao chép giá trị hiển thị bên dưới **Khóa ứng dụng của bạn (Your app key)**. Đó chính là mã thông báo. > Hãy giữ bí mật mã này. Bất kỳ ai có mã này đều có thể gửi tin nhắn dưới danh nghĩa bot của bạn. ### Bước 2: Kết nối Viber trong ứng dụng 1. Trong thanh bên trái, nhấp vào **Settings** (Cài đặt) ở gần cuối. 2. Trong thanh điều hướng bên trái của Settings, dưới mục **Channels** (Kênh), nhấp vào **Channels**. 3. Tìm thẻ **Viber** và nhấp vào **Connect** (Kết nối). 4. Dán **auth token** (mã xác thực) của bạn vào. 5. Nhấp vào **Connect**. 6. Ứng dụng sẽ kiểm tra mã token với Viber và hiển thị **"Connected to: \"**. **Không cần thiết lập webhook.** Không giống như hầu hết các kênh khác, chúng tôi đăng ký mọi thứ với Viber cho bạn như một phần của quá trình kết nối, vì vậy không có gì cần phải sao chép vào bảng điều khiển khác. Màn hình kết nối hiển thị địa chỉ nơi tin nhắn của bạn đến chỉ để bạn có thể chia sẻ với bộ phận hỗ trợ nếu cần. ### Bước 3: Kiểm tra bot 1. Từ một điện thoại khác, hãy mở Viber và **theo dõi bot của bạn** (tìm kiếm bot hoặc sử dụng liên kết của bot). 2. **Gửi tin nhắn cho bot.** 3. Mở ứng dụng và đi tới **Chats** (Trò chuyện). Tin nhắn đến sẽ xuất hiện trong danh sách hội thoại. 4. Nếu một AI Agent đang xử lý kênh này, bạn sẽ thấy nó **tự động trả lời**. Sau khi kết nối, bot Viber của bạn sẽ hiển thị là **Connected** (Đã kết nối) trên trang Channels và AI sẽ phản hồi các tin nhắn đến. --- ## Những ai mà Bot của bạn có thể nhắn tin Đây là điều quan trọng nhất cần hiểu về Viber, và nó khác biệt so với mọi kênh khác: **Bot của bạn chỉ có thể nhắn tin cho những người theo dõi nó.** Ai đó phải tìm thấy bot của bạn và theo dõi nó trước khi bạn có thể gửi bất cứ thứ gì cho họ. Không có cách nào để nhắn tin cho người dùng Viber chưa theo dõi bot của bạn trước đó. Nếu ai đó hủy theo dõi hoặc chặn bot của bạn, bạn không thể nhắn tin cho họ nữa cho đến khi họ theo dõi lại và nhắn tin cho bạn. Khi điều đó xảy ra, ứng dụng sẽ đánh dấu cuộc hội thoại để ngừng cố gắng gửi tin, và bất kỳ câu trả lời nào bạn gửi sẽ hiển thị là thất bại kèm theo giải thích thay vì âm thầm biến mất. Vì lý do này, Viber hoạt động rất tốt như một **kênh hỗ trợ và phản hồi** (ai đó nhắn tin cho bạn, AI trả lời) và không hiệu quả như một kênh tiếp cận khách hàng mới (cold-outreach). --- ## Chi phí Viber là một kênh **miễn phí** trong ứng dụng: không tính phí mỗi tin nhắn và không có phí kết nối hàng tháng từ chúng tôi. Chi phí của bạn đến từ **Viber**, trên tài khoản riêng của bạn: - **Phí hàng tháng cho mỗi bot** (khoảng 100 € tại thời điểm viết bài). - **Các câu trả lời trong một cuộc hội thoại do người dùng bắt đầu đều miễn phí và không giới hạn.** Điều này bao gồm hầu hết mọi thứ mà một AI Agent thực hiện. - **Các tin nhắn do bot của bạn bắt đầu**, bên ngoài cuộc hội thoại mà người đó đã bắt đầu, sẽ bị tính phí theo tin nhắn với mức giá phụ thuộc vào quốc gia của người nhận. Kết luận thực tế: việc trả lời mọi người không tốn kém gì ngoài phí hàng tháng. Các chương trình phát sóng và theo dõi chủ động mới là những thứ làm tăng chi phí. --- ## Tin nhắn đa phương tiện Ảnh, video, tệp, nhãn dán, vị trí và danh bạ được chia sẻ gửi đến đều được nhận dạng để AI biết rằng phương tiện đã được gửi (một ghi chú ngắn sẽ được thêm vào cuộc hội thoại). Các câu trả lời AI gửi đi là **văn bản và hình ảnh** trong phiên bản này. Các câu trả lời dài sẽ tự động được cắt bớt theo giới hạn 7.000 ký tự của Viber. --- ## Quản lý phiên ### Kiểm tra trạng thái kết nối Trạng thái kết nối Viber của bạn được hiển thị trên thẻ **Viber** tại trang **Channels**: | Trạng thái | Ý nghĩa | |---|---| | **Đã kết nối** | Một bot Viber đã được liên kết với tài khoản này | | **Đã kết nối, cần thực hiện hành động** | Một công cụ khác đã chiếm quyền điều khiển bot của bạn; tin nhắn không được gửi đến chúng tôi | | **Chưa kết nối** | Chưa thiết lập kết nối | Thẻ này sẽ kiểm tra lại bot của bạn mỗi khi bạn mở trang Kênh. **Một bot Viber chỉ có thể gửi tin nhắn đến một nơi tại một thời điểm**, vì vậy nếu bạn kết nối cùng một bot với một công cụ khác, công cụ đó sẽ chiếm quyền điều khiển và tin nhắn của bạn sẽ ngừng đến đây mà không có cảnh báo nào từ Viber. Đó là ý nghĩa của trạng thái **"Đã kết nối, cần thực hiện hành động"**. Hãy mở thẻ và kết nối lại để giành lại quyền điều khiển. ### Ngắt kết nối Mở thẻ **Viber** và nhấp vào **Quản lý**, sau đó nhấp vào **Ngắt kết nối** và xác nhận **Xóa Viber?**. Thao tác này sẽ ngăn chúng tôi nhận tin nhắn của bot và xóa bot khỏi tài khoản của bạn. Bản thân bot vẫn thuộc về bạn. Không có gì thay đổi trên tài khoản Viber của bạn. --- ## Hạn chế - **Chỉ dành cho người theo dõi.** Bot của bạn chỉ có thể nhắn tin cho những người theo dõi nó. Xem [Ai có thể nhận tin nhắn từ bot của bạn](#who-your-bot-can-message). - **Bạn cần có bot Viber trả phí của riêng mình.** Chúng tôi không thể cung cấp bot. - **Mỗi kết nối một bot.** Kết nối từng bot riêng biệt; một bot chỉ có thể được liên kết với một tài khoản. - **Gửi văn bản + hình ảnh.** AI trả lời bằng văn bản và hình ảnh; băng chuyền (carousel) và thẻ phong phú (rich card) không được gửi trong phiên bản này. - **Không có tin nhắn chào mừng.** Khi ai đó mở bot của bạn lần đầu tiên nhưng chưa theo dõi nó, Viber cho phép một lời chào tức thì duy nhất. Phiên bản này không gửi lời chào đó. Cuộc trò chuyện bắt đầu khi họ gửi tin nhắn đầu tiên. --- ## Khắc phục sự cố ### Token bị từ chối khi kết nối - Đảm bảo bạn đã sao chép giá trị từ **Chỉnh sửa thông tin → Khóa ứng dụng của bạn (Your app key)** trong ứng dụng Viber, không phải id khác. - Kiểm tra xem bot của bạn vẫn đang hoạt động trên tài khoản Viber của bạn. - Việc kết nối cũng kiểm tra xem Viber có thể tiếp cận chúng tôi hay không. Nếu token của bạn chắc chắn đúng mà vẫn thất bại, hãy đợi một phút và thử lại, sau đó liên hệ với bộ phận hỗ trợ. ### "Bot Viber này đã được kết nối với một tài khoản khác" Cùng một bot đang được liên kết với một tài khoản khác trong ứng dụng. Hãy ngắt kết nối ở đó trước, hoặc sử dụng một bot khác. ### Bot không phản hồi - Xác nhận thẻ hiển thị **Đã kết nối**, không phải **Đã kết nối, cần thực hiện hành động**. - Xác nhận người bạn đang thử nghiệm cùng đã **theo dõi bot của bạn**. Viber chỉ gửi tin nhắn từ những người theo dõi. - Kiểm tra xem một Tác nhân AI đã được gán cho kênh này chưa. ### Tin nhắn ngừng đến Đây hầu như luôn là vấn đề chiếm quyền điều khiển được mô tả trong phần [Kiểm tra trạng thái kết nối](#checking-connection-status): cùng một bot đã được kết nối với một công cụ khác. Hãy mở thẻ **Viber** và kết nối lại. ### Một phản hồi thất bại với thông báo "Không đăng ký" ("Not Subscribed") Người đó đã hủy theo dõi hoặc chặn bot của bạn. Bạn không thể nhắn tin cho họ cho đến khi họ theo dõi lại và gửi tin nhắn cho bạn trước. --- ## Các phương pháp hay nhất - **Ưu tiên hỗ trợ, không phải tiếp cận chủ động.** Các phản hồi trong một cuộc trò chuyện do người dùng bắt đầu là miễn phí và không giới hạn; các tin nhắn bạn chủ động gửi sẽ bị tính phí và chỉ đến được với những người theo dõi. - **Giúp bot của bạn dễ theo dõi hơn.** Đặt liên kết bot trên trang web, trong chữ ký email và các kênh khác của bạn. Theo dõi bot là cách duy nhất để mọi người có thể liên hệ với nó. - **Giữ an toàn cho mã xác thực (auth token) của bạn.** Bất kỳ ai có mã này đều có thể gửi tin nhắn dưới danh nghĩa bot của bạn. Hãy tạo lại mã trong ứng dụng Viber nếu bị lộ, sau đó kết nối lại tại đây. - **Đừng kết nối cùng một bot với hai công cụ.** Công cụ thứ hai sẽ âm thầm chiếm quyền điều khiển.