Shopify 连接器
兼容 Shopify
将 Shopify 连接到 FreeScout,以便对话显示匹配的客户订单和购买上下文。你在 Shopify 管理员中创建一个只读自定义应用,并将其访问令牌粘贴到 FreeScout 中,因此不涉及合作伙伴账户或应用审核。ReplyRabbit 还将产品所有权上下文馈送到 AI 层,以便草稿可以引用客户购买的内容。
在找概览?
概览
Shopify 连接器为 FreeScout 对话添加订单侧边栏。当对话有客户电子邮件地址时,连接器在你的商店上查询 Shopify GraphQL Admin API 以获取匹配的订单,并在对话旁显示它们。
侧边栏显示客户面板、完整订单历史、每笔订单的含数量和价格的订单项、财务总计、客户终身价值(CLV)、平均订单价值(AOV)以及产品所有权权益,这些信息会流入 ReplyRabbit AI 上下文,以生成更相关的草稿。
需要安装一个组件: FreeScout Shopify 连接器模块。它使用来自自定义应用的 Admin API 访问令牌通过 HTTPS 读取 Shopify GraphQL Admin API,然后渲染订单侧边栏。它在 FreeScout 中有自己的按邮箱设置页面。
订单侧边栏独立工作。流入 AI 草稿的产品所有权权益是使用 ReplyRabbit 的部分。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- 一个位于以下平台的 Shopify 商店
your-store.myshopify.com域(或映射到它的自定义域),并具有开发应用的工作人员权限。 - 如果你希望在 AI 草稿中获得产品归属上下文,请安装并激活 ReplyRabbit。
- 一个 Shopify Connector 许可证(18 EUR 一次性,适用于一个 FreeScout 安装),或一个有效的 ReplyRabbit Pro 或 Team 套餐,其中包含该许可证。
如果尚未安装 ReplyRabbit,请从以下开始 如何安装 ReplyRabbit 模块,然后完成 如何设置 ReplyRabbit.
在 Shopify 中创建自定义应用
连接器使用来自您自己商店内自定义应用的管理 API 访问令牌进行身份验证。
打开“开发应用”
在 Shopify 管理员中,转到 设置,然后 应用和销售渠道,然后 开发应用。如果出现提示,请允许自定义应用开发。创建应用
点击 创建应用,将其命名为"ReplyRabbit Connector",然后创建它。设置 Admin API 作用域
打开 配置 Admin API 范围 并勾选read_customers,read_orders,以及read_products。勾选read_all_orders如果你想要超过 60 天的订单历史,也需要。保存。安装并复制令牌
点击 安装应用,然后 一次性显示 token 并复制 管理员 API 访问令牌 (它以shpat_)。Shopify 只显示一次,请将其保存在安全的地方。
只读访问权限
安装 FreeScout 连接器模块
下载连接器模块
从以下位置下载 FreeScout 连接器模块 ZIP ReplyRabbit 仪表板。购买连接器或持有有效的 ReplyRabbit Pro 或团队版套餐后,下载就会出现。上传到 FreeScout
在 FreeScout 中,转到 模块,点击上传按钮,选择 ZIP 文件,然后安装。激活模块
激活 Shopify 集成 从模块列表中的模块。
按邮箱配置
打开连接器设置
在 FreeScout 中,打开应显示 Shopify 订单数据的邮箱,打开邮箱设置菜单,然后选择 商店连接器。这是 Shopify 连接器的设置页面,而不是 ReplyRabbit 设置中的一部分。输入商店域名和访问令牌
输入你的商店域名,例如your-store.myshopify.com,然后粘贴 Admin API 访问令牌。保存。连接器会在存储之前根据你的商店检查令牌和权限范围;令牌会加密存储,且不再显示。添加您的连接器许可证密钥
如果你购买了连接器,请设置SHOPIFYINTEGRATION_LICENSE_KEY在您的 FreeScout 中.env到其许可证密钥。如果有效的 ReplyRabbit Pro 或 Team 计划覆盖该安装,请跳过此步骤。测试
打开一个客户邮箱与 Shopify 订单匹配的 FreeScout 对话,确认订单侧边栏出现。
每个 FreeScout 邮箱存储自己的商店域名和访问令牌,因此您可以将不同的邮箱连接到不同的商店。
连接器显示什么
- 一个面向对话中相关人员的客户面板。
- 包含订单号、日期、状态和总额的完整订单历史。
- 按订单的行项目,包含数量和价格。
- 财务总计(小计、折扣、运费、税费、退款)。
- 客户终身价值(CLV)和平均订单价值(AOV)。
- 用于 AI 草稿的产品所有权权益。
如何获取连接器
Shopify 连接器是付费模块。你可以通过两种方式获取:
- 以 18 EUR 购买 Shopify Connector,作为单个 FreeScout 安装的一次性许可证,然后将其许可证密钥设置为
SHOPIFYINTEGRATION_LICENSE_KEY在 FreeScout 中.env. - 使用有效的 ReplyRabbit Pro 或 Team 计划,其中包含连接器且无需额外费用。
从你的账户购买许可证或下载连接器 ReplyRabbit 仪表板。访问 定价页面 了解 ReplyRabbit 计划选项。如果活跃的 ReplyRabbit Pro 或 Team 计划涵盖该安装,则连接器在配置后即可工作,无需单独的许可证密钥。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 保存时提示"Shopify 拒绝了该连接" | 令牌输入错误、已被撤销或属于其他商店。通过重新安装自定义应用来显示新令牌,并再次粘贴。 |
| 保存时提示"缺少这些 Admin API 权限范围" | 打开自定义应用,在下方添加缺失的权限范围 配置 Admin API 范围,保存,然后重新安装应用。重新安装会签发新令牌。 |
| 商店域被拒绝 | 使用 your-store.myshopify.com 域,或映射到它的自定义域。私有主机和 IP 地址会被拒绝。 |
| 订单侧边栏未出现 | 确认邮箱面板已启用,并且连接在设置页面显示为已连接。 |
| 已知客户的订单为空 | 确认 FreeScout 对话上的客户电子邮件与其 Shopify 订单上的电子邮件匹配。 |
| 仅显示最近 60 天的订单 | 添加 read_all_orders 范围限定到自定义应用,重新安装它,并粘贴新令牌。 |
| 行项目、财务数据或 CLV 未显示 | 确认连接器许可证密钥已保存,或者有效的 ReplyRabbit Pro 或 Team 套餐覆盖该安装。 |
| 产品所有权上下文未出现在草稿中 | 确认连接器已授权、ReplyRabbit 已安装、连接器正在返回订单,并且该邮箱已启用 AI 上下文功能。 |
对于更广泛的问题,请参阅 ReplyRabbit 故障排除.
隐私和数据处理
当连接器查询 Shopify 时,它会使用你自定义应用的令牌,通过 HTTPS 将客户电子邮件地址发送到 Shopify GraphQL Admin API。从你的商店返回的订单数据会填充 FreeScout 侧边栏,并与 ReplyRabbit 一起构建草稿的 AI 上下文。
自定义应用仅具有读取范围,因此连接器从不写入您的商店。访问令牌在 FreeScout 中加密存储,出站请求验证 TLS 并且不跟随重定向。
除通过为邮箱选择的 AI 提供商外,不会将 Shopify 订单数据发送给第三方,且仅在 AI 上下文功能使用它时。如果您的政策要求订单数据完全保留在自己的服务器上,请为邮箱使用本地 AI 提供商(例如 Ollama)。
后续步骤
- 完成 如何设置 ReplyRabbit 如果邮箱仍需要提供商、上下文或风格设置。
- 也在使用 WooCommerce 或 Magento?请参阅 WooCommerce 连接器 和 Magento 连接器 指南。
常见问题
Shopify 连接器如何连接到我的商店?
使用你在 Shopify 管理后台创建的自定义应用(设置、应用和销售渠道、开发应用)。为其授予 read_customers、read_orders 和 read_products 权限范围,安装后,将其 Admin API 访问令牌和你的商店域名粘贴到 FreeScout 连接器设置中。连接器会在保存前针对你的商店验证令牌。
我需要 Shopify Partner 账户或 App Store 上架吗?
不需要。自定义应用在你自己的商店管理后台中创建,无需合作伙伴账户、无需应用审核,也无需公开上架。
Shopify 连接器费用是多少?
Shopify 连接器包含在有效的 ReplyRabbit Pro 或 Team 计划中。否则,它作为一次性许可证花费 18 EUR,用于一个 FreeScout 安装。如果你购买它,请将其许可证密钥设置为 FreeScout .env 中的 SHOPIFYINTEGRATION_LICENSE_KEY。
为什么我只看到最近 60 天的订单?
Shopify 将应用限制为 60 天的订单历史,除非应用具有 read_all_orders 作用域。配置自定义应用时勾选 read_all_orders 以查看完整历史。
每个 FreeScout 邮箱可以连接不同的 Shopify 商店吗?
是的。每个邮箱都在连接器设置中存储自己的商店域名和访问 Token,因此不同的商店可以连接到不同的邮箱。