Magento 连接器
兼容 Magento
将 Magento 2 或 Adobe Commerce 连接到 FreeScout,以便对话显示匹配的客户订单和购买上下文。一个小的只读 Magento 模块通过 Magento REST API 公开支持摘要,FreeScout 连接器在对话侧边栏中显示它。ReplyRabbit 还将产品所有权上下文馈送到 AI 层,以便草稿可以引用客户购买的内容。
在找概览?
概览
Magento 连接器为 FreeScout 对话添加订单侧边栏。当对话有客户电子邮件地址时,连接器调用 moo-support/summary 您 Magento 商店上的端点,用于匹配订单并在对话旁边显示它们。
侧边栏显示客户面板、完整订单历史、每笔订单的含数量和价格的订单项、财务总计、客户终身价值(CLV)、平均订单价值(AOV)以及产品所有权权益,这些信息会流入 ReplyRabbit AI 上下文,以生成更相关的草稿。
需要安装两个组件:
- 该 ReplyRabbit 连接器模块 用于 Magento 2。它添加了两个只读 REST 端点(
/rest/V1/moo-support/summary和/rest/V1/moo-support/purchased-products)位于一个名为 ReplyRabbit 连接器 API。它不会更改店面或结账。 - 该 FreeScout Magento 连接器模块。它使用 Magento 集成访问令牌通过 HTTPS 调用这些端点,并渲染订单侧边栏。它在 FreeScout 中有自己的按邮箱设置页面。
订单侧边栏独立工作。流入 AI 草稿的产品所有权权益是使用 ReplyRabbit 的部分。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- 一个可通过 HTTPS 访问的 Magento 2.4 或更高版本商店(Magento Open Source 或 Adobe Commerce),并具有运行 Magento CLI 命令的 SSH 访问权限。
- Magento 管理员访问权限以创建集成。
- 如果你希望在 AI 草稿中获得产品归属上下文,请安装并激活 ReplyRabbit。
- 一个 Magento Connector 许可证(18 EUR 一次性,适用于一个 FreeScout 安装),或一个有效的 ReplyRabbit Pro 或 Team 套餐,其中包含该许可证。
如果尚未安装 ReplyRabbit,请从以下开始 如何安装 ReplyRabbit 模块,然后完成 如何设置 ReplyRabbit.
安装 Magento 模块
下载 Magento 模块
登录于 app.replyrabbit.app 并从 Magento 连接器卡片下载 Magento 模块 ZIP。解压到 app/code
将 ZIP 上传到你的 Magento 根目录并解压。它会创建app/code/Moogento/SupportData.启用模块
从 Magento 根目录运行:在生产模式的商店上,还需运行bashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploy就像安装任何模块一样。
Composer 安装
moogento/m2-supportdata 从 Moogento 包仓库。上面的 ZIP 安装不需要 Composer 凭据。创建 Magento 集成令牌
连接器使用来自 Magento 集成的访问令牌进行身份验证。创建一个限定为模块只读权限的令牌。
打开“集成”
在 Magento 管理员中,转到 系统,然后 扩展,然后 集成,然后点击 添加新集成.命名并设置 API 范围
输入名称,例如 "ReplyRabbit Connector",以及你的管理员密码。在 API 选项卡,设置 资源访问 到 自定义 并仅勾选 ReplyRabbit 连接器 API (位于顶层管理树之下)。保存。激活并复制访问令牌
点击 激活 在新集成旁边,然后 允许。复制 访问令牌。Magento 会在集成详情中显示令牌,因此你可以稍后返回查看。
只读访问权限
安装 FreeScout 连接器模块
FreeScout Magento 连接器模块调用 Magento 端点并在对话中呈现订单侧边栏。它是独立模块,有自己的设置,与 ReplyRabbit 分开。
下载连接器模块
登录于 app.replyrabbit.app 以下载 FreeScout 连接器模块 ZIP。购买连接器或持有有效的 ReplyRabbit Pro 或 Team 计划后,两个下载都会出现。上传到 FreeScout
在 FreeScout 中,转到 模块,点击上传按钮,选择 ZIP 文件,然后安装。激活模块
激活 Magento 集成 从模块列表中的模块。
按邮箱配置
安装模块后,在连接器自己的每邮箱设置页面中将其连接到您的商店。
打开连接器设置
在 FreeScout 中,打开应显示 Magento 订单数据的邮箱,打开邮箱设置菜单,然后选择 商店连接器。这是 Magento 连接器的设置页面,而不是 ReplyRabbit 设置中的一部分。输入 Magento 基础 URL
通过 HTTPS 粘贴您的 Magento 商店基础 URL,例如https://your-store.com。不需要尾部斜杠。输入访问令牌
粘贴 访问令牌 来自 Magento 集成。它被加密存储,保存后只显示掩码预览。设置商店 ID(可选)
留空以匹配所有商店的订单。输入 Magento 商店 ID 以将侧边栏限制为一个商店或商店视图。添加您的连接器许可证密钥
如果你购买了连接器,请输入其许可证密钥。如果有效的 ReplyRabbit Pro 或 Team 套餐涵盖安装,请跳过此步骤。保存并测试
保存设置。打开客户电子邮件与 Magento 订单匹配的 FreeScout 对话,并确认订单侧边栏出现。
每个 FreeScout 邮箱存储自己的基础 URL、访问令牌和商店 ID,因此您可以将不同的邮箱连接到不同的 Magento 商店或商店视图。
连接器显示什么
- 一个面向对话中相关人员的客户面板。
- 包含订单号、日期、状态和总额的完整订单历史。
- 按订单的行项目,包含数量和价格。
- 财务总计(小计、折扣、运费、税费、退款)。
- 客户终身价值(CLV)和平均订单价值(AOV)。
- 用于 AI 草稿的产品所有权权益。
如何获取连接器
Magento 连接器是付费模块。你可以通过两种方式获取:
- 以 18 EUR 购买 Magento Connector,作为单个 FreeScout 安装的一次性许可证,然后将其许可证密钥粘贴到连接器设置中。
- 使用有效的 ReplyRabbit Pro 或 Team 计划,其中包含连接器且无需额外费用。
从你的账户购买许可证或下载连接器 ReplyRabbit 仪表板。访问 定价页面 了解 ReplyRabbit 计划选项。如果活跃的 ReplyRabbit Pro 或 Team 计划涵盖该安装,则连接器在配置后即可工作,无需单独的许可证密钥。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 订单侧边栏未出现 | 确认连接器设置中的基础 URL 和访问令牌正确,并且邮箱面板已启用。 |
| 来自商店的 HTTP 404 | ReplyRabbit Connector 模块未安装或未启用。重新运行 bin/magento module:enable Moogento_SupportData 和 bin/magento setup:upgrade,然后刷新缓存。 |
| 来自商店的 HTTP 401 或 403 | 集成未激活,令牌已重新生成,或集成缺少 ReplyRabbit 连接器 API 资源。重新激活集成并粘贴当前令牌。 |
| "连接被拒绝"或超时错误 | 检查 FreeScout 服务器能否通过 HTTPS 访问您的商店 URL。防火墙、IP 允许列表或维护模式可能会阻止该请求。 |
| 基础 URL 被拒绝 | 商店必须通过 HTTPS 提供服务。纯 http:// URL 或无法访问的主机被拒绝。 |
| 已知客户的订单为空 | 确认 FreeScout 对话上的客户电子邮件与其 Magento 订单上的电子邮件匹配,并且商店 ID(如果设置)与其下单的商店匹配。 |
| 行项目、财务数据或 CLV 未显示 | 确认连接器许可证密钥已保存,或者有效的 ReplyRabbit Pro 或 Team 套餐覆盖该安装。 |
| 产品所有权上下文未出现在草稿中 | 确认连接器已授权、ReplyRabbit 已安装、连接器正在返回订单,并且该邮箱已启用 AI 上下文功能。 |
对于更广泛的问题,请参阅 ReplyRabbit 故障排除.
隐私和数据处理
当连接器查询 Magento 时,它会通过 HTTPS 将客户电子邮件地址发送到你自己的 Magento 商店。从你的商店返回的订单数据会填充 FreeScout 侧边栏,并与 ReplyRabbit 一起构建草稿的 AI 上下文。
集成令牌只需要只读 ReplyRabbit 连接器 API 资源,因此连接器绝不会写入你的商店。令牌在 FreeScout 中加密存储,出站请求会验证 TLS 且不跟随重定向。
除通过为邮箱选择的 AI 提供商外,不会将 Magento 订单数据发送给第三方,且仅在 AI 上下文功能使用它时。如果您的政策要求订单数据完全保留在自己的服务器上,请为邮箱使用本地 AI 提供商(例如 Ollama)。
后续步骤
- 完成 如何设置 ReplyRabbit 如果邮箱仍需要提供商、上下文或风格设置。
- 也在使用 WooCommerce?请参阅 WooCommerce 连接器 指南。
常见问题
连接器需要 Magento 模块吗?
是的。连接器读取 ReplyRabbit Connector 模块添加到 Magento 2 REST API 的 support-summary 端点。有两个下载,Magento 模块和 FreeScout Magento 连接器模块,均可从你的 ReplyRabbit 账户获取。
支持哪些 Magento 版本?
Magento 2.4 及更高版本,包括 Magento Open Source 和 Adobe Commerce,运行于 PHP 8.0 至 8.4。不支持 Magento 1。
Magento 连接器费用是多少?
Magento 连接器包含在有效的 ReplyRabbit Pro 或 Team 计划中。否则,它作为一次性许可证花费 18 EUR,用于一个 FreeScout 安装。如果你购买它,请将其许可证密钥粘贴到连接器设置中。
访问令牌需要什么权限?
仅使用 ReplyRabbit Connector API 资源,该资源为只读。连接器绝不会写入您的商店,因此集成不需要任何其他管理员权限。
每个 FreeScout 邮箱可以连接不同的 Magento 商店吗?
是的。每个邮箱都在连接器设置中存储自己的基础 URL、访问 Token 和可选的商店 ID,因此不同的商店或商店视图可以连接到不同的邮箱。