Kết nối TikTok Shop với omniVN
Có thể kết nốiNhấn Connect Commerce, đăng nhập TikTok Shop Seller Center và nhấn Authorize. Không dán app key hay token. Shop ≠ Ads.
Cổng sẵn sàng: TIKTOK_SHOP_* + secret store + Redirect URL khớp. Đường chính: OAuth (Connect Commerce).
Giới hạn hiện tại
- Hướng dẫn này chỉ cho TikTok Shop. TikTok Ads là kết nối riêng — Shop ≠ Ads.
- Sản phẩm/tồn kho TikTok Shop chưa được đồng bộ (chỉ đơn hàng).
Tổng quan
TikTok Shop dùng OAuth qua app Partner Center của chính doanh nghiệp (app_key / app_secret / service_id); TikTok xét duyệt hồ sơ developer, có thể mất vài tuần. omniVN hướng dẫn đăng ký và lưu app cho workspace (liên hệ omniVN qua nút “Book onboarding help” trên trang TikTok Shop); sau đó người bán chỉ cần ủy quyền shop; omniVN đổi code lấy access token phía máy chủ và tự làm mới. Hiện omniVN đồng bộ đơn hàng. TikTok Ads (insights) là kết nối riêng tại Integrations → TikTok Ads.
Điều kiện trước khi bắt đầu
- Tài khoản TikTok Shop Seller Center đang hoạt động, có quyền ủy quyền ứng dụng.
- Trong omniVN: quyền kết nối kênh trên workspace (channels.connect).
Các bước lấy credential
1. Nhấn Connect Commerce trong omniVN
Vào Integrations → TikTok Shop và nhấn Connect Commerce. omniVN mở trang ủy quyền services.tiktokshop.com, liệt kê các quyền ứng dụng yêu cầu.
2. Chọn khu vực và đăng nhập Seller Center
Nhấn Next dưới khu vực của shop, đăng nhập Seller Center, kiểm tra thông tin ứng dụng và thời hạn ủy quyền.
3. Nhấn Authorize và quay lại omniVN
Nhấn Authorize. TikTok Shop chuyển về omniVN kèm code (dùng một lần, hết hạn 30 phút); omniVN đổi lấy token và danh sách shop đã ủy quyền. Nếu bạn từ chối, omniVN nhận lỗi auth_denied và không tạo kết nối.
Ánh xạ credential với omniVN
| Field omniVN | Tên trong tài liệu official | Bắt buộc | Lấy từ đâu |
|---|---|---|---|
| TikTok Shop App Key | app_key | Bắt buộc | operator_managed App TikTok Shop Partner Center của chính workspace, operator omniVN seal vào cấu hình app của org (không dùng env chung). |
| TikTok Shop App Secret | app_secret | Bắt buộc | operator_managed |
| TikTok Shop Access Token | access_token | Bắt buộc | oauth_authorization Lấy từ auth_code sau khi seller cấp quyền OAuth. |
| TikTok Shop ID | shop_id | Bắt buộc | oauth_authorization Có sau OAuth; không dán tay trên form. |
shopAppKey / shopAppSecret → app Partner Center của chính workspace, operator omniVN seal vào cấu hình app của org (kèm service_id nếu khác app key); người bán không nhập trên UI. shopAccessToken / shopId → có sau OAuth, lưu secret store.
Vòng đời token
Access token mặc định 7 ngày; omniVN làm mới bằng refresh token. Refresh token hết hạn theo thời hạn ủy quyền người bán chọn. Gia hạn: Connect lại, hoặc Seller Center → App Store → My apps and incidents (TikTok nhắc trước 30 ngày). Hủy ủy quyền cũng ở trang đó.
Lỗi thường gặp
Connect báo PROVIDER_CONFIGURATION_INVALID hoặc nút chưa sẵn sàng
Workspace chưa có app TikTok Shop được seal, hoặc deployment thiếu secret store / OAuth callback URL. Liên hệ omniVN — không dán token để vượt qua.
Lỗi invalid code sau khi Authorize
Code đã dùng hoặc quá 30 phút, hoặc Redirect URL trên Partner Center không khớp callback omniVN. Connect lại từ omniVN.
Cài từ TikTok Shop App Store không tạo kết nối
omniVN chỉ nhận ủy quyền bắt đầu từ nút Connect Commerce trong omniVN.