Linear 集成
兼容 Linear
将 ReplyRabbit 连接到 Linear,以便 FreeScout 中的支持对话可以成为结构化工程问题。代理可以从对话创建 Linear 问题,在 FreeScout 中保持链接问题可见,并使用 ReplyRabbit 准备交接。
在找概览?
概览
Linear 集成在 FreeScout 对话中为 ReplyRabbit 添加 Linear 面板。配置 Linear 后,ReplyRabbit 可以创建问题,包含开发者友好的标题、整洁的摘要、优先级、状态、项目上下文以及返回支持对话的链接。
手动创建 Linear 问题在专业版和团队版上可用。从新客户邮件自动创建 Linear 问题在团队版上可用。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- ReplyRabbit 已安装并激活。
- 一个包含您想使用的 Linear 功能的 ReplyRabbit 套餐。
- 对 Linear 工作区的访问权限,您可以在其中创建 API 密钥。
- 至少一个应创建支持 issue 的 Linear 团队。
如果尚未安装 ReplyRabbit,请从以下开始 如何安装 ReplyRabbit 模块,然后完成 如何设置 ReplyRabbit.
权限和 API 密钥
ReplyRabbit 使用您的 Linear API 密钥加载团队、工作流状态、项目、标签和团队成员,然后创建和更新 issue。请在 Linear 的账户安全或 API 设置中创建密钥,然后将其粘贴到 ReplyRabbit 邮箱设置中。
保持密钥私密。如果密钥在 Linear 中被轮换或移除,请在创建更多问题之前更新邮箱设置。
连接 Linear
打开邮箱设置
在 FreeScout 中,打开应创建 Linear 问题的邮箱,然后打开 设置 并选择 ReplyRabbit.找到 Linear 设置
在 ReplyRabbit 设置屏幕中,转到 集成 部分并启用 Linear.粘贴 API 密钥
粘贴您的 Linear API 密钥。如果你已保存密钥,ReplyRabbit 会显示掩码预览,而不是完整密钥。加载团队
点击按钮从 Linear 加载团队,然后选择应创建新问题的团队。保存设置
保存邮箱设置。ReplyRabbit 为该邮箱存储 Linear 连接。
配置默认值
选择 Linear 团队后,配置您的坐席应使用的默认值:
- 默认状态: 选择新 Linear 问题的初始工作流状态,例如 Triage 或 Backlog。
- 自动提交 issue: 在 Team 层级上,让 ReplyRabbit 在分诊结果说需要工程工作时自动创建 Linear 问题。
- 项目路由: 当您希望 ReplyRabbit 将对话匹配到 Linear 项目时,启用自动项目选择。
- 域名映射: 当您需要确定性路由时,将客户电子邮件域映射到特定的 Linear 项目。
- 工单模板: 当你的团队希望 Linear 问题正文保持一致时,使用 Markdown 模板。
项目路由是可选的。如果没有自信匹配的项目,ReplyRabbit 仍可以在没有项目的情况下创建 issue。
从 FreeScout 对话创建 Linear 问题
在已配置 Linear 的邮箱中打开一个对话。ReplyRabbit 面板可以从客户对话中创建 Linear 问题,然后在 FreeScout 中显示关联的问题。

问题内容是为工程交接生成的,而不是从整个电子邮件线程盲目复制。使用手动创建时,在创建问题之前请审查标题、摘要、优先级和项目。
保持对话和问题同步
关联问题后,FreeScout 对话可以显示当前 Linear 状态、负责人、项目和问题标识符。客服人员需要完整工程视图时,可以在 Linear 中打开该问题。
ReplyRabbit 还支持完成循环:当工程团队将 Linear issue 标记为完成时,ReplyRabbit 可以帮助起草客户跟进,以便支持团队能够结合上下文关闭对话。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 团队无法加载 | 确认 Linear API 密钥是最新的,并且属于预期工作区。 |
| 问题未创建 | 确认 Linear 已启用、已选择团队,并且您的 ReplyRabbit 套餐包含该功能。 |
| 不会创建自动 issue | 确认你使用的是 Team 层级,并且 自动提交 issue 已启用。 |
| 项目缺失 | 确认项目路由或域映射已配置。如果没有自信匹配,ReplyRabbit 可能会跳过该项目。 |
| 状态或经办人不会更新 | 重新加载对话,然后确认 Linear 密钥仍有权访问关联的 issue。 |
对于更广泛的修复,请参阅 ReplyRabbit 故障排除.
隐私和数据处理
ReplyRabbit 向 Linear 发送工程交接所需的问题内容。这可能包括相关客户上下文、生成的问题标题、生成的摘要、项目或优先级字段以及 FreeScout 对话链接或标识符。
除非您的 Linear 工作区被允许接收,否则不要将敏感信息放入 Linear 问题。如果客户数据必须完全保留在您自己的服务器上,请为该邮箱保持 Linear 禁用。
常见问题
我需要 Linear API 密钥吗?
是的。ReplyRabbit 使用你自己 Linear 账户中的 API 密钥连接 Linear。
我可以选择 Linear 团队吗?
是的。在邮箱设置中从 Linear 加载团队,然后选择 ReplyRabbit 应创建问题的团队。
ReplyRabbit 可以设置项目吗?
是,在配置了项目路由的情况下。ReplyRabbit 支持基于域名的项目映射以及针对可用 Linear 项目的 AI 项目匹配。
哪个套餐包含 Linear?
手动创建 Linear 问题是专业版功能。自动创建 Linear 问题是团队版功能。
ReplyRabbit 会将整个客户对话发送到 Linear 吗?
ReplyRabbit 发送工程交接所需的问题内容,包括相关客户上下文和生成的摘要。