Hướng dẫn này trình bày cách kết nối TikTok Shop với HexaSync để lấy dữ liệu từ TikTok Shop. Dữ liệu này được dùng để đánh giá chất lượng dữ liệu sản phẩm và tồn kho, đồng thời kiểm tra dữ liệu trước khi kết nối với một hệ thống khác.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa. 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 người bán (seller) TikTok Shop Seller Center có quyền cấp phép cho shop cần kết nối.
- Danh sách shop cần kết nối. Một lần cấp quyền TikTok Shop có thể bao gồm nhiều shop, nhưng mỗi Connector HexaSync chỉ đồng bộ một shop.
Lưu ý: Chỉ khi doanh nghiệp yêu cầu dùng Partner App riêng, bạn mới cần chuẩn bị thêm Service ID, App Key và App Secret từ TikTok Shop Partner Center.
Phần 1: Cấp quyền kết nối TikTok Shop trên HexaSync
Bước 1: Đăng nhập HexaSync
- Truy cập HexaSync 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 TikTok Shop
- Mở Xác thực TikTok Shop trên HexaSync.
- Trên màn hình Check connection details, tìm TikTok Shop và chọn Connect.
Bước 3: Xác nhận ứng dụng HexaSync
- HexaSync hiển thị màn hình Select an app for TikTok Shop. Chọn ứng dụng [HexaSync] TikTok Shop Connector App có sẵn.
- Chọn Continue.
Lưu ý: HexaSync cung cấp sẵn thông tin app và xử lý việc cấp quyền với TikTok Shop cho bạn.
Bước 4: Cấp quyền cho ứng dụng trong TikTok Shop
Thực hiện lần lượt các bước trên TikTok Shop:
- Ở bước Authorize, chọn loại tài khoản của bạn.
- Ở bước Cài đặt, chọn thời hạn cấp quyền truy cập cho đối tác là Không giới hạn, nhập email và chọn Xác nhận cài đặt.
- Ở bước Ủy quyền, chọn Xác nhận, sau đó chọn Ủy quyền.
- TikTok Shop hiển thị trạng thái Connected.
Lưu ý: Mã ủy quyền TikTok Shop chỉ sử dụng được một lần và hết hạn sau vài phút. Hãy hoàn tất bước ủy quyền ngay khi bắt đầu, không để trang chờ lâu hoặc tải lại trang quay về HexaSync.
Bước 5: Hoàn tất Connector HexaSync
- Sau khi cấp quyền TikTok Shop thành công, quy trình thiết lập tiếp tục sang bước tạo Connector trên HexaSync.
- HexaSync tự đặt tên connector theo dạng [Tài khoản seller] TikTok Shop Connector. Bạn không cần nhập thêm thông tin, chỉ cần chọn Create Connector để tạo kết nối.
- Giữ nguyên trang trong vài phút. HexaSync tạo connector rồi tự chuyển sang mục Tasks của TikTok Shop Connector App khi hoàn tất.
- Bạn có thể tìm và mở Connector trong Connector Apps trên HexaSync để kiểm tra Connector vừa khởi tạo.
Sau khi Connector được khởi tạo, HexaSync sẽ lấy dữ liệu từ cửa hàng TikTok Shop đã kết nối trong vòng 30 phút.
Phần 2: Cấp lại quyền kết nối TikTok Shop trên HexaSync
Nếu bạn đã có Connector và cần cấp lại quyền kết nối TikTok Shop trên HexaSync, hãy thực hiện lần lượt các bước sau.
Bước 1: Mở Settings của Connector trong Connector Apps
- Mở Connector Apps, chọn TikTok Shop Connector cho cửa hàng của bạn. Nhấn chọn Settings ở menu bên trái.
Bước 2: Chọn Re-authorize
- Trong Settings, tìm thông tin kết nối TikTok Shop và chọn Re-authorize.
Không thực hiện được Re-authorize? Chỉ owner (người tạo) của TikTok Shop Connector App mới có quyền cấp lại quyền kết nối. Hãy liên hệ owner của Connector App.
Bước 3: Xác nhận ứng dụng HexaSync TikTok Shop
- HexaSync hiển thị màn hình Select an app for TikTok Shop. Chọn ứng dụng [HexaSync] TikTok Shop Connector App có sẵn.
- Chọn Continue.
Bước 4: Cấp quyền cho ứng dụng trong TikTok Shop
- Ở bước Authorize, chọn loại tài khoản của bạn.
- Ở bước Cài đặt, chọn thời hạn cấp quyền truy cập cho đối tác là Không giới hạn, nhập email và chọn Xác nhận cài đặt.
- Ở bước Ủy quyền, chọn Xác nhận rồi chọn Ủy quyền.
Phần 3: Kiểm tra kết nối thành công
Kết nối thành công khi HexaSync đưa bạn về Connector App hoặc trang cài đặt Connector mà không có thông báo lỗi. Nếu bạn kết nối khi chưa có Connector App, HexaSync hiện màn hình Connection successful. Hãy xác nhận lại ở hai chỗ trong HexaSync.
Thông tin kết nối đã xuất hiện
- Mở Connector App và vào Settings. Dòng Connection TikTok Shop giờ hiện thông tin kết nối có tên dạng
[TikTok Shop] - ABC123 Credential, thay cho nút Authorize.
Chạy thử một tác vụ lấy dữ liệu
Chạy tay một tác vụ lấy dữ liệu (Puller) của Connection này. Đây là phần thực sự gọi đến TikTok Shop, nên là phép thử chính xác nhất: tác vụ phải chạy xong mà không báo lỗi cấp quyền.
- Bấm Tasks ở thanh bên trái, rồi chọn một tác vụ lấy dữ liệu của TikTok Shop trong danh sách, ví dụ tác vụ sản phẩm hoặc tồn kho.
- Mở danh sách Other Actions và bấm Pull để chạy lấy dữ liệu thủ công ngay trong tác vụ.
- Chờ lượt chạy kết thúc, rồi mở kết quả. Kết quả phải không có lỗi cấp quyền và có các bản ghi lấy từ cửa hàng của bạn.
Lưu ý: Nếu tác vụ báo lỗi cấp quyền hoặc lỗi quyền truy cập, thông tin kết nối chưa hoạt động. Hãy cấp lại quyền theo Phần 2: Cấp lại quyền kết nối TikTok Shop trên HexaSync trước khi bật các lịch chạy.
Phần 4: Lỗi thường gặp và cách xử lý
Mỗi thông báo dưới đây được ghi đúng tiêu đề tiếng Anh mà bạn sẽ thấy trên HexaSync. Phần lớn màn hình lỗi có dòng Status và Detail from gateway hoặc Technical details. Hãy chụp lại các dòng này khi liên hệ bộ phận hỗ trợ.
| Thông báo | Cách xử lý |
|---|---|
| We Could Not Find Your Installation Details | HexaSync không tìm thấy thông tin phiên cài đặt, hoặc TikTok Shop không trả về mã ủy quyền. Thường do bạn mở link quay về trên trình duyệt hoặc cửa sổ ẩn danh khác, dữ liệu trình duyệt bị xóa giữa chừng, bạn bấm từ chối trên TikTok Shop, hoặc Redirect URL trong Partner Center không khớp. Bấm Back to installation và kết nối lại từ đầu trên cùng một trình duyệt và một tab, rồi bấm đồng ý trên trang TikTok Shop. |
| We Couldn’t Finish Connecting Your TikTok Shop Account | HexaSync không đổi được mã ủy quyền thành access token. Nếu Technical details có mã CREDENTIAL_INFORMATION_INVALID, thường do mã ủy quyền đã hết hạn hoặc đã được dùng, App Secret vừa được đổi trong Partner Center, hoặc bạn đồng ý ủy quyền nhưng không chọn shop nào. Bấm Back to installation và kết nối lại, hoàn tất bước đồng ý ngay và không tải lại trang quay về. Nếu đã đổi App Secret, hãy nhập App Secret mới. Nếu lỗi lặp lại với mã khác, gửi phần Technical details cho bộ phận hỗ trợ. |
| HexaSync Could Not Verify The Stored Credential | Thông tin kết nối đã được lưu nhưng HexaSync không lấy được access token hợp lệ khi kiểm tra lại. Bấm Back to installation và kết nối lại. Nếu lỗi vẫn còn, gửi dòng Status và Detail from gateway cho bộ phận hỗ trợ. |
| No Shop Was Authorized | TikTok Shop không trả về shop nào được ủy quyền, nên HexaSync không thể gọi API TikTok Shop thay cho bạn. Lỗi này xuất hiện khi cài đặt từ template. Bấm Back to installation và kết nối lại, chọn ít nhất một shop trước khi bấm đồng ý, và kiểm tra tài khoản đăng nhập có quyền quản lý shop đó. |
| An Error Occurred | Lỗi không xác định khi HexaSync kiểm tra thông tin kết nối của Connector. Thử lại sau ít phút. Nếu vẫn lỗi, gửi nội dung thông báo cho bộ phận hỗ trợ. |
Với các trường hợp khác, hãy gửi ảnh chụp màn hình (đã che thông tin nhạy cảm) đến support@beehexa.com.
Phần 5: Câu hỏi thường gặp
Một lần ủy quyền có kết nối được nhiều shop không?
Có. Một lần ủy quyền có thể bao gồm nhiều shop của cùng một tài khoản người bán. Tuy nhiên, mỗi Connector HexaSync chỉ đồng bộ một shop. Nếu bạn ủy quyền nhiều shop, HexaSync sẽ yêu cầu bạn chọn shop cho Connector này; nếu chỉ có một shop, HexaSync tự chọn shop đó.
Tôi muốn đồng bộ thêm một shop khác thì làm thế nào?
Cài đặt thêm một Connector mới và chọn shop còn lại ở bước chọn shop. Nếu bạn ủy quyền lại cùng tài khoản người bán, HexaSync sẽ cập nhật thông tin kết nối hiện có thay vì tạo bản trùng lặp.
Tôi có phải kết nối lại khi token hết hạn không?
Không. HexaSync tự làm mới access token bằng refresh token. Bạn chỉ cần kết nối lại khi thu hồi quyền của ứng dụng trên TikTok Shop, đổi App Secret của ứng dụng riêng, hoặc muốn thay đổi danh sách shop được ủy quyền.
Vì sao tôi phải hoàn tất ủy quyền nhanh?
Mã ủy quyền TikTok Shop gửi về chỉ dùng được một lần và hết hạn sau vài phút. Nếu bạn để trang chờ lâu hoặc tải lại trang quay về, mã sẽ không còn dùng được và bạn phải kết nối lại.
Tôi lỡ bấm hủy giữa chừng thì sao?
Không sao. HexaSync sẽ đưa bạn về trang cài đặt template, trang Connector, hoặc trang quản lý thông tin kết nối, tùy nơi bạn bắt đầu. Bạn có thể kết nối lại bất cứ lúc nào.
HexaSync có ghi hoặc sửa dữ liệu trên TikTok Shop không?
Không. TikTok Shop Connector App chỉ đọc dữ liệu, không ghi hoặc sửa dữ liệu trên TikTok Shop.