← Tất cả tích hợp

Kết nối TikTok Shop với omniVN

Có thể kết nối

Kết nối TikTok Shop (đơn hàng) qua OAuth từ trang Integrations. Shop ≠ Ads — hướng dẫn này không gồm TikTok Ads.

Kết nối TikTok ShopTạo tài khoản và làm theo hướng dẫn bên dưới — dùng thử 14 ngày.

Cổng sẵn sàng: Connect Commerce chỉ bật khi deployment có TIKTOK_SHOP_* + secret store + redirect khớp. Không dán token; OAuth redirect là đường kết nối chính.

Giới hạn hiện tại

Những điểm này ảnh hưởng đến khả năng kết nối hoàn chỉnh.
  • Hướng dẫn này chỉ cho TikTok Shop. TikTok Ads (insights) là connector/OAuth riêng — Shop ≠ Ads.
  • Sản phẩm/tồn kho TikTok Shop chưa được pull (chỉ orders).
  • Production cần vault/secret-manager resolver; local-env chỉ dùng development.

Tổng quan

TikTok Shop dùng OAuth 2.0 trên TikTok Shop Partner Portal (app_key/app_secret do Omni0 vận hành). Seller nhấn Connect Commerce, đăng nhập TikTok Shop và cấp quyền; Omni0 đổi auth_code lấy shop access token phía máy chủ. TikTok Ads (insights) là kết nối riêng tại Integrations → TikTok Ads — không gộp trong hướng dẫn này.

Điều kiện trước khi bắt đầu

  • Tài khoản TikTok Shop Seller đang hoạt động.
  • Omni0 đã đăng ký TTS App trên TikTok Shop Partner Portal (operator).
  • Deployment Convex có TIKTOK_SHOP_APP_KEY / TIKTOK_SHOP_APP_SECRET, secret store, và redirect URI /connectors/tiktok-shop/callback.
  • Trong Omni0: quyền kết nối kênh trên workspace (channels.connect).

Các bước lấy credential

1. Omni0 đăng ký app TikTok Shop

Operator Omni0 tạo TTS App / OAuth Client trên partner.tiktokshop.com để nhận app_key và app_secret. Redirect URI: https://<deployment>.convex.site/connectors/tiktok-shop/callback. Credential app do Omni0 giữ — seller không dán app_key/secret.

2. Mở TikTok Shop trong Omni0 và nhấn Connect Commerce

Vào Integrations → TikTok Shop. Nhấn Connect Commerce — Omni0 mở OAuth TikTok Shop (redirect). Không dán Access-Token hay shop_id thủ công. Giữ tab Omni0 mở đến khi kết nối xuất hiện.

3. Đăng nhập TikTok Shop và cấp quyền

Đăng nhập tài khoản seller, chọn shop và scope đơn hàng. TikTok trả auth_code về callback Omni0; backend đổi code lấy access token và lưu secret store.

Ánh xạ credential với omniVN

Cột "Lấy từ đâu" cho biết giá trị do người dùng nhập, do provider cấp, do omniVN quản lý, hay do OAuth sinh ra.
Field omniVNTên trong tài liệu officialBắt buộcLấy từ đâu
TikTok Shop App Keyapp_keyBắt buộcoperator_managed

Do Omni0 đăng ký app TikTok Shop.

TikTok Shop App Secretapp_secretBắt buộcoperator_managed
TikTok Shop Access Tokenaccess_tokenBắt buộcoauth_authorization

Lấy từ auth_code sau khi seller cấp quyền OAuth.

TikTok Shop IDshop_idBắt buộcoauth_authorization

Có sau OAuth; không dán tay trên form.

shopAppKey → TIKTOK_SHOP_APP_KEY (Convex env, Omni0); shopAppSecret → TIKTOK_SHOP_APP_SECRET (Convex env, Omni0); shopAccessToken / shopId → secret store sau OAuth (không nhập tay trên form).

Vòng đời token

TikTok Shop access token ~7 ngày; Omni0 refresh bằng refresh_token trước pull. Thu hồi quyền hoặc hết hạn → connection báo reauthorization_required, cần Connect Commerce lại. Không dùng token dán tay.

Lỗi thường gặp

Connect báo PROVIDER_CONFIGURATION_INVALID hoặc nút chưa sẵn sàng

Thiếu TIKTOK_SHOP_APP_KEY/SECRET trên Convex, secret store chưa sẵn, hoặc redirect URI chưa khớp portal. Liên hệ operator — không dán token để vượt qua.

Lỗi invalid auth_code

auth_code hết hạn (~30 phút), redirect_uri không khớp portal, hoặc app_key/app_secret sai.

Nguồn chính thức

TikTok Shop Authorization Overview
partner.tiktokshop.com·Cần render JS·Đã kiểm chứng 2026-08-29
Create a TTS App / OAuth Client
partner.tiktokshop.com·Cần render JS·Đã kiểm chứng 2026-08-29
Generate test access token
partner.tiktokshop.com·Cần render JS·Đã kiểm chứng 2026-08-29