跳转到主要内容
版本要求:所有版本均可创建 IM 应用用于 AI SRE 对话;将应用用于 On-call 分派通知,需有效的 On-call 专业版订阅。了解更多

安装应用

1

添加集成

访问 Flashduty On-call 集成中心 → 即时消息 → Slack,点击 添加。
2

授权应用

在跳转的 Slack 页面,于右上角选择 工作区,然后点击 允许。Slack:授权应用 界面截图
3

保存配置

输入数据源名称,点击 保存。

配置作战室

完成先前步骤后,在 Flashduty On-call 集成配置页面的 增强功能 模块,勾选 开启作战室 即可启用该功能,无需额外配置。

AI SRE 控制项

在 增强功能 中配置 AI SRE 开关,各开关含义见 IM 平台。允许在 IM 中使用 AI SRE 与 普通群聊中 AI-SRE 使用话题回复 默认开启;允许 AI 主动接话 默认关闭,开启前还需要给 Slack 应用补上两项读取频道消息的权限,见所需权限。Slack 的 允许在 IM 中使用 AI SRE 同时控制 /fd 命令。

成员关联

Slack 集成不提供成员关联页面:集成详情页只有配置页,没有 关联用户 页签,也没有 一键关联 按钮;Flashduty 不会用成员的手机号或邮箱去换取 Slack 账号 ID 做批量绑定。 Slack 集成按邮箱识别成员:成员在 Slack 中操作告警卡片时,Flashduty 读取该 Slack 账号的邮箱,并与当前账户下的成员邮箱比对,匹配到即视为该成员。所以这里不需要逐个成员绑定,但要保证成员的 Slack 邮箱与 Flashduty 成员邮箱一致;邮箱不一致时,系统会在 Slack 中回复一条提示,说明未能匹配到成员。 Slack 的接入以工作区为单位:完成 安装应用 的 OAuth 授权后,该工作区内的频道通知、群聊中 @ AI SRE 和作战室即可使用。

所需权限

安装应用时,Flashduty 会通过 OAuth 一次性请求以下 scope,覆盖基础通知、作战室、AI SRE 对话、AI 生成复盘和故障通知分派,通常无需手动配置。较早授权的集成如缺少权限,请在集成配置页 重新授权。

Bot Token Scopes

OAuth 授权请求不包含 files:read,控制台的缺少必要权限检查也不检查它。AI SRE 要读取 Slack 会话中上传的文件和图片,需要您在 Slack 应用后台的 OAuth & Permissions 中为 Bot Token 添加 files:read 并重新安装应用;重新授权不会补上这一项。
允许 AI 主动接话 依赖应用能读到没有被 @ 的频道消息:公开频道靠 channels:history,私有频道靠 groups:history。在 AI 主动接话上线之前完成授权的 Slack 应用没有这两项权限,频道里的非 @ 消息不会送到 Flashduty,AI 也就无从接话。集成详情页顶部会提示「我们更新了 Slack 应用,请重新授权。」并给出 重新授权 按钮,点它重新走一次 Slack 授权即可,已有的集成配置和用户关联不受影响。

User Token Scopes

以上清单与当前 OAuth 授权请求一致;如与 Slack 授权页面显示存在差异,以授权页实际请求为准。
如果您使用的是 Slack Incoming Webhook 方式的 Slack 机器人通知,而不是本页的 Slack App 集成,请在对应 Slack 应用中开启 Incoming Webhooks,并在 OAuth 流程中包含 incoming-webhook scope。

常见问题

  • 同一时间只能有一个 IM 集成开启作战室,需先在其他集成中关闭,详见 作战室
  • 开启作战室时,系统会自动验证当前 Slack 应用是否具备作战室所需的全部权限。如果检测到缺少必要权限,页面会显示一条警告提示,并提供 重新授权 链接
  • 点击 重新授权 链接后,系统会跳转到 Slack 授权页面,请求所需权限。完成授权后,页面会自动返回 Flashduty
  • 如果您的 Slack 集成是在作战室功能上线之前完成授权的,首次开启时通常需要重新授权以补充新增权限。重新授权不会影响已有的集成配置和用户关联
  • 确保 安装应用 步骤已成功完成且未报错
  • 进入相关的 Slack 频道,执行 /invite @Flashduty 命令
  • 当看到 已加入 或 已由 xxx 添加至 xxx 的提示时,即表示添加成功
  • 将应用授权人添加到公共频道中
  • 参考上一问题的方法,将应用添加到频道中
先重试一次;仍报错请联系客服,并附上完整的报错文本。常见原因:
  • 请再次检查是否为应用配置了所需权限
  • 对于之前授权的 Slack IM 集成,需要您在 Flashduty On-call 集成配置页中对 Slack 手动进行重新授权,以使应用获得 AI SRE 所需权限
  • 请参考 作战室介绍文档 的 常见问题 部分