Jira 集成
兼容 Jira
将 ReplyRabbit 连接到 Jira Cloud,以便 FreeScout 中的支持对话可以成为结构化 Jira 问题。代理可以从对话创建 Jira 问题,在 FreeScout 中保持链接问题可见,并在工作完成时使用 ReplyRabbit 准备客户跟进。
在找概览?
概览
Jira 集成在 FreeScout 对话中为 ReplyRabbit 添加 Jira 面板。为邮箱配置 Jira 后,ReplyRabbit 可以创建问题,包含标题、描述、优先级、标签、受派人、问题类型、项目和返回支持对话的链接。
Jira 被选为某个邮箱的活动问题跟踪器。如果某个邮箱已在使用 Linear 或 GitHub Issues,请保持该跟踪器处于选中状态,直到你准备好将该邮箱迁移到 Jira。
前提条件
开始之前,请确保你有:
- 一个可正常工作的 FreeScout 安装。
- ReplyRabbit 已安装并激活。
- 一个包含您想使用的 Jira 功能的 ReplyRabbit 套餐。
- 一个 Jira Cloud 站点,例如
https://example.atlassian.net. - 一个 Jira 账户邮箱和 API 令牌,需具有目标项目的访问权限。
- 至少一个支持创建 issue 的 Jira 项目和 issue 类型。
- 你启用工作流所需的 Jira 项目权限:需要 Browse Projects 和 Create Issues;当你使用优先级/标签编辑、分配、状态转换或线程评论时,需要 Edit Issues、Assign Issues、Transition Issues 和 Add Comments。
如果尚未安装 ReplyRabbit,请从以下开始 如何安装 ReplyRabbit 模块,然后完成 如何设置 ReplyRabbit.
权限和 API 令牌
ReplyRabbit 使用基本身份验证连接到 Jira Cloud REST API v3。邮箱存储三个连接值:
- Jira 站点 URL: 该
https://example.atlassian.net站点 URL。 - 账户邮箱: 与 API 令牌一起使用的 Atlassian 账户邮箱。
- API 令牌: 该账户的 Jira Cloud API 令牌。
API 令牌作为加密的邮箱设置存储,保存后不会完整显示。如果令牌在 Atlassian 中被轮换或移除,请在创建更多问题之前更新邮箱设置。
连接 Jira
打开邮箱设置
在 FreeScout 中,打开应创建 Jira 问题的邮箱,然后打开 设置 并选择 ReplyRabbit.选择 Jira 作为问题跟踪器
在 集成 部分,将问题跟踪器设置为 Jira。一个邮箱可以使用 Linear、GitHub Issues、Jira,或不使用问题跟踪器。添加 Jira 凭据
粘贴 Jira Cloud 站点 URL、账户邮箱和 API 令牌。加载 Jira 项目
从 Jira 加载项目,然后为新问题选择默认项目。选择问题类型
加载项目的问题类型并选择默认问题类型,例如任务或缺陷。保存设置
保存邮箱设置。ReplyRabbit 为该邮箱存储 Jira 连接。
配置默认值
连接 Jira 后,配置您的团队需要的默认值:
- 默认项目: 当没有域映射或 AI 项目匹配选择其他项目时使用的 Jira 项目。
- 默认问题类型: 新问题的问题类型,通常是 Task 或 Bug。
- 优先级映射: 将 ReplyRabbit 优先级映射到原生 Jira 优先级名称。
- 项目路由: 当路由应确定时,将客户电子邮件域映射到 Jira 项目。
- 自动提交 issue: 在 Team 层级上,让 ReplyRabbit 在分诊说需要工程工作时自动创建 Jira 问题。
- 完成时自动草稿: 当链接的 Jira 问题达到 Done 状态类别时,让 ReplyRabbit 准备客户跟进。
项目路由是可选的。如果没有自信匹配的项目,ReplyRabbit 使用邮箱默认项目。
从 FreeScout 对话创建 Jira 问题
在已配置 Jira 的邮箱中打开一个对话。ReplyRabbit 面板可以从客户会话中创建 Jira 问题,然后在 FreeScout 中显示关联的问题。
ReplyRabbit 向 Jira 发送结构化的 Atlassian Document Format 描述。该描述包括支持摘要、客户上下文和 FreeScout 对话链接。客户文本被视为内容,而不是指令。
创建后,审核关联的 Jira 问题,并在需要时从 ReplyRabbit 面板调整状态、优先级、负责人或标签。
保持对话和问题同步
关联问题后,FreeScout 对话可以显示当前 Jira 状态、优先级、负责人、标签和问题键。客服人员需要完整工程视图时,可以在 Jira 中打开该问题。
ReplyRabbit 通过 Jira 转换更改 Jira 状态。它不会直接写入状态字段。
ReplyRabbit 还支持完成循环。计划状态检查会轮询关联的 Jira issue。当 Jira 报告 Done 状态类别时,ReplyRabbit 可以帮助起草客户跟进,以便支持团队能够结合上下文关闭对话。
故障排除
| 症状 | 应检查什么 |
|---|---|
| 项目无法加载 | 确认站点 URL 是 Jira Cloud atlassian.net URL、电子邮件正确,且 API 令牌具有项目访问权限。 |
| 问题类型缺失 | 确认所选项目支持您预期使用的问题类型。 |
| 问题未创建 | 确认 Jira 被选为邮箱问题跟踪器、已选择项目,并且您的 ReplyRabbit 套餐包含该功能。 |
| 不会创建自动 issue | 确认你使用的是 Team 层级,并且 自动提交 Issues 已启用。 |
| 状态不会更新 | 重新加载对话,然后确认 Jira 为目标状态暴露了有效的转换。 |
| 完成草稿未出现 | 确认 完成时自动草稿 已启用,并且链接的 Jira 问题已达到 Done 状态类别。 |
对于更广泛的修复,请参阅 ReplyRabbit 故障排除.
隐私和数据处理
ReplyRabbit 向 Jira 发送工程交接所需的问题内容。这可能包括相关客户上下文、生成的问题文本、优先级、标签、负责人以及 FreeScout 对话链接或标识符。
除非您的 Jira Cloud 工作区被允许接收,否则不要将敏感信息放入 Jira 问题。如果客户数据必须完全保留在您自己的服务器上,请为该邮箱保持 Jira 禁用。
常见问题
ReplyRabbit 支持 Jira Data Center 或 Server 吗?
不需要。ReplyRabbit 支持使用 atlassian.net URL 的 Jira Cloud 站点。
Jira 需要 OAuth 吗?
不需要。ReplyRabbit 使用按邮箱配置的 Jira Cloud Basic 认证,包括站点 URL、账户邮箱和 Jira API 令牌。
一个邮箱可以同时使用 Jira 与 Linear 或 GitHub Issues 吗?
不需要。每个邮箱选择一个活动的问题跟踪器。选择其中任一后,Linear 和 GitHub Issues 设置仍保持可用。
当 Jira 问题完成时,ReplyRabbit 能起草客户跟进邮件吗?
是的。ReplyRabbit 会轮询已链接的 Jira 问题,并可以在 Jira 报告 Done 状态类别时准备客户跟进草稿。