Hướng dẫn này dành cho chủ doanh nghiệp vận hành cửa hàng Shopee hoặc developer được giao thiết lập kết nối. Bạn sẽ kết nối cửa hàng Shopee với HexaSync Automation Engine, tạo Shopee Connector và có thể cấu hình Webhook để nhận sự kiện theo thời gian thực.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để đăng nhập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Tài khoản Shopee Seller Center của chủ cửa hàng cần kết nối. Chủ doanh nghiệp có thể phối hợp với developer ở các bước cấu hình ứng dụng.
- Khu vực cửa hàng: Worldwide (bao gồm Việt Nam) hoặc China.
- Nếu dùng Shopee App riêng: chuẩn bị Partner ID, Partner Key và Push Partner Key đúng môi trường kết nối. Nếu chưa tạo App, hãy làm theo hướng dẫn tạo Shopee App trên Shopee Open Platform Console trước khi tiếp tục.
Lưu ý: Với môi trường Production, Shopee App cần có trạng thái Online. Developer có thể chuẩn bị ứng dụng và thông tin kết nối, còn chủ cửa hàng thực hiện xác nhận cấp quyền trên Shopee.
Phần 1: Kết nối Shopee trên HexaSync
Bước 1: Đăng nhập HexaSync
- Truy cập HexaSync Automation Engine và đăng nhập bằng tài khoản Beehexa của bạn.
Bước 2: Bắt đầu kết nối Shopee
- Mở đường dẫn xác thực Shopee trên HexaSync.
- Trên màn hình Check connection details, tìm Shopee và chọn Connect.
Bước 3: Chọn Shopee App
- Chọn Use a different app, sau đó chọn I will provide my Shopee app.
- Trên màn hình Register a New Shopee App, nhập Partner ID, Partner Key và Push Partner Key.
- Tại App Environment, chọn Production cho thông tin Live; chỉ chọn Test nếu app thuộc môi trường sandbox.
- Kiểm tra các giá trị và chọn Continue.
HexaSync hiển thị “Whitelist the HexaSync redirect URL in Shopee Open Platform”? Kiểm tra phần Authorization Information của Shopee App trên Shopee Open Platform. Redirect URL Domain phải khai báo chính xác là:
https://app.hexasync.com/Giữ nguyên dấu
/ở cuối địa chỉ. Cách cấu hình xem ở Bước 7 bài tạo Shopee App.
Bước 4: Chọn khu vực cửa hàng
- Chọn Shop Region tương ứng với cửa hàng: Worldwide hoặc China.
- Chọn Continue to Shopee.
Bước 5: Cấp quyền trên Shopee
- Đăng nhập bằng tài khoản người bán của cửa hàng và chọn đúng quốc gia.
- Kiểm tra các quyền ứng dụng yêu cầu trên Shopee, sau đó chọn Confirm Authorization.
- Tại Authorization Period, chọn 365 Days nếu phù hợp, rồi chọn Confirm Authorization lần nữa.
Bước 6: Lưu và cấu hình Webhook URL
- Trên màn hình Connected - Save Your HexaSync Webhook URL, sao chép và lưu Webhook URL để thiết lập nhận sự kiện thời gian thực.
- Trong Shopee Open Platform, mở App Management › Push Mechanism › Set Push.
- Bật Get Live Push và dán Webhook URL vào Live Call Back URL.
- Chọn Deployment Service Area, sau đó chọn Verify.
- Bật các push code cần nhận.
Lưu ý: Cấu hình Push thực hiện ở cấp Shopee App và áp dụng cho các cửa hàng đã cấp quyền bằng cùng app. Chủ doanh nghiệp có thể nhờ developer cấu hình nếu không quản lý Shopee Open Platform.
Bước 7: Hoàn tất thiết lập trên HexaSync
- Tiếp tục bước tạo Shopee Connector trên HexaSync và nhập tên dễ nhận biết.
- Khi hoàn tất, HexaSync hiển thị Connection successful.
Phần 2: Kiểm tra kết quả sau khi kết nối
Mở danh sách Connector Apps và chọn Shopee Connector vừa tạo.
Kiểm tra thông tin kết nối
- HexaSync đã hiển thị Connection successful sau khi tạo Shopee Connector.
- Tại Connector App vừa tạo, vào Settings để xem thông tin kết nối Shopee.
Kiểm tra Webhook URL
- Webhook URL ở Bước 6 đã được lưu để cấu hình nhận sự kiện thời gian thực khi cần.
Lưu ý: Cấp quyền kết nối không đồng nghĩa với việc quy trình đồng bộ dữ liệu giữa Shopee và hệ thống khác đã được cấu hình.
Phần 3: Cấp lại quyền kết nối Shopee trên HexaSync
Thực hiện khi thời hạn cấp quyền kết thúc, ứng dụng bị gỡ trên Shopee hoặc HexaSync thông báo lỗi liên quan đến token.
Bước 1: Mở ứng dụng đã kết nối
- Mở Shopee Connector tương ứng trong Connector Apps và chọn Settings.
Bước 2: Chọn Re-authorize
- Trong Settings, tìm thông tin kết nối Shopee và chọn Re-authorize.
Không thực hiện được Re-authorize? Chỉ owner (người tạo) thông tin kết nối mới có thể thực hiện thao tác này. Hãy liên hệ owner của kết nối Shopee.
Bước 3: Xác nhận Shopee App
- Trên màn hình Choose an app to connect to Shopee, app hiện tại có nhãn Selected. Chọn Continue. Nếu cần chọn app khác, dùng Use a different app.
Bước 4: Chọn lại khu vực cửa hàng
- Chọn lại Shop Region giống lần cấp quyền ban đầu (Worldwide hoặc China) và chọn Continue.
Bước 5: Xác nhận lại quyền trên Shopee
- Đăng nhập tài khoản chủ cửa hàng, chọn Confirm Authorization, chọn thời hạn trong Authorization Period và xác nhận lại, như Bước 5 ở Phần 1.
Lưu ý: Khi cấp lại quyền cho cùng cửa hàng, thông tin kết nối hiện có được cập nhật. Không cần thay đổi Webhook URL đã cấu hình.
Phần 4: Lỗi thường gặp và cách xử lý
| Thông báo | Cách xử lý |
|---|---|
| The application has been registered but not belong to you (status 400) | Quay lại Select an App và chọn ứng dụng đã đăng ký. Nếu ứng dụng không có trong danh sách, liên hệ người quản trị sở hữu ứng dụng để được cấp quyền. |
| error_wrong_region | Kiểm tra và chọn lại đúng quốc gia của cửa hàng khi đăng nhập Shopee, sau đó cấp quyền lại. |
| Shopee Rejected The Authorization Code | Bắt đầu lại quy trình cấp quyền và hoàn tất các bước liên tục. Mã cấp quyền chỉ có hiệu lực trong thời gian ngắn và chỉ dùng được một lần. |
Với các trường hợp khác, hãy gửi ảnh chụp màn hình lỗi (đã che thông tin nhạy cảm) đến support@beehexa.com.
Phần 5: Câu hỏi thường gặp
Nên chọn Worldwide hay China khi kết nối cửa hàng?
Chọn Worldwide cho cửa hàng tại Việt Nam và các thị trường thuộc nhóm Worldwide; chọn China nếu cửa hàng thuộc khu vực China. Khi cấp lại quyền, chọn đúng khu vực đã dùng lần đầu, như Bước 4.
Cấp quyền thành công có nghĩa dữ liệu đã đồng bộ với hệ thống khác chưa?
Chưa. Cấp quyền kết nối Shopee với HexaSync là một bước thiết lập; quy trình đồng bộ dữ liệu giữa Shopee và hệ thống khác là nội dung riêng.
Tôi lấy Partner ID, Partner Key và Push Partner Key ở đâu?
Trong Shopee Open Platform, mở App Management › App List và chọn Shopee App để lấy Partner ID và Partner Key. Để lấy Push Partner Key, mở App Management › Push Mechanism › Set Push. Nếu kết nối Production, dùng các thông tin Live tương ứng. Xem chi tiết ở Phần 3 bài tạo Shopee App.
Khi nào tôi cần cấp lại quyền kết nối Shopee?
Khi Authorization Period hết hạn, cửa hàng đã gỡ ứng dụng trong Shopee Seller Center hoặc HexaSync báo lỗi liên quan đến token. Mở Shopee Connector App hiện có và làm theo Phần 3.
Ai có thể thực hiện Re-authorize cho kết nối Shopee?
Chỉ owner (người tạo) thông tin kết nối mới có thể chọn Re-authorize. Nếu bạn không phải owner, hãy liên hệ người quản lý thông tin kết nối để cấp lại quyền.
HexaSync có ghi hoặc sửa dữ liệu trên Shopee không?
Không. Shopee Connector App chỉ đọc dữ liệu, không ghi hoặc sửa dữ liệu trên Shopee.