GitHub Issues 集成
兼容 GitHub
将 ReplyRabbit 连接到 GitHub Issues,以便 FreeScout 中的支持对话可以成为正确仓库中的结构化问题。代理可以从对话创建问题,在 FreeScout 中保持链接问题可见,并让 ReplyRabbit 准备工程交接。
在找概览?
概览
GitHub Issues 集成在 FreeScout 对话中为 ReplyRabbit 添加 GitHub 面板。配置 GitHub 后,ReplyRabbit 可以创建问题,包含开发者友好的标题、有用的摘要、标签、受派人、仓库上下文以及返回支持对话的链接。
每个邮箱选择一个问题跟踪器:无、Linear 或 GitHub。GitHub 和 Linear 是同一支持到工程工作流的替代方案,而不是在一个邮箱中同时运行的两个跟踪器。
手动创建 GitHub 问题在专业版和团队版上可用。从新客户邮件自动创建 GitHub 问题在团队版上可用。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- ReplyRabbit 已安装并激活。
- 一个包含您想使用的 GitHub 功能的 ReplyRabbit 套餐。
- 对 GitHub 账户或组织的访问权限,应在其中创建问题。
- 一个启用了 GitHub Issues 的仓库。
如果尚未安装 ReplyRabbit,请从以下开始 如何安装 ReplyRabbit 模块,然后完成 如何设置 ReplyRabbit.
权限和令牌范围
ReplyRabbit 使用您在邮箱设置中提供的个人访问令牌连接到 GitHub。建议使用细粒度令牌,并限制为 ReplyRabbit 应使用的仓库。您可以从以下位置创建一个 GitHub 的细粒度令牌设置.
为令牌授予足够的访问权限,以读取仓库元数据、读取标签和受让人、创建和更新问题以及添加问题评论。对于细粒度令牌,请从以下开始 元数据:读取, 内容:读取,以及 问题:读取和写入 对于选定的仓库。
对于更严格的审计跟踪,请从专用的 GitHub 机器人账户创建令牌,该账户只能访问 ReplyRabbit 应使用的仓库。
保持令牌私密。如果令牌在 GitHub 中被轮换或移除,请在创建更多问题之前更新邮箱设置。
连接 GitHub Issues
打开邮箱设置
在 FreeScout 中,打开应创建 GitHub 问题的邮箱,然后打开 设置 并选择 ReplyRabbit.选择 GitHub 作为问题跟踪器
在问题跟踪器选择器中,选择 GitHub Issues。ReplyRabbit 会显示 GitHub 设置,并隐藏该邮箱的 Linear 设置。粘贴令牌
粘贴您的 GitHub 个人访问令牌。如果你已保存令牌,ReplyRabbit 会显示掩码预览,而不是完整密钥。加载仓库
点击按钮从 GitHub 加载仓库,然后选择应创建新问题的默认仓库。保存设置
保存邮箱设置。ReplyRabbit 为该邮箱存储 GitHub 连接。
配置默认值
选择默认仓库后,配置您的坐席应使用的默认问题设置:
- 默认仓库: 选择当没有路由规则匹配时创建问题的位置。
- 自动提交 issue: 在 Team 层级上,让 ReplyRabbit 在分诊结果说需要工程工作时自动创建 GitHub 问题。
- 仓库路由: 当您希望 ReplyRabbit 将对话匹配到可用仓库时,启用自动仓库选择。
- 域名映射: 当您需要确定性路由时,将客户电子邮件域映射到特定仓库。
- 标签: 选择 ReplyRabbit 可以为问题类型、优先级或其他工作流标签应用的标签。
- 优先级标签: 将 ReplyRabbit 优先级映射到 GitHub 标签,因为 GitHub Issues 没有原生优先级字段。
- 默认负责人: 选择默认应接收新问题的 GitHub 用户。
- 审核通知: 启用自动创建问题时,添加一条 FreeScout 备注,告知客服该问题是自动创建的,应进行审核。
仓库路由是可选的。如果没有自信匹配的仓库,ReplyRabbit 使用默认仓库。
从 FreeScout 对话创建 GitHub 问题
在已配置 GitHub 的邮箱中打开一个对话。ReplyRabbit 面板可以从客户会话中创建 GitHub 问题,然后在 FreeScout 中显示关联的问题。
问题内容是为工程交接生成的,而不是从整个电子邮件线程盲目复制。使用手动创建时,在创建问题之前请审查标题、摘要、标签、受让人和仓库。
ReplyRabbit 还可以将电子邮件线程上下文添加为 GitHub issue 评论,这样工程团队无需让支持人员再次粘贴同一线程即可获得客户详细信息。
保持对话和问题同步
关联问题后,FreeScout 对话可以显示当前 GitHub 问题的标识符、标题、状态、标签和负责人。客服人员需要完整工程视图时,可以在 GitHub 中打开该问题。
ReplyRabbit 还支持完成循环:它按计划检查关联的 GitHub issue,通常每 5 分钟一次。当 GitHub 关闭 issue 时,ReplyRabbit 可以帮助起草客户跟进,以便支持团队能够结合上下文关闭对话。如果你的团队使用 GitHub 关闭原因,你可以将完成草稿限制为以 completed 关闭的 issue。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 仓库无法加载 | 确认令牌是当前的,并且可以访问选定的 GitHub 仓库。 |
| 问题未创建 | 确认 GitHub 是所选问题跟踪器、已选择默认仓库,并且您的 ReplyRabbit 套餐包含该功能。 |
| 不会创建自动 issue | 确认你使用的是 Team 层级,并且 自动提交 issue 已启用。 |
| 仓库错误或缺失 | 确认仓库路由或域映射已配置。如果没有自信匹配,ReplyRabbit 会使用默认仓库。 |
| 标签或负责人不会更新 | 重新加载对话,然后确认 token 仍有权访问关联的仓库。 |
| GitHub 返回速率限制错误 | 等待令牌的 GitHub API 限制重置,然后考虑缩小仓库访问范围或减少自动化问题活动。 |
| 已关闭的问题不会生成草稿 | 确认 完成时自动草稿 已启用,并且如果仅完成模式开启,GitHub 问题已关闭为已完成。 |
对于更广泛的修复,请参阅 ReplyRabbit 故障排除.
隐私和数据处理
ReplyRabbit 向 GitHub 发送工程交接所需的问题内容。这可能包括相关客户上下文、生成的问题标题、生成的摘要、标签、负责人以及 FreeScout 对话链接或标识符。
除非仓库被允许接收,否则不要将敏感信息放入 GitHub 问题。如果客户数据必须完全保留在您自己的服务器上,请为该邮箱保持 GitHub 禁用。
后续步骤
- 继续使用 如何设置 ReplyRabbit 如果邮箱仍需要提供商、上下文或风格设置。
- 读取 Slack 集成 如果您的团队希望在 Slack 中接收问题创建或完成通知。
- 与以下比较 Linear 集成 如果您正在决定邮箱应使用哪个问题跟踪器。
常见问题
我需要 GitHub 个人访问令牌吗?
是的。ReplyRabbit 使用你自己 GitHub 账户或组织中的 Token 连接 GitHub。
一个邮箱可以同时使用 Linear 和 GitHub 吗?
不需要。每个邮箱选择一个问题跟踪器:无、Linear 或 GitHub。
ReplyRabbit 可以选择 GitHub 仓库吗?
是,在配置了仓库路由的情况下。ReplyRabbit 支持域名映射以及针对你的令牌可访问仓库的 AI 仓库匹配。
哪个套餐包含 GitHub Issues?
手动创建 GitHub 问题是专业版功能。自动创建 GitHub 问题是团队版功能。
ReplyRabbit 会将整个客户对话发送到 GitHub 吗?
ReplyRabbit 发送工程交接所需的问题内容,包括相关客户上下文和生成的摘要。