钉钉

​

所需权限

在钉钉开放平台 权限管理 页面按需申请以下权限。基础通知只需要“基础”一组；开启作战室时再加第二组（qyapi_get_member_by_mobile 也用于一键关联用户）；启用钉钉 AI 流式卡片模板时再加第三组。

​

创建钉钉应用

​

方式一：扫码创建（推荐）

1. 在 Flashduty 新建钉钉集成，钉钉应用授权 默认为 扫码创建钉钉应用（推荐）。
2. 点击 保存，使用钉钉扫描弹出的二维码，并选择要创建应用的组织（需要是该组织的管理员或开发者）。

扫码确认后，Flashduty 会自动完成以下操作：

• 创建钉钉应用，默认名称为 Flashduty
• 获取 AgentId、Client ID 和 Client Secret
• 开启机器人，并向创建者发送一条欢迎消息
• 生成事件订阅所需的 加密 aes_key 和 签名 token，只在创建完成的弹窗里显示一次，请先复制

​

方式二：已有应用，填写凭证

1. 访问 钉钉开发者后台 → 应用开发 → 企业内部开发，创建应用，图标可使用 Flashduty 官方 icon。详见钉钉开发文档 创建企业内部应用-H5 微应用。
2. 点击页面右上角企业头像，在下拉菜单中复制 CorpId。
3. 进入应用详情，通过左侧菜单栏前往 应用能力 → 凭证与基础信息 页面，复制 AgentId、Client ID 和 Client Secret。
4. 回到 Flashduty 钉钉集成配置页，在表单中填入 CorpId、AgentId、Client ID 和 Client Secret，点击 保存。

事件订阅用的 加密 aes_key 和 签名 token 由 Flashduty 生成，无需在钉钉中生成。它们只在保存前的表单里显示一次，请在保存前复制。 两种方式建好后，都按下一节「在钉钉完成配置」的 6 步操作；集成详情页的步骤编号与本节一致。

​

在钉钉完成配置

​

1. 开通权限

进入 开发配置 → 权限管理 页面，开通 qyapi_robot_sendmsg、qyapi_chat_manage 和 qyapi_get_member_by_mobile 三项基础权限。需要作战室或 AI 流式卡片时，一并开通所需权限中的其余权限。 集成详情页会显示缺少哪些基础权限，并提供直达每项权限的链接。

​

2. 配置事件订阅

进入 开发配置 → 事件订阅 页面，设置推送方式为 HTTP推送，然后填入集成详情页第 2 步显示的 请求网址，以及创建时复制的 加密 aes_key 和 签名 token，点击 保存。 出于安全考虑，加密 aes_key 和 签名 token 保存后不再显示。没有记下的话，在集成编辑页点 重新生成，保存后旧值失效，要把新值填到这里和群机器人的 消息回调 token。 在 保存 按钮下方，选中 群会话更换群名称、群内安装酷应用 和 群内卸载酷应用 三种群会话事件，点击 保存。

​

3. 配置机器人

进入 应用能力 → 机器人 页面，将 消息接收模式 从 Stream 切换为 HTTP，并将 消息接收地址 设置为集成详情页第 3 步显示的地址。上传机器人图标（可使用 Flashduty 官方 icon），点击 保存。

​

4. 添加网页应用

进入 应用能力 → 添加应用能力 → 网页应用，根据集成详情页显示的地址填写 应用首页地址 和 PC 端首页地址，点击 保存。

​

5. 创建酷应用

进入 开发配置 → 添加应用能力 → 酷应用 → 酷应用列表 页面，点击 创建酷应用，选择 扩展到群会话。 进入 编辑酷应用 页面，完成以下步骤：

1. 填写基本信息。图标可使用 Flashduty 官方 icon。
2. 配置功能设计。在左侧选中 群快捷入口 和 消息卡片。群快捷入口图标可使用 Flashduty 官方 icon，桌面端和移动端访问地址都填集成详情页第 5 步显示的地址。
3. 跳过第三步功能开发，进入第四步 预览发布，点击 发布 按钮并确认。

​

6. 调整可见范围并发布

进入 应用发布 → 版本管理与发布，将应用 可见范围 设置为全部员工，创建新版本并发布。步骤 3–5 的修改发布后才会生效；之后再调整应用配置，也需要重新发布。 应用发布后，即可通过 手机端 或 PC 端 访问应用，入口相同：钉钉 → 工作台 → 搜索应用名称 → 打开应用。首次访问需要登录并关联钉钉与 Flashduty 账号，后续可以免登录使用。

​

配置作战室

​

1. 申请应用权限

在 在钉钉完成配置 的步骤 1 中，除基础权限外，再开通 qyapi_chat_read 和 qyapi_chat_base_read（用途见所需权限）。若已开通，可跳过。

​

2. 配置群模板

通过钉钉开放平台顶部菜单栏，前往 开放能力 → 场景群。

1. 配置 群机器人。在左侧菜单栏中选择 机器人，然后点击 创建群机器人。
   这里的 群机器人 与上文的 应用机器人 不同，会在创建作战室群聊时自动加入群，二者的 机器人 ID 也不同。开启作战室必须额外配置群机器人。
   填写群机器人配置。若需要使用 AI SRE，请按下表配置 消息回调地址、消息回调 token 和 信息来源网站。这三项用于 AI SRE 的钉钉消息回调。
   钉钉的证书校验不兼容 api.flashcat.cloud 的 ACME 证书，因此消息回调地址需把域名换成 dingtalk-message.flashcat.cloud（见下表）。
   示例配置：

   配置项	值
   机器人名称	Flashduty
   机器人头像	Flashduty 官方 icon
   简介	Flashduty
   消息预览图	Flashduty 官方 icon
   详细描述	Flashduty 消息推送机器人。
   消息回调地址	Flashduty 集成配置页提供的消息地址，并将域名 api.flashcat.cloud 替换为 dingtalk-message.flashcat.cloud
   消息回调 token	与第 2 步填入钉钉的 签名 token 相同
   信息来源网站	https://www.flashduty.com

   完成配置后，点击 创建，然后点击 审批。右上角弹出 “提交成功” 后，钉钉已自动完成群机器人的审批。
2. 配置 群模板。在左侧菜单栏中选择 群模板，点击 创建群模板。 将 企业类型 设置为 企业内部，将 可选应用 设置为已发布的自建应用（需已完成步骤 4 添加网页应用和步骤 6 发布）。然后，在下一步骤中填写模板信息。 模板名称、图标、描述、文案介绍、模板描述、图片介绍 等介绍性信息不会影响群模板功能的使用，您可选择任意满足要求的值进行配置。 示例配置：

   配置项	值
   模板名称	Flashduty 作战室
   图标	Flashduty 官方 icon
   描述	为活跃故障一键创建作战室。
   文案介绍	为活跃故障一键创建作战室。
   模板描述	为活跃故障一键创建作战室。
   图片介绍	Flashduty 官方 icon

   在 选择机器人 配置项中，点击 选择已创建的机器人，选择上一步骤中创建的群机器人。其他配置项保持默认。最后点击 保存编辑。 在 填写灰度群 步骤中，点击 创建灰度群，然后点击 发布灰度。 最后，再次点击左侧菜单栏的 群模板，然后点击进入刚才创建的群模板。点击 提交审核，待钉钉自动通过审核后，最后点击 发布。
3. 在已经发布的群模板详细信息页，复制 模板 ID 和 机器人 ID。 回到 Flashduty On-call 集成配置页面，在表单中填入对应的 模版 ID 和 机器人 ID，点击 保存 按钮。

​

AI SRE 控制项

在 增强功能 中配置以下 AI SRE 控制项，默认开启：

• 允许在 IM 中使用 AI SRE：无需开启作战室即可配置。开启后，可在该集成接入的群聊中 @ AI SRE，或在机器人私聊中直接发起对话；关闭后这两个入口都不会触发 AI SRE 回复。

如果账户尚未启用 AI SRE，以上配置暂不生效。 作战室创建后的自动 AI 故障分析不在本页配置：如需在作战室创建时自动发起一次，请在 自动化 中新建一条规则，触发方式选择 作战室创建触发，并选好要监听的协作空间与严重程度。

​

关联用户

在集成详情页的 关联用户 页签中，您可以查看团队成员与钉钉账号的关联状态，并快速完成批量关联。

​

查看关联状态

列表展示所有团队成员及其关联状态，可按 全部 / 已关联 / 未关联 筛选，也可按名称或邮箱搜索。

​

一键关联

当存在未关联的成员时，可以点击 一键关联 按钮。系统将尝试通过手机号换取钉钉开放平台的账号 ID 并自动关联，效果等同于成员使用相同手机号在钉钉平台登录 Flashduty。

​

常见问题