WooCommerce 集成
将 WooCommerce 商店连接到 Frevana,即可查看产品、订单、客户、优惠券和库存。本指南将帮助您创建凭据并检查连接。
开始之前
请确保您具备:
- 安装了 WooCommerce 的 WordPress 网站。
- WordPress 管理后台的管理员权限。
- 创建 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§ion=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§ion=keys
密钥无法使用
请检查商店 URL 是否正确、密钥是否以 ck_ 开头、密钥的 secret 是否以 cs_ 开头、权限是否满足操作需要(报告使用 Read,修改使用 Read/Write)、所选用户是否为管理员,以及 WooCommerce 是否已安装并启用。
丢失 Consumer Secret
请创建新的 API 密钥。离开密钥创建页面后,WooCommerce 通常不会再次显示完整 secret。
商店未使用 HTTPS
正式商店应使用 HTTPS。本地测试商店可以使用 HTTP,但真实商店建议使用 HTTPS。