跳到主要内容

WooCommerce 集成

将 WooCommerce 商店连接到 Frevana,即可查看产品、订单、客户、优惠券和库存。本指南将帮助您创建凭据并检查连接。

开始之前​

请确保您具备:

  1. 安装了 WooCommerce 的 WordPress 网站。
  2. WordPress 管理后台的管理员权限。
  3. 创建 WooCommerce REST API 密钥的权限。

第 1 步:打开 WooCommerce REST API 设置​

登录 WordPress 管理后台,然后进入:

WooCommerce -> Settings -> Advanced -> REST API
注意

请进入 WooCommerce 中的 Settings,不要使用普通的 WordPress Settings 页面。

如果找不到菜单,可以直接打开以下地址,并将 your-store.com 替换为商店域名:

https://your-store.com/wp-admin/admin.php?page=wc-settings&tab=advanced&section=keys

第 2 步:创建 REST API 密钥​

选择 Add key 并填写表单:

字段输入内容
Description例如 Frevana WooCommerce agent team。
User选择管理员用户。
Permissions报告使用 Read;如需支持的修改操作,使用 Read/Write。

然后选择 Generate API key。

第 3 步:复制凭据​

WooCommerce 将显示以下两个值:

Consumer key
Consumer secret

请立即复制。WooCommerce 通常只显示一次完整的 Consumer secret;如果离开页面前没有复制,可能需要删除密钥并创建新密钥。

第 4 步:提供连接信息​

向 Frevana 提供以下三个值:

store_url: https://your-store.com
consumer_key: ck_...
consumer_secret: cs_...

store_url 使用商店的主网址,例如 https://example.com,不要包含 /wp-admin 或 /wp-json。

第 5 步:验证连接​

提供凭据后,Frevana 将调用 WooCommerce REST API 验证连接。连接成功后,Frevana 可以帮助您:

  • 列出产品。
  • 检查库存及缺货产品。
  • 读取近期订单。
  • 汇总收入。
  • 查找客户。
  • 经确认后创建折扣码。
  • 检测缺少收货地址的处理中订单。

权限​

如果希望 Frevana 创建优惠券、更新产品或修正订单收货地址,请使用 Read/Write。如果只需要分析和报告,不执行写入操作,请使用 Read。

Frevana 会在执行写入操作前提供预览;只有在您明确确认后才会执行。

故障排查​

Advanced 下没有 REST API​

请确认您位于 WooCommerce -> Settings -> Advanced,而不是 WordPress Settings。也可以直接打开:

https://your-store.com/wp-admin/admin.php?page=wc-settings&tab=advanced&section=keys

密钥无法使用​

请检查商店 URL 是否正确、密钥是否以 ck_ 开头、密钥的 secret 是否以 cs_ 开头、权限是否满足操作需要(报告使用 Read,修改使用 Read/Write)、所选用户是否为管理员,以及 WooCommerce 是否已安装并启用。

丢失 Consumer Secret​

请创建新的 API 密钥。离开密钥创建页面后,WooCommerce 通常不会再次显示完整 secret。

商店未使用 HTTPS​

正式商店应使用 HTTPS。本地测试商店可以使用 HTTP,但真实商店建议使用 HTTPS。