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

Kết nối Shopee với omniVN

Có thể kết nối

Connect qua seller OAuth trên BeeKrowd platform Partner. Connected chỉ khi có shop token + shop_id. Không dán partner key trên UI.

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

connectable: platform Partner OAuth. Connected = shop token + shop_id.

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.
  • Không dán credential trên UI để vượt cổng. Không invent spend/ROAS.

Tổng quan

Shopee Open Platform dùng OAuth 2.0. partner_id / partner_key thuộc Partner app trên Convex (SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY). Seller ủy quyền cửa hàng để lấy shop_id + access_token. Connect không dùng orgAdsByoAppConfigs hay operatorSealShopeePartner. Empty/error ≠ Connected; không invent Ads spend / ROAS.

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

    Các bước lấy credential

    1. Kết nối qua OAuth

    Bấm Connect để mở trang ủy quyền Shopee seller. Sau khi ủy quyền, Omni0 đổi code lấy shop token + shop_id và seal vào secretRef. Không dán partner_id, partner_key, shop_id hay access_token trên form. Connected = shop token + shop_id trong secretRef.

    Á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
    Partner IDpartner_idBắt buộcoperator_managed

    Convex env SHOPEE_PARTNER_ID. Not pasted on Connect UI.

    API Partner Keypartner_key / api_partner_keyBắt buộcoperator_managed

    Convex env SHOPEE_PARTNER_KEY or SHOPEE_API_PARTNER_KEY. Not pasted on Connect UI.

    Shop IDshop_idBắt buộcoauth_authorization

    Bắt buộc cho Connected (cùng accessToken). Partner alone không đủ.

    Access Tokenaccess_tokenBắt buộcoauth_authorization

    Shop token trong secretRef. Connected = shop token + shop_id; empty/error ≠ Connected.

    partnerId / partnerKey → Convex env SHOPEE_PARTNER_ID + SHOPEE_PARTNER_KEY (hoặc SHOPEE_API_PARTNER_KEY). shopId / accessToken → shop seal từ OAuth callback; bắt buộc cho Connected.

    Vòng đời token

    Theo tài liệu Shopee, access_token có hạn (thường kèm refresh_token). Pull/HMAC đọc partner đã copy vào connection secretRef.

    Lỗi thường gặp

    Connect báo PROVIDER_CONFIGURATION_INVALID

    Convex thiếu SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY (hoặc SHOPEE_API_PARTNER_KEY), hoặc OAUTH_CALLBACK_BASE_URL. Administrator set trên Convex rồi reload. Đừng dán partner key trên UI.

    UI không Connected sau OAuth

    Cần shop token + shop_id (seal secret_ref + externalAccountId). Empty/error rows không được sơn Connected.

    Nguồn chính thức

    Shopee Open Platform - Authorization Guide
    open.shopee.com·Cần render JS·Đã kiểm chứng 2026-08-29
    Shopee Open API - get_access_token
    open.shopee.com·Cần render JS·Đã kiểm chứng 2026-08-29