Cấu hình bán hàng đa kênh
Hướng dẫn thiết lập thông tin ứng dụng đối tác cho TikTok Shop, Shopee Seller, Facebook Messenger và Zalo OA trước khi kết nối kênh.
Trang Cấu hình bán hàng đa kênh (Cấu hình kết nối) là nơi lưu trữ các thông số kỹ thuật và thông tin xác thực ứng dụng nhà phát triển (Developer App / Partner App). Đây là bước nền tảng bắt buộc phải hoàn thành trước khi người dùng có thể thực hiện thao tác Thêm kênh trong màn hình Tích hợp đa kênh.
Vị trí truy cập trong Admin
Người quản trị có thể truy cập màn hình này bằng 2 cách:
- Vào menu Cài đặt website > Cấu hình bán hàng đa kênh.
- Hoặc từ màn hình Bán hàng đa kênh > Tích hợp đa kênh, nhấn vào liên kết 🔗 Cấu hình kết nối ở ngay dưới tiêu đề trang.
Đường dẫn nội bộ: #/setting/omnichannel/tab/general.
Chi tiết các khối cấu hình đối tác
1. Tích hợp TikTok Shop
Khối này lưu thông tin ứng dụng đối tác được đăng ký trên cổng TikTok Shop Partner Center (dành cho đối tác công nghệ / nhà phát triển tích hợp API).
| Trường thông tin | Loại dữ liệu | Giải thích |
|---|---|---|
| Developer App ID | Text | Mã định danh ứng dụng do TikTok Shop cấp khi tạo ứng dụng trong Partner Center. |
| Developer App Key | Text | Mã khóa công khai (App Key) của ứng dụng đối tác. |
| Developer App Secret | Mật khẩu (ẩn) | Mã bí mật (App Secret) dùng để ký request và giải mã token xác thực OAuth. |
[!NOTE] Để ứng dụng TikTok Shop hoạt động chính xác, ứng dụng trên TikTok Shop Partner Center phải được cấu hình quyền (Scopes) quản lý sản phẩm, đơn hàng, kho hàng và đăng ký webhook nhận sự kiện.
2. Tích hợp Shopee Seller
Khối này dùng cho việc kết nối API với sàn thương mại điện tử Shopee qua cổng Shopee Open Platform.
| Trường thông tin | Loại dữ liệu | Giải thích |
|---|---|---|
| Partner ID | Text | Mã đối tác do Shopee cấp cho ứng dụng của bạn trong Shopee Open Platform. |
| Partner Key | Mật khẩu (ẩn) | Khóa bí mật dùng để tạo chữ ký HMAC-SHA256 cho từng lệnh gọi API Shopee. |
| Môi trường (Sandbox) | Lựa chọn | Chọn Production (môi trường bán hàng thật) hoặc Sandbox (môi trường kiểm thử của Shopee). |
| Callback URL (Redirect URI) | URL | Đường dẫn URL nhận mã ủy quyền (Authorization Code) sau khi chủ shop bấm đồng ý cấp quyền trên trang Shopee. Mẫu: https://ten-mien-cua-ban.com/v1/ecomchannels/oauth/callback. |
3. Tích hợp Facebook Messenger
Khối này dùng để tích hợp Fanpage Facebook phục vụ việc nhận tin nhắn, đơn hàng và phản hồi khách hàng qua Messenger.
| Trường thông tin | Loại dữ liệu | Giải thích |
|---|---|---|
| Facebook App ID | Text | ID ứng dụng tạo trên cổng Meta for Developers (Facebook Developers). |
| Facebook App Secret | Mật khẩu (ẩn) | Khóa bí mật ứng dụng Facebook dùng để xác minh chữ ký Webhook và lấy Page Access Token dài hạn. |
| Webhook Verify Token | Text | Chuỗi ký tự bất kỳ do quản trị viên tự đặt (ví dụ chuỗi ngẫu nhiên bảo mật), dùng để đối chiếu khi Meta gửi request xác thực endpoint Webhook. |
| Callback URL (Redirect URI) | URL | Địa chỉ nhận mã chuyển hướng OAuth từ Facebook Login. Mẫu: https://ten-mien-cua-ban.com/omnichannel/v1/ecomchannels/oauth/callback. |
4. Tích hợp Zalo Official Account (OA)
Khối này kết nối OVIRO với hệ sinh thái Zalo Doanh nghiệp thông qua cổng Zalo for Developers.
| Trường thông tin | Loại dữ liệu | Giải thích |
|---|---|---|
| Zalo Developer App ID | Text | ID ứng dụng được tạo trong tài khoản nhà phát triển Zalo. |
| Zalo Developer Secret Key | Mật khẩu (ẩn) | Khóa bí mật của App Zalo dùng để đổi mã ủy quyền lấy Access Token / Refresh Token. |
| Callback URL (Redirect URI) | URL | Đường dẫn chuyển hướng sau khi quản trị viên OA đồng ý ủy quyền cho ứng dụng OVIRO. |
| OA Webhook Secret Key mặc định | Mật khẩu (ẩn) | (Tùy chọn) Khóa bí mật dùng để xác thực các webhook sự kiện từ Zalo gửi về. Khóa này đóng vai trò fallback; nếu trong chi tiết từng kênh OA có cấu hình riêng thì sẽ ưu tiên khóa của kênh đó. |
Các bước lưu cấu hình
- Nhập đầy đủ thông tin cho các nền tảng mà doanh nghiệp có kế hoạch kết nối.
- Kiểm tra kỹ các trường Callback URL đảm bảo trùng khớp chính xác với cấu hình trên cổng Developer của sàn (chú ý tiền tố
https://và dấu/cuối đường dẫn). - Nhấn nút Lưu cài đặt ở góc dưới cùng bên phải màn hình.
- Thông báo Cập nhật thành công sẽ hiển thị khi các giá trị được lưu vào hệ thống.
Lưu ý quan trọng
- Bảo mật: Các thông tin Secret Key, App Secret, Partner Key có quyền hạn truy cập rất cao vào dữ liệu bán hàng. Chỉ tài khoản có quyền Quản trị (
COMPANY_SETTING) mới được phép xem và chỉnh sửa trang này. - Tính khả dụng: Nếu chưa nhập thông tin nền tảng tại trang này, khi bấm Thêm kênh đối với các kênh OAuth tương ứng, hệ thống sẽ báo lỗi
error_oauth_url_failedhoặc cửa sổ ủy quyền không thể mở được. - Kênh iPOS.vn: Kênh iPOS.vn sử dụng phương thức API Key trực tiếp trên từng kênh khi thêm mới, nên không yêu cầu cấu hình chung tại màn hình này.