Shopify 接入

把 Shopify 店鋪接到桌面用戶端後，可在「渠道 → Shopify → 商品」裡瀏覽店鋪商品列表，點進單條查看完整商品詳情（標題、描述、規格、圖片、庫存等）。後續如需配合 AI 自動化生成社媒素材，會以這裡的商品資料為準；目前版本只做連接與查看，不預設發布格式。

綁定方式：在 Shopify 後台建立 Admin API 存取權杖，貼到用戶端（無需 OAuth 掃碼）。

你需要準備什麼

條件	說明
桌面用戶端	已安裝並登入
Shopify 店鋪	已有可登入的 Shopify 店鋪，且你是店鋪管理員或有權建立自訂應用
網路	用戶端需能存取 *.myshopify.com 的 Admin API

目前能力範圍

• ✅ 帳號授權：綁定店鋪
• ✅ 商品：列表 + 單商品完整詳情
• ⏳ 發帖 / 自動發布到社媒：尚未在本版本定死，後續按需求擴展

第一步：在 Shopify 建立 Admin API 存取權杖

以下步驟以 Shopify 管理後台為準，選單名稱可能隨版本略有差異：

1. 登入 Shopify 管理後台。
2. 進入 設定（Settings）→ 應用和銷售管道（Apps and sales channels）。
3. 點擊 開發應用（Develop apps）；若首次使用，按提示啟用自訂應用開發。
4. 建立應用，名稱可填例如 AutoAI 商品同步。
5. 開啟該應用的 設定 Admin API 範圍（Configure Admin API scopes），至少勾選與讀取商品相關的權限，例如：
   • read_products（讀取商品）
   • 若需讀取庫存、變體等，可按需勾選 read_inventory 等（以你店鋪實際需要為準）
6. 儲存 後 安裝應用（Install app）。
7. 在 API 憑證（API credentials） 中點擊 顯示權杖（Reveal token once），複製 Admin API access token（只顯示一次，請立即儲存到密碼管理器）。

同時記下你的 店鋪網域，格式通常為：

your-store.myshopify.com

請妥善保管權杖

Admin API access token 等同於店鋪後台的高權限金鑰，不要發給無關人員、不要貼到公開群或截圖外傳。洩漏後請在 Shopify 後台撤銷並重新產生。

第二步：在用戶端綁定

1. 開啟桌面用戶端，左側點 渠道。
2. 在 電商店鋪 分組中選 Shopify。
3. 確認頂部在 帳號授權。
4. 點擊 連接 Shopify 店鋪。
5. 在彈窗中填寫：
   • 店鋪網域（必填）：如 your-store.myshopify.com（可只填 your-store，用戶端會自動補全 .myshopify.com）
   • Admin API 存取權杖（必填）：上一步複製的 token
6. 確認後，「已連接資產」中應出現該店鋪名稱；沒有的話點重新整理。

綁定成功後，用戶端會校驗權杖能否讀取店鋪資訊；失敗時請檢查網域、權杖是否複製完整，以及 API 範圍是否包含 read_products。

第三步：查看商品列表與詳情

1. 仍在 Shopify 渠道頁，切換到 商品 Tab。
2. 若綁定了多個店鋪，在頂欄 Chip 中選擇目標店鋪。
3. 列表展示商品縮圖、標題與狀態等摘要資訊；支援 載入更多 分頁。
4. 點擊某一行，右側展開該商品的完整 API 詳情（含 variants、images、options 等欄位），便於核對資料是否齊全。

關於詳情展示形式

目前以結構化 JSON 展示完整欄位，方便後續自動化讀取；不會在本步驟要求你選擇「發到 Facebook / Instagram 的文案模板」。

常見問題

綁定失敗 / 提示 Shopify verify failed

• 店鋪網域是否正確（必須是 .myshopify.com 形式，不是僅填自訂網域）。
• Access token 是否完整複製、是否已過期或被撤銷。
• 應用是否已 Install，且 Admin API scopes 包含 read_products。

商品 Tab 為空

• 店鋪後台是否確有已發布 / 草稿商品（以 Shopify 後台為準）。
• 是否選對了頂欄店鋪 Chip。
• 點 重新整理 重試；仍為空請聯絡客服並說明店鋪網域（勿傳送 token）。

自訂網域（如 www.example.com）能否填在「店鋪網域」？

• Admin API 請求需使用 xxx.myshopify.com。請在 Shopify 設定 → 網域 中查看「Shopify 管理的網域」，填該 myshopify.com 位址。

如何斷開？

• 在 帳號授權 頁對已連接店鋪執行斷開 / 解綁。斷開後需在客戶端重新填寫權杖才能再看商品。

相關連結

• WooCommerce 接入
• 快速上手
• 線上客服