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 形式，不是自定义域名 alone）。
• 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 接入
• 快速上手
• 在线客服