Shopify、Amazon、TikTok ショップ

Shopify

Shopify ストアを接続して商品データをキャンペーンに取り込み、履行された注文をロイヤルティ ポイントに変換します。コードは不要で、ストア ドメインと管理者 API アクセス トークンだけが必要です。

// What the platform exposes for the Online Shop connection:
POST /api/shopify/connect      { "shopDomain": "my-store.myshopify.com", "accessToken": "shpat_…" }
GET  /api/shopify/status       // → { connected, shopDomain, status, lastSyncedAt, productCount, apiVersion }
POST /api/shopify/sync         // pull products now
POST /api/shopify/disconnect   // remove the connection + synced product data
//
// Orders: SocialHub receives Shopify order webhooks (order.fulfilled) and awards points
// keyed by the order id — idempotent, so a replayed webhook never double-awards.
// Connecting an Online Shop requires the Omnichannel plan.

TikTokショップ

TikTok ショップ パートナー API に対して、Amazon と同じ「検証してはいけない」モデル。ショップ上の TikTok ショップ パートナー アプリを承認して、アプリ キー / アプリ シークレットおよび更新トークンを取得します。 [設定] → [オンライン ショップ] → [TikTok ショップ] (チーム管理者とシステム管理者) で設定します。

接続設定

シークレット (保存時暗号化・書き込み専用)

[ショップ暗号] を空白のままにします — 保存して認証ショップから検出されたことを確認します。 TikTok は更新のたびにリフレッシュ トークンをローテーションします。プラットフォームはローテーションをシリアル化して永続化するため、同時ジョブが互いに無効になることはありません。

// Marketplace credentials (Amazon / TikTok Shop) are saved + liveness-checked here.
// Open to team admins (org_owner / org_admin) and system admins; tenant-isolated —
// an admin can only ever read/write their OWN team's channels.
POST /api/admin/channels            { teamId, kind: "amazon" | "tiktok", name, config, secrets }
POST /api/admin/channels/{id}/ping  // re-verify the connection (discovers shop refs / cipher)
//
// Secrets (refresh_token, client_secret, app_secret, …) are AES-GCM encrypted the
// instant they arrive — write-only, never returned, never logged.