
WooCommerce 连接器
兼容 WooCommerce
将 WooCommerce 连接到 FreeScout,以便对话显示匹配的客户订单和购买上下文。连接器直接与 WooCommerce REST API 通信,因此无需安装商店端插件。ReplyRabbit 还将产品所有权上下文馈送到 AI 层,以便草稿可以引用客户购买的内容。
在找概览?
概览
WooCommerce 连接器为 FreeScout 对话添加订单侧边栏。当对话包含客户电子邮件地址时,连接器会查询 WooCommerce REST API(wc/v3)在你的商店中匹配订单,并将其显示在对话旁边。
侧边栏显示客户面板、完整订单历史、每笔订单的含数量和价格的订单项、财务总计、客户终身价值(CLV)、平均订单价值(AOV)以及产品所有权权益,这些信息会流入 ReplyRabbit AI 上下文,以生成更相关的草稿。
需要安装一个组件: FreeScout WooCommerce 连接器模块。它使用消费者密钥和密钥通过 HTTPS 读取 WooCommerce REST API,然后渲染订单侧边栏。它在 FreeScout 中有自己的按邮箱设置页面。
订单侧边栏独立工作。流入 AI 草稿的产品所有权权益是使用 ReplyRabbit 的部分。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- 一个可通过 HTTPS 访问的 WooCommerce 商店,并具有创建 REST API 密钥的管理员访问权限。
- 一个未启用全站 Basic HTTP Authentication 的商店,因为这会与 REST API 身份验证标头冲突。
- 如果你希望在 AI 草稿中获得产品归属上下文,请安装并激活 ReplyRabbit。
- 一个 WooCommerce Connector 许可证(18 EUR 一次性,适用于一个 FreeScout 安装),或一个有效的 ReplyRabbit Pro 或 Team 套餐,其中包含该许可证。
如果尚未安装 ReplyRabbit,请从以下开始 如何安装 ReplyRabbit 模块,然后完成 如何设置 ReplyRabbit.
生成 WooCommerce REST API 密钥
连接器使用 WooCommerce REST API 密钥进行身份验证,该密钥由消费者密钥和消费者密钥组成。在 WordPress 管理后台中创建密钥。
打开 REST API 设置
在 WordPress 管理员中,转到 WooCommerce,然后 设置,然后 高级,然后 REST API.添加密钥
点击 添加密钥。输入描述,例如"ReplyRabbit Connector",设置 权限 到 读取,然后点击 生成 API 密钥.复制消费者密钥和密钥
复制 消费者密钥 和 消费者密钥。WooCommerce 只显示一次密钥,因此在离开页面之前,请将这两个值保存在安全的地方。
只读访问权限
安装 FreeScout 连接器模块
FreeScout WooCommerce 连接器模块查询 WooCommerce REST API 并在对话中呈现订单侧边栏。它是独立模块,有自己的设置,与 ReplyRabbit 分开。
下载连接器模块
登录于 app.replyrabbit.app 以下载 FreeScout 连接器模块 ZIP。购买连接器或持有有效的 ReplyRabbit Pro 或 Team 计划后,下载会出现。上传到 FreeScout
在 FreeScout 中,转到 模块,点击上传按钮,选择 ZIP 文件,然后安装。激活模块
激活 WooCommerce 从模块列表中的模块。
按邮箱配置
安装模块后,在连接器自己的每邮箱设置页面中将其连接到您的商店。
打开连接器设置
在 FreeScout 中,打开应显示 WooCommerce 订单数据的邮箱,打开邮箱设置菜单,然后选择 商店连接器。这是 WooCommerce 连接器的设置页面,而不是 ReplyRabbit 设置中的一部分。输入商店 URL
通过 HTTPS 粘贴您的 WooCommerce 商店基础 URL,例如https://your-store.com。不需要尾部斜杠。输入消费者密钥和密钥
粘贴 消费者密钥 和 消费者密钥 您在 WooCommerce 中生成的。它们会被加密存储,保存后仅显示掩码预览。添加您的连接器许可证密钥
如果你购买了连接器,请输入其许可证密钥。如果有效的 ReplyRabbit Pro 或 Team 套餐涵盖安装,请跳过此步骤。保存并测试
保存设置。打开客户电子邮件与 WooCommerce 订单匹配的 FreeScout 对话,并确认订单侧边栏出现。
每个 FreeScout 邮箱存储自己的商店 URL 和 REST API 密钥,因此您可以将不同的邮箱连接到不同的 WooCommerce 商店。
连接器显示什么
- 一个面向对话中相关人员的客户面板。
- 包含订单号、日期、状态和总额的完整订单历史。
- 按订单的行项目,包含数量和价格。
- 财务总计(小计、折扣、运费、税费、退款)。
- 客户终身价值(CLV)和平均订单价值(AOV)。
- 用于 AI 草稿的产品所有权权益。
如何获取连接器
WooCommerce 连接器是付费模块。您可以通过两种方式获取:
- 以 18 EUR 购买 WooCommerce Connector,作为单个 FreeScout 安装的一次性许可证,然后将其许可证密钥粘贴到连接器设置中。
- 使用有效的 ReplyRabbit Pro 或 Team 计划,其中包含连接器且无需额外费用。
从你的账户购买许可证或下载连接器 ReplyRabbit 仪表板。访问 定价页面 了解 ReplyRabbit 计划选项。如果活跃的 ReplyRabbit Pro 或 Team 计划涵盖该安装,则连接器在配置后即可工作,无需单独的许可证密钥。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 订单侧边栏未出现 | 确认连接器设置中的商店 URL、消费者密钥和消费者密钥正确,并且邮箱面板已启用。 |
| "连接被拒绝"或超时错误 | 检查 FreeScout 服务器能否通过 HTTPS 访问您的商店 URL。防火墙、IP 允许列表或维护模式可能会阻止该请求。 |
| 商店 URL 被拒绝 | 商店必须通过 HTTPS 提供服务。纯 http:// URL 或无法访问的主机被拒绝。 |
| 身份验证失败 | 确认商店未启用全站基本 HTTP 身份验证,该验证会在 WooCommerce 看到 REST API 身份验证标头之前将其拦截。 |
| 消费者密钥或密钥被拒绝 | 在以下位置重新生成 WooCommerce 密钥 设置,然后 高级,然后 REST API,与 读取 权限,并将新的消费者密钥和密钥粘贴到连接器设置中。 |
| 已知客户的订单为空 | 确认 FreeScout 对话上的客户电子邮件与其 WooCommerce 订单上的账单电子邮件匹配。 |
| 行项目、财务数据或 CLV 未显示 | 确认连接器许可证密钥已保存,或者有效的 ReplyRabbit Pro 或 Team 套餐覆盖该安装。 |
| 产品所有权上下文未出现在草稿中 | 确认连接器已授权、ReplyRabbit 已安装、连接器正在返回订单,并且该邮箱已启用 AI 上下文功能。 |
对于更广泛的问题,请参阅 ReplyRabbit 故障排除.
隐私和数据处理
当连接器查询 WooCommerce 时,它会通过 HTTPS 将客户电子邮件地址发送到你自己的 WooCommerce REST API。从你的商店返回的订单数据会填充 FreeScout 侧边栏,并与 ReplyRabbit 一起构建草稿的 AI 上下文。
REST API 密钥只需要 读取 权限,因此连接器绝不会写入你的商店。消费者密钥和密钥在 FreeScout 中加密存储,出站请求会验证 TLS 且不跟随重定向。
除通过为邮箱选择的 AI 提供商外,不会将 WooCommerce 订单数据发送给第三方,且仅在 AI 上下文功能使用它时。如果您的政策要求订单数据完全保留在自己的服务器上,请为邮箱使用本地 AI 提供商(例如 Ollama)。
后续步骤
- 完成 如何设置 ReplyRabbit 如果邮箱仍需要提供商、上下文或风格设置。
- 参见 如何安装 ReplyRabbit 模块 如果您尚未安装 ReplyRabbit。
常见问题
WooCommerce 连接器需要 WordPress 插件吗?
不需要。连接器直接与 WooCommerce REST API 通信。你在 WooCommerce 中生成 REST API 密钥,并在 FreeScout 连接器中输入商店 URL、消费者密钥和消费者密钥密码。只有一个下载项,即 FreeScout WooCommerce 连接器模块。
WooCommerce 连接器费用是多少?
WooCommerce 连接器包含在有效的 ReplyRabbit Pro 或 Team 套餐中。否则,作为一次性许可证,一个 FreeScout 安装的费用为 18 欧元。如果购买,请将其许可证密钥粘贴到连接器设置中。
连接器如何匹配客户?
连接器通过 FreeScout 对话上的客户电子邮件地址查找 WooCommerce 订单。对于产品所有权,它还会检查关联的电子邮件,并作为尽力而为的回退,检查同一电子邮件域上的其他已付款订单。
REST API 密钥需要什么权限?
只读。连接器从不写入你的商店,因此具有读取权限的密钥就足够了。
每个 FreeScout 邮箱可以连接不同的 WooCommerce 商店吗?
是的。每个邮箱都在连接器设置中存储自己的商店 URL 和 REST API 密钥,因此不同的商店可以连接到不同的邮箱。