
FreeScout 的 Stripe 连接器
兼容 Stripe
Stripe 连接器将客户付款和订阅上下文放在 FreeScout 对话旁。它使用受限的只读 Stripe API 密钥,因此可以查找信息而不会更改 Stripe 中的任何内容。
在找概览?
连接器显示什么
当 FreeScout 对话包含客户电子邮件地址时,连接器会在 Stripe 中搜索匹配的客户和近期付款记录。根据搜索结果,侧边栏可以显示:
- 客户身份,名称链接到 Stripe 客户,加上电子邮件和客户自日期。
- 订阅显示一个链接图标,可在 Stripe 中打开订阅、周期、彩色状态点、第一个项目的单价及其计费间隔,例如
€49/m或€120/y,以及产品名称(回退到价格昵称,然后是通用标签)。诸如取消、试用结束或折扣等列仅在套餐具有这些列时才会显示。 - 订单式表格中的支付:一个在 Stripe 中打开支付的链接图标、日期、带任何 Radar 风险和卡片检查图标的状态点、总计,以及裁剪后的已购项目列表。
- 退款和争议作为详细信息显示在它们所属的付款行上。仅当至少一行有内容可显示时,才会出现详细信息列。
- 有可用拒绝原因的失败付款,显示在同一详细信息列中。
- 金额在存在货币符号时使用该符号,例如
€61或$12.50中的主要设置,否则使用货币代码;日期会紧凑显示,例如Sep 24 '26. - 已加载付款的已捕获、退款和净额总计。
- 电子邮件链接:当客户从与 Stripe 中不同的地址写信时,将 Stripe 电子邮件链接到线程,面板会显示该客户的付款。
- 已保存支付方式的品牌、后四位和有效期。
当连接器只能看到部分付款历史时,总计下方会有一条说明,指出总计仅涵盖已加载的付款。它不会在每个总计下重复。
连接器限制每次查询,仅检查与该客户相关的记录。它不会扫描整个 Stripe 账户以查找争议或支付历史。空或部分结果不能证明 Stripe 中不存在其他记录。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- 允许你创建受限 API 密钥的 Stripe 仪表板访问权限。
- 有效的 ReplyRabbit Pro 或 Team 许可证,或独立的 Stripe Connector 许可证。独立许可证为 18 EUR,按每个 FreeScout 安装一次性购买。
- 仅当你希望为草稿启用可选的、明确启用的 AI 商务上下文时,才安装 ReplyRabbit。
登录到 您的 ReplyRabbit 仪表板。有效的 ReplyRabbit Pro 或团队版套餐包含连接器下载。如果你没有这两种套餐,请在此处购买独立许可证,然后下载连接器并将许可证密钥保存在仪表板中。
创建受限的 Stripe API 密钥
连接器需要一个 Stripe 受限密钥,而不是密钥。在 Stripe 仪表板中创建一个新的受限密钥。设置 客户, 订阅, 发票, 费用, PaymentIntents, PaymentMethods,以及 争议 到 读取,并设置 产品 到 读取 以显示订阅计划名称。没有 Products 读取权限时,订阅会回退到价格昵称或通用标签。将所有无关权限设置为 无.
不要粘贴密钥
当 Stripe 显示受限密钥时复制它。像对待密码一样对待它。连接器在保存时加密它,并且永远不会再次显示完整值。
安装连接器
下载 Stripe 连接器
登录于 app.replyrabbit.app。通过你有效的 ReplyRabbit Pro 或团队版套餐下载连接器,或先购买独立的 Stripe Connector 许可证。上传到 FreeScout
在 FreeScout 中,打开 模块,使用上传控件选择 ZIP 文件,然后安装。激活模块
激活 Stripe 连接器 从 FreeScout 模块列表。
配置邮箱
打开 Stripe Connector 设置
打开应显示 Stripe 支付上下文的 FreeScout 邮箱,然后选择 Stripe 连接器 从其设置菜单。粘贴受限密钥
启用连接器并粘贴受限的只读 Stripe 密钥。如果你购买了独立连接器许可证,还要粘贴你 ReplyRabbit 账户中的许可证密钥。已安装的 ReplyRabbit Pro 或 Team 许可证会自动解锁 Stripe 连接器。保存设置。测试已保存的密钥
使用 测试已保存的密钥 以确认 Stripe 接受该密钥及其客户读取权限。检查匹配的对话
打开一个对话,其客户邮箱存在于 Stripe 中,并确认 Stripe 面板出现在侧边栏中。
每个 FreeScout 邮箱存储自己的加密 Stripe 密钥。您可以将不同的 Stripe 账户连接到不同的邮箱。
匹配使用不同邮箱写信的客户
Stripe 按对话的电子邮件地址匹配。当同事写信,或客户使用的地址与其 Stripe 客户上的地址不同时,将正确的电子邮件链接到会话:
找到 Stripe 面板
打开对话并在侧边栏中找到 Stripe 面板。链接另一个邮箱
选择 链接另一个邮箱,然后从会话线程中选择一个地址,或输入 Stripe 中使用的账单地址。检查面板
面板现在显示该客户的付款,注明 链接到 地址,并提供 移除链接。连接器设置会列出每个已保存的链接,并带有 移除 每个地址的 action。
链接会将会话中所有非邮箱地址、发件人、收件人和抄送映射到您选择的 Stripe 邮箱。这些链接按邮箱存储,因此来自其中任一地址的未来会话都会解析到同一个 Stripe 客户。连接器仍然只读取 Stripe 数据。
可选 ReplyRabbit 草稿上下文
侧边栏无需 ReplyRabbit 即可工作。仅当你希望在生成 AI 草稿时提供最近的 Stripe 详情时,才需要 ReplyRabbit。
要选择加入,请设置 STRIPEINTEGRATION_COMMERCE_CONTEXT_ENABLED=true 在 FreeScout 环境中,然后为邮箱启用连接器。对于 ReplyRabbit 端,要么设置 REPLYRABBIT_COMMERCE_CONTEXT_ENABLED=true 对于每个邮箱,或在邮箱设置、产品、商店数据下的草稿中选择开启以针对一个邮箱。一旦邮箱有可用的商店连接器,该行就会显示在 Essentials 视图中;在此之前,切换到所有设置以找到它。只有 FreeScout 管理员可以更改它。邮箱选择会覆盖服务器设置;“使用默认设置”(默认)会遵循它。两个设置默认都关闭。更改环境值后,运行 php artisan config:clear 从 FreeScout 目录,以便 FreeScout 获取新值而不是缓存的配置。
Stripe 必须是该邮箱唯一活跃的完整上下文提供商。如果 Shopify 也提供完整商务上下文,ReplyRabbit 会在只剩一个启用之前将商务数据排除在草稿之外。Magento 和 WooCommerce 权益查找不会冲突。Stripe 侧边栏仍可供支持客服使用。
数据处理和限制
连接器通过 HTTPS 将对话电子邮件发送到 Stripe,以查找匹配的客户范围记录。它加密存储受限密钥。它不缓存完整卡号、原始 Stripe 负载、账单地址、元数据、支付意图机密或收据 URL。
Stripe 请求使用固定的 2026-02-25.clover API 版本。当没有匹配的 Customer 记录时,连接器最多检查过去 90 天内 200 笔近期扣款,并在本地精确匹配电子邮件。此访客付款回退机制有意不完整。
有限查询保持侧边栏响应迅速并减少不必要的数据访问。总计下方的一条注释说明它们何时仅涵盖连接器加载的付款。要进行完整的账户范围审计,请使用 Stripe 仪表板。
故障排除
| 症状 | 应检查什么 |
|---|---|
| Stripe 拒绝密钥 | 创建具有所需读取权限的新受限密钥。不要使用完整的秘密密钥。 |
| 侧边栏对已知买家为空 | 确认 FreeScout 对话电子邮件与买家的 Stripe 电子邮件完全匹配。访客付款仅在有限的 90 天、200 笔费用回退范围内检查。 |
| 缺少退款或争议 | 连接器仅检查该客户有限的一组近期记录。请查看 Stripe 仪表板以获取完整账户历史。 |
| ReplyRabbit 草稿不包含付款上下文 | 确认两个商务上下文环境标志均为 true,Stripe 连接器可用于该邮箱,且没有其他商务提供商处于活动状态。 |
| 部分付款详情不可用 | 对于独立购买,确认 Stripe 连接器许可证密钥已保存在连接器设置中,并且对预期的 FreeScout 域名有效。对于捆绑访问,确认同一 FreeScout 站点上安装了有效的 ReplyRabbit Pro 或 Team 许可证。 |
后续步骤
- 读取 如何设置 ReplyRabbit 如果邮箱仍需要 AI 提供商或草稿设置。
- 参见 Shopify 连接器, WooCommerce 连接器,或 Magento 连接器 其他商务平台的指南。
常见问题
Stripe 连接器会写入 Stripe 吗?
不需要。连接器使用仅具有文档所述读取权限的 Stripe 受限 API 密钥。它不会创建退款、取消订阅、重试扣款或更改 Stripe 数据。
如果 Stripe 中没有显示退款或争议,是否意味着不存在?
不需要。连接器只检查该客户有限的一组近期记录。空面板仅描述这些记录,不代表完整的 Stripe 账户历史。
Stripe 数据能用于 ReplyRabbit 草稿吗?
是,在你同时启用 ReplyRabbit 和 Stripe Connector 商务上下文,且 Stripe 是邮箱唯一活跃的全上下文提供商之后。如果 Shopify 也在提供完整商务上下文,ReplyRabbit 会在只剩一个启用之前将商务数据排除在草稿之外。Magento 和 WooCommerce 的权限查询不会冲突。
Stripe 连接器费用是多少?
Stripe 连接器包含在有效的 ReplyRabbit Pro 或 Team 套餐中。否则,作为一次性许可证,一个 FreeScout 安装的费用为 18 欧元。
我可以匹配使用不同电子邮件写信的客户吗?
是的。打开对话,在 Stripe 面板中选择 Link another email,然后从会话线程中选择一个地址或输入一个地址。链接会按邮箱记住,因此来自任何已链接地址的未来对话都会显示同一个 Stripe 客户。面板随后会显示 Manually connected,你可以从那里取消链接。