Khi khách hàng nhắn cho cửa hàng trên Shopee nhưng đội ngũ bán hàng đang làm việc trong một inbox khác, việc chuyển qua lại giữa các tab có thể làm chậm phản hồi và phân tán ngữ cảnh khách hàng. Omnichat Bridge chuyển tiếp các tin nhắn được hỗ trợ từ tab Shopee Seller Chat đang mở vào KaoJai Inbox mà không đưa mật khẩu, cookie hoặc login token của người bán ra khỏi trình duyệt. ## Omnichat Bridge hoạt động như thế nào  Ranh giới quan trọng rất đơn giản: **trình duyệt của người bán vẫn là nơi đăng nhập Shopee.** Extension hoạt động như một co-pilot có con người kiểm soát, chỉ chuyển tiếp các sự kiện chat được hỗ trợ đến máy chủ đã cấu hình. Luồng hoạt động: 1. Người bán tự đăng nhập và mở Shopee Seller Chat. 2. Extension đọc các tin nhắn mới được hỗ trợ từ phiên đang mở và giữ những mục chưa gửi thành công trong hàng đợi cục bộ. 3. Extension gửi từng batch đến máy chủ đã cấu hình qua HTTPS kèm chữ ký HMAC. 4. Sau khi máy chủ xác nhận đã nhận dữ liệu, extension mới xóa các mục đó khỏi hàng đợi cục bộ. 5. Đội ngũ tiếp tục làm việc với cùng ngữ cảnh hội thoại trong KaoJai Inbox. Khi Chrome hoặc tab Seller Chat đóng, Bridge cũng dừng hoạt động. Đây không phải là bot từ xa tiếp tục trả lời khi người bán không còn ở trước màn hình.⚠️ Vui lòng đọc trước khi bắt đầu: Omnichat Bridge là một phương thức kết nối không chính thức. Đây không phải là sản phẩm của Shopee và không được Shopee liên kết hoặc chứng thực.
Chỉ sử dụng sau khi bạn đã xem xét các điều khoản liên quan của nền tảng và chấp nhận rủi ro. Việc sử dụng có thể dẫn đến cảnh báo, hạn chế, đình chỉ hoặc mất quyền truy cập. Mã nguồn được công khai để kiểm tra, và bạn chỉ nên thiết lập bằng tài khoản mà mình được phép vận hành.
Ví dụ dưới đây cho thấy một hội thoại Shopee trong KaoJai Inbox với trạng thái **Omnichat · Live**, phản hồi của đội ngũ và bảng sản phẩm, đơn hàng giúp người bán tiếp tục làm việc trên cùng một màn hình.  ## Dữ liệu được gửi và dữ liệu không bao giờ được gửi | Gửi đến máy chủ đã cấu hình | Bridge không lưu hoặc gửi | | --- | --- | | Tin nhắn đến và đi được hỗ trợ | Mật khẩu Shopee | | URL hình ảnh và video được hỗ trợ | Cookie, token hoặc thông tin đăng nhập | | ID người mua, tên hiển thị, URL ảnh đại diện và thời gian | Request header của phiên người bán | | Dữ liệu hội thoại cần thiết cho công việc trong Inbox | HMAC secret đi kèm dữ liệu tin nhắn | Mỗi batch sử dụng HTTPS và HMAC để máy chủ đích có thể xác minh request đến từ Bridge đã được cấu hình. Điều này không loại bỏ rủi ro liên quan đến chính sách nền tảng, vì vậy vẫn cần có người chịu trách nhiệm kiểm tra thiết lập và theo dõi quá trình sử dụng.  ## Thiết lập chuyển tiếp Shopee Chat vào KaoJai Inbox Trước khi bắt đầu, bạn cần là quản trị viên của KaoJai workspace, đã kết nối cửa hàng Shopee của mình với KaoJai và đang dùng Chrome đăng nhập vào Seller Chat của cửa hàng đó.Co-pilot nằm trong trình duyệt: Forwarder chỉ hoạt động khi máy tính của người bán, Chrome và Seller Chat đang chạy. Công cụ hỗ trợ người bán ngay trong trình duyệt và không gửi mật khẩu, cookie, login token hoặc thông tin đăng nhập khác của người bán đến máy chủ đích.
## Điều kiện vận hành cần lưu ý - Chrome và tab Seller Chat phải luôn mở để nhận tin nhắn theo thời gian thực. - Bridge có thể khôi phục một số tin nhắn bị bỏ lỡ khi hoạt động trở lại, nhưng đây không phải là dịch vụ chạy nền bảo đảm thu thập tin nhắn khi máy tính đã tắt. - Trả lời trực tiếp cần một trình duyệt đang kết nối và mở đúng hội thoại. Nếu không sẵn sàng, hệ thống sẽ trả về lỗi thay vì âm thầm xếp hàng một lệnh từ xa. - Chỉ sử dụng cửa hàng và workspace mà bạn được phép vận hành, đồng thời xem lại chính sách Shopee trước khi bật hoặc mở rộng việc sử dụng. ## Tài liệu và video liên quan - [Omnichat Bridge trên GitHub](https://github.com/kaojai-ai/omnichat-bridge) — mã nguồn mở, tài liệu kiến trúc và chính sách quyền riêng tư. - [Hướng dẫn Shopee provider](https://github.com/kaojai-ai/omnichat-bridge/blob/main/docs/providers/shopee.md) — chi tiết về đồng bộ, khôi phục và phạm vi dữ liệu. - [Video demo Omnichat Bridge](https://youtu.be/1jhDywbflmg) — xem nhanh quy trình trước khi thiết lập. ## Bối cảnh: vì sao chúng tôi xây dựng Omnichat Bridge này Mục tiêu của chúng tôi khá khiêm tốn: giúp những người bán được ủy quyền quản lý hội thoại Shopee trong cùng workflow với đội ngũ, đồng thời tôn trọng các quy định của nền tảng. Trước khi phát triển, chúng tôi đã nhiều lần liên hệ với Shopee qua support, human agent và account executive để hỏi xem có lộ trình tích hợp customer service chính thức hoặc đầu mối phụ trách hay không. Mỗi lần, câu trả lời đều quay về cùng một điểm: Chat API (Customer Service Apps) không còn nhận hồ sơ mới và đã **đóng đăng ký từ ngày 18 tháng 11 năm 2024**—hơn **một năm tám tháng** tính đến thời điểm viết bài. Chúng tôi đã hy vọng tìm được một lộ trình được hỗ trợ, nhưng sau nhiều lần hỏi và vẫn nhận cùng một câu trả lời, chúng tôi thật sự cảm thấy không còn lựa chọn nào và phải chấp nhận rằng lúc đó chưa có con đường chính thức dành cho mình.  Vì không tìm được lộ trình chính thức có thể sử dụng, chúng tôi xây dựng Omnichat Bridge như một lựa chọn mã nguồn mở do người bán tự kiểm soát. Mục đích chỉ là giảm việc chuyển đổi giữa các tab, đồng thời công khai cách hoạt động, phạm vi dữ liệu và rủi ro để mọi người có thể kiểm tra. Nếu Shopee cung cấp một kênh chính thức phù hợp với cửa hàng của bạn, vui lòng ưu tiên sử dụng kênh đó.Giữ tệp config ở chế độ riêng tư: tệp này chứa HMAC secret dùng để xác thực Bridge. Không gửi tệp trong chat công khai, commit lên Git hoặc export từ extension đến nơi người khác có thể truy cập.
Nếu người quản lý máy tính thay đổi hoặc bạn nghi ngờ tệp bị lộ, hãy ngừng sử dụng cấu hình đó và liên hệ KaoJai để cấp cấu hình mới trước khi tiếp tục.