WooCommerce 接入

把 WooCommerce 网店接到桌面客户端后，可在「渠道 → WooCommerce → 商品」里浏览商品列表，点进单条查看完整商品详情（名称、描述、价格、图片、属性、库存等）。后续如需配合 AI 自动化生成社媒素材，会以这里的商品数据为准；当前版本只做连接与查看，不预设发布格式。

绑定方式：在 WordPress / WooCommerce 后台生成 REST API 密钥，粘贴到客户端。

你需要准备什么

条件	说明
桌面客户端	已安装并登录
WooCommerce 站点	已安装 WooCommerce 的 WordPress 站点，且你能登录 WordPress 管理员
HTTPS	站点建议使用 HTTPS；WooCommerce REST API 在多数环境下要求安全连接
网络	客户端所在网络需能访问你的店铺 URL

当前能力范围

• ✅ 账号授权：绑定店铺
• ✅ 商品：列表 + 单商品完整详情
• ⏳ 发帖 / 自动发布到社媒：尚未在本版本定死，后续按需求扩展

第一步：在 WooCommerce 生成 REST API 密钥

1. 登录 WordPress 后台。
2. 进入 WooCommerce → 设置（Settings）→ 高级（Advanced）→ REST API（部分版本在 WooCommerce → 设置 → 高级 → 旧版 API 附近，以你后台为准）。
3. 点击 添加密钥（Add key）。
4. 填写说明（如 AutoAI 商品同步），用户选 管理员 或具备商品读取权限的用户。
5. 权限选择 读取（Read） 即可（当前只需拉取商品；若以后有写入需求再另行调整）。
6. 保存后会显示 Consumer key 与 Consumer secret——Secret 通常只显示一次，请立即复制保存。

同时记下店铺 根 URL，例如：

https://your-store.com

不要带 /wp-json/... 后缀；客户端会自动访问 https://your-store.com/wp-json/wc/v3/...。

请妥善保管密钥

Consumer key / secret 可读取店铺数据，不要外泄。泄露后请在 WooCommerce 后台删除该密钥并重新创建。

若 REST API 无法访问

• 确认站点已启用 固定链接（Permalinks），且不是「朴素」模式导致 REST 路由异常（WordPress 设置 → 固定链接 选「文章名」等常见选项后保存）。
• 确认没有安全插件拦截 /wp-json/wc/v3/（必要时将客户端出口 IP 加入白名单，或联系站点运维）。
• 确认 WooCommerce 版本较新，REST API 功能正常（可在浏览器访问 https://你的域名/wp-json/wc/v3/products?per_page=1 测试，需认证时会返回 401 而非 404）。

第二步：在客户端绑定

1. 打开桌面客户端，左侧点 渠道。
2. 在 电商店铺 分组中选 WooCommerce。
3. 确认顶部在 账号授权。
4. 点击 连接 WooCommerce 店铺。
5. 在弹窗中填写：
   • 店铺 URL（必填）：如 https://your-store.com
   • Consumer Key（必填）
   • Consumer Secret（必填）
6. 确认后，「已连接资产」中应出现该店铺；没有的话点刷新。

绑定成功后，客户端会尝试读取一条商品以验证密钥；失败时请检查 URL、密钥与站点 HTTPS / 防火墙设置。

第三步：查看商品列表与详情

1. 切换到 商品 Tab。
2. 在顶栏选择要查看的店铺（若只绑了一个会自动选中）。
3. 浏览商品列表；点击某商品可在右侧查看完整 JSON 详情（含 images、attributes、variations 关联字段等，以 WooCommerce 返回为准）。
4. 列表底部可 加载更多。

关于详情展示形式

当前以完整 API 响应展示，便于核对与后续自动化；不会要求你现在选择社媒文案模板或发布渠道。

常见问题

绑定失败 / WooCommerce verify failed

• URL 是否以 https:// 开头且能公网访问。
• Key / Secret 是否成对、是否有多余空格。
• 密钥权限是否为 Read 且未在后台被删除。
• 服务器是否拦截 REST API 或要求额外 Basic Auth（本客户端使用 WooCommerce 标准 key/secret 认证）。

商品 Tab 为空

• WooCommerce 后台是否已有商品（含草稿/私密等状态，列表默认以 API 返回为准）。
• 是否选对了店铺 Chip。
• 点刷新；仍为空请联系客服（可提供店铺 URL，勿发送 Consumer Secret）。

多站点 / 子目录安装

• 若 WordPress 装在子路径（如 https://example.com/shop/），店铺 URL 填该 WordPress 站点根路径（含 /shop），不要只填主域名。

如何断开？

• 在 账号授权 对资产执行断开。断开后 REST 密钥仍留在 WooCommerce 后台，如需彻底作废请在 WordPress 里删除该 API 密钥。

相关链接

• Shopify 接入
• 快速上手
• 在线客服