Hướng dẫn kết nối kênh chat

Hướng dẫn này giúp bạn tự kết nối từng kênh vào LynaX, gán AI Seller, kiểm tra webhook và gửi tin nhắn thử trước khi bật tự động trả lời.

Trước khi kết nối

Đăng nhập đúng workspace và đảm bảo tài khoản có quyền quản lý kênh.
Tạo và bật ít nhất một AI Seller.
Mở Nền tảng Chat → Kết nối, nhấn Kết nối kênh.
Chọn hướng dẫn bên dưới theo nền tảng bạn đang dùng.

Không bật Tự động trả lời ngay sau khi kết nối. Hãy hoàn tất bước kiểm tra ở cuối trang trước.

Kết nối Facebook Messenger

Chuẩn bị tài khoản Facebook có quyền quản trị Facebook Page cần kết nối.
Trong hộp Kết nối kênh, chọn Facebook Messenger → Kết nối ngay.
Đăng nhập Facebook, chọn Page và cấp các quyền mà màn hình OAuth yêu cầu. Không bỏ chọn quyền nhận/gửi tin nhắn.
Sau khi được đưa về LynaX, kiểm tra thẻ connection hiển thị đúng tên Page.
Mở menu connection → Kiểm tra kết nối. Nếu dùng trả lời bình luận, mở Cài đặt và cấu hình nội dung trả lời công khai/tin nhắn riêng.

Kết nối Instagram

Chuyển tài khoản Instagram sang Business Account và liên kết tài khoản đó với một Facebook Page.
Kết nối Facebook Page tương ứng với LynaX trước. Nếu chưa có, nút Instagram sẽ yêu cầu thực hiện bước này.
Chọn Instagram → Kết nối ngay, đăng nhập Facebook và cấp quyền cho tài khoản Instagram liên kết.
Quay lại LynaX, kiểm tra đúng tên tài khoản và chạy Kiểm tra kết nối.

Kết nối Zalo OA

Chuẩn bị tài khoản có quyền quản trị Official Account.
Chọn Zalo OA → Kết nối ngay, đăng nhập Zalo, chọn OA và chấp thuận quyền được yêu cầu.
Khi connection xuất hiện, mở menu → Xác minh Zalo OA.
Lấy OA Secret Key từ Zalo OA Admin, dán vào LynaX và lưu. LynaX tự quản lý webhook dùng chung.
Chạy Kiểm tra kết nối. Trạng thái sẽ chuyển sang đã xác minh sau khi LynaX nhận sự kiện có chữ ký đầu tiên từ OA.

Tạo Website Chat

Chọn Widget Chat → Kết nối ngay.
Nhập domain không kèm đường dẫn, ví dụ example.com; đặt tên widget và chọn AI Seller.
Cấu hình lời chào, placeholder, theme, vị trí, ngôn ngữ, màu sắc và hành vi tự mở/thông báo.
Kiểm tra bản preview, sau đó chọn Tạo widget chat.
Sao chép đoạn mã nhúng và dán vào <head> hoặc ngay trước thẻ đóng </body> của website.
Mở website bằng cửa sổ ẩn danh, gửi một tin thử và xác nhận hội thoại xuất hiện trong Seller Hub.

Kết nối WhatsApp Business

Chuẩn bị tài khoản Facebook có quyền quản trị Meta Business Portfolio và số điện thoại sẽ dùng cho WhatsApp Business.
Chọn WhatsApp Business → Kết nối ngay. LynaX sẽ mở luồng Meta Embedded Signup.
Trong cửa sổ Meta, đăng nhập, chọn hoặc tạo Business Portfolio và WhatsApp Business Account, sau đó chọn/đăng ký số điện thoại theo hướng dẫn.
Cấp các quyền được yêu cầu và hoàn tất đến khi Meta trả về LynaX. Không đóng popup giữa chừng.
Kiểm tra connection hiển thị đúng tài khoản/số WhatsApp rồi chạy Kiểm tra kết nối.

Nếu thấy “WhatsApp Embedded Signup chưa được cấu hình”, đây là cấu hình hệ thống của workspace—hãy liên hệ quản trị viên LynaX. Nếu Meta không trả về WABA ID hoặc Phone Number ID, mở lại luồng và hoàn tất toàn bộ bước xác minh số.

Kết nối Telegram Bot

Mở @BotFather trong Telegram và kiểm tra đúng tài khoản có dấu xác minh.
Gửi lệnh /newbot, nhập tên hiển thị và username kết thúc bằng bot.
Sao chép Bot Token do BotFather cấp. Token là mật khẩu của bot; không gửi qua chat hoặc lưu trong tài liệu công khai. Xem thêm hướng dẫn chính thức của Telegram.
Trong LynaX, chọn Telegram → Kết nối ngay, dán token vào trường Bot Token và xác nhận.
LynaX sẽ kiểm tra bot và tự đăng ký webhook. Khi connection xuất hiện, chạy Kiểm tra kết nối.
Mở bot bằng tài khoản Telegram cá nhân, nhấn Start hoặc gửi /start, rồi gửi một tin nhắn thử.

Telegram Bot không thể chủ động bắt đầu hội thoại. Khách hàng phải nhắn cho bot trước. Nếu token bị lộ, thu hồi token trong BotFather rồi kết nối lại bằng token mới.

Kết nối LINE Official Account

Tạo LINE Official Account và bật Messaging API theo hướng dẫn LINE Developers.
Trong LINE Developers Console, mở Messaging API channel; sao chép Channel Secret, Channel ID và phát hành Channel Access Token.
Trong LynaX, chọn LINE → Kết nối ngay; dán Channel Access Token, Channel Secret và Channel ID (Channel ID là trường tùy chọn trong form).
Xác nhận. LynaX kiểm tra bot và tự đăng ký webhook endpoint.
Thêm Official Account làm bạn bè, gửi tin thử và chạy Kiểm tra kết nối trong LynaX.

LINE khuyến nghị quản lý token có thời hạn phù hợp và thu hồi token nếu nghi ngờ bị lộ. Xem các loại Channel Access Token.

Gán AI Seller và bật kênh

Trên thẻ connection, chọn Quản lý AI Seller.
Gán một hoặc nhiều Seller đang ở trạng thái hoạt động.
Gửi tin nhắn từ một tài khoản khách thử và kiểm tra hội thoại xuất hiện trong Seller Hub.
Trả lời thủ công một lần để xác nhận chiều gửi hoạt động.
Bật Tự động trả lời. Chỉ bật Thu thập dữ liệu khi Seller đã được gắn collection/view phù hợp.

Kiểm tra và xử lý lỗi

Không nhận được tin: chạy Kiểm tra kết nối và xem trạng thái xác minh. Với Zalo OA, xác nhận OA Secret Key đúng rồi gửi một tin nhắn thử để tạo sự kiện có chữ ký.
Không gửi được tin: kiểm tra chính sách cửa sổ nhắn tin, quyền của ứng dụng và trạng thái số/Page/OA ở nhà cung cấp.
Không bật được AI: connection chưa có AI Seller hoạt động; mở Quản lý AI Seller để gán.
OAuth hoặc token hết hạn: chọn Kết nối lại; với Telegram/LINE, phát hành token mới nếu token cũ đã bị thu hồi.
Trả lời trùng: tắt auto-reply mặc định tại nhà cung cấp hoặc công cụ khác đang cùng sử dụng webhook.

Quyền gửi chủ động, cửa sổ nhắn tin, template và loại tệp phụ thuộc chính sách từng nền tảng. Trạng thái “đã kết nối” không thay thế việc duyệt quyền ở nhà cung cấp.