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

Trước khi kết nối

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

Kết nối Facebook Messenger

1. Chuẩn bị tài khoản Facebook có quyền quản trị Facebook Page cần kết nối.
2. Trong hộp Kết nối kênh, chọn Facebook Messenger → Kết nối ngay.
3. Đă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.
4. Sau khi được đưa về LynaX, kiểm tra thẻ connection hiển thị đúng tên Page.
5. 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

1. 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.
2. 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.
3. 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.
4. 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

1. Chuẩn bị tài khoản có quyền quản trị Official Account.
2. 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.
3. Khi connection xuất hiện, chạy Kiểm tra kết nối rồi gửi một tin nhắn thử từ tài khoản khách.
4. Gán AI Seller, kiểm tra hội thoại trong Seller Hub và chỉ bật tự động trả lời khi cả hai chiều đã hoạt động.

Tạo Website Chat

1. Chọn Widget Chat → Kết nối ngay, đặt tên widget, chọn AI Seller và cấu hình giao diện.
2. Với website LynaX, chọn website trong cấu hình widget rồi bật Draft và/hoặc Live. Không cần chèn mã hay build lại website.
3. Với website ngoài, nhập domain không kèm đường dẫn, ví dụ example.com, rồi sao chép script nhúng sau khi tạo widget.
4. 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

1. 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.
2. Chọn WhatsApp Business → Kết nối ngay. LynaX sẽ mở luồng Meta Embedded Signup.
3. 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.
4. 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.
5. 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.

Kết nối Telegram Bot

1. Mở @BotFather trong Telegram và kiểm tra đúng tài khoản có dấu xác minh.
2. Gửi lệnh /newbot, nhập tên hiển thị và username kết thúc bằng bot.
3. 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.
4. Trong LynaX, chọn Telegram → Kết nối ngay, dán token vào trường Bot Token và xác nhận.
5. 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.
6. 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ử.

Kết nối LINE Official Account

1. Tạo LINE Official Account và bật Messaging API theo hướng dẫn LINE Developers.
2. Trong LINE Developers Console, mở Messaging API channel; sao chép Channel Secret, Channel ID và phát hành Channel Access Token.
3. 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).
4. Xác nhận. LynaX kiểm tra bot và tự đăng ký webhook endpoint.
5. 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.

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

1. Trên thẻ connection, chọn Quản lý AI Seller.
2. Gán một hoặc nhiều Seller đang ở trạng thái hoạt động.
3. 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.
4. Trả lời thủ công một lần để xác nhận chiều gửi hoạt động.
5. 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, xác nhận đúng Page/OA/số điện thoại và gửi tin thử từ tài khoản khách.
• 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.