> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# 钉钉
> 通过集成钉钉自建应用，实现在钉钉端内接收和响应告警的能力
**版本要求**：IM 集成需要 On-call 专业版及以上订阅。[了解更多](https://flashcat.cloud/flashduty/price/)
本文档以钉钉开放平台新版为例。
## 一、创建钉钉应用与添加钉钉集成
### 1. 创建自建应用
访问 [钉钉开发者后台](https://open-dev.dingtalk.com/fe/app) → 应用开发 → **企业内部开发**，创建应用。
详见钉钉开发文档 [创建企业内部应用-H5 微应用](https://open.dingtalk.com/document/orgapp/microapplication-creation-and-release-process#title-ovn-666-1ty)。
应用图标可使用 [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png)。
### 2. 复制企业 `CorpId`
点击页面右上角企业头像，在下拉菜单中复制 `CorpId`。
回到 Flashduty On-call 集成配置页面，在表单中填入对应的 `CorpId`。
### 3. 复制应用凭证信息
进入创建的应用详情界面，通过左侧菜单栏前往 应用能力 → **凭证与基础信息** 页面，复制 `AgentId`、`Client ID` 和 `Client Secret`。
回到 Flashduty On-call 集成配置页面，在表单中填入对应的 `AgentId`、 `Client ID` 和 `Client Secret`。
### 4. 复制事件订阅信息
前往 开发配置 → **事件与回调** 页面。设置推送方式为 `HTTP推送`，然后点击按钮生成 `加密 aes_key` 和 `签名 Token`，并复制保存。
回到 Flashduty On-call 集成配置页面，在表单中填入对应的 `加密 aes_key` 和 `签名 Token`，点击 **保存** 按钮。
### 5. 配置事件订阅
进入 开发配置 → **事件订阅** 页面。
根据 Flashduty 集成详情中的 `事件订阅请求地址`，配置 **事件订阅请求网址**。配置完成后 **保存**。
在 **保存** 按钮下方，选中 `群会话更换群名称`、`群内安装酷应用` 和 `群内卸载酷应用` 三种群会话事件，配置完成后点击 **保存**。
### 6. 添加应用能力
创建酷应用。进入 开发配置 → 添加应用能力 → 酷应用 → **酷应用列表** 页面，点击 **创建酷应用** 按钮，选择 **扩展到群会话**。
进入 **编辑酷应用** 页面，完成以下步骤：
1. 填写基本信息。图标可使用 [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png)。
2. 配置功能设计。在左侧选中 **群快捷入口** 和 **消息卡片**。群快捷入口图标可使用 [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png)，桌面和移动端访问地址请复制集成详情里的 **酷应用网页地址**。
3. 跳过第三步功能开发，进入第四步 **预览发布**，点击 **发布** 按钮并确认。
### 7. 配置机器人与消息推送
进入 应用能力 → **机器人** 页面，打开机器人配置，填写名称并上传图标，然后点击 **保存**。图标可使用 [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png)。
### 8. 配置应用地址
进入 应用能力 → **网页应用** 页面。
根据 Flashduty 集成详情中的 `应用首页地址` 和 `PC 端首页地址`，配置 **应用首页地址** 和 **PC 端首页地址**。完成后点击 **保存**。
### 9. 申请应用权限
进入 开发配置 → **权限管理** 页面，为先前步骤创建的群应用申请以下权限：
* `qyapi_chat_manage`：获取群聊信息
* `qyapi_robot_sendmsg`：向群聊或个人发送消息
## 二、配置作战室
若您无需配置作战室功能，可跳过本步骤，直接进入 [**应用发布与使用**](#publish)。
### 1. 申请应用权限
进入 开发配置 → **权限管理** 页面，为先前步骤创建的群应用申请以下权限：
* `qyapi_chat_read`：获取群聊信息
* `qyapi_chat_base_read`：获取群聊信息
* `qyapi_get_member_by_mobile`：允许当前应用根据手机号获取钉钉用户以便邀请用户加入群聊
### 2. 配置群模板
通过钉钉开放平台顶部菜单栏，前往 开放能力 → **场景群**。
1. 配置 **群机器人**。在左侧菜单栏中选择 **机器人**，然后点击 **创建群机器人**。
本步骤中配置的 **群机器人** 和 **应用机器人** 是两个不同的概念。群机器人被用于在生成群聊时自动创建群机器人。群机器人和应用机器人拥有不同的 **机器人 ID**。若要为钉钉开启作战室功能，必须额外配置 **群机器人**。
填写群机器人配置。**消息回调地址**、**消息回调 token**、**信息来源网站** 三项配置在 Flashduty On-call 的应用场景中并无实际作用，您可选择任意满足要求的值进行配置。
**示例配置**：
| **配置项** | **值** |
| ---------- | ------------------------------------------------------------------------------- |
| 机器人名称 | Flashduty |
| 机器人头像 | [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
| 简介 | Flashduty |
| 消息预览图 | [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
| 详细描述 | Flashduty 消息推送机器人。 |
| 消息回调地址 | `https://flashcat.cloud/` |
| 消息回调 token | `token` |
| 信息来源网站 | `https://flashcat.cloud/` |
完成配置后，点击 **创建**，然后点击 **审批**。右上角弹出 “提交成功” 后，钉钉已自动完成群机器人的审批。
2. 配置 **群模板**。在左侧菜单栏中选择 **群模板**，点击 **创建群模板**。
将 **企业类型** 设置为 `企业内部`，将 **可选应用** 设置为先前步骤创建的自建应用。然后，在下一步骤中填写模板信息。
**模板名称**、**图标**、**描述**、**文案介绍**、**模板描述**、**图片介绍** 等介绍性信息不会影响群模板功能的使用，您可选择任意满足要求的值进行配置。
**示例配置**：
| **配置项** | **值** |
| ------- | ------------------------------------------------------------------------------- |
| 模板名称 | Flashduty 作战室 |
| 图标 | [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
| 描述 | 为活跃故障一键创建作战室。 |
| 文案介绍 | 为活跃故障一键创建作战室。 |
| 模板描述 | 为活跃故障一键创建作战室。 |
| 图片介绍 | [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png) |
在 **选择机器人** 配置项中，点击 **选择已创建的机器人**，选择上一步骤中创建的群机器人。其他配置项保持默认。最后点击 **保存编辑**。
在 **填写灰度群** 步骤中，点击 **创建灰度群**，然后点击 **发布灰度**。
最后，再次点击左侧菜单栏的 **群模板**，然后点击进入刚才创建的群模板。点击 **提交审核**，待钉钉自动通过审核后，最后点击 **发布**。
3. 在已经发布的群模板详细信息页，复制 **模板 ID** 和 **机器人 ID**。
回到 Flashduty On-call 集成配置页面，在表单中填入对应的 `模版 ID` 和 `机器人 ID`，点击 **保存** 按钮。
同一时间仅支持在一个 IM 集成中开启作战室功能。如果你已在其他 IM 集成（如飞书、Slack、企业微信）中启用了作战室，需要先在该集成中关闭后，才能在当前钉钉集成中开启。
## 三、应用发布与使用
完成上述步骤后，前往 应用发布 → **版本管理与发布**，创建新版本并发布。
为了确保所有人可以使用应用，需将应用 **可见范围** 调整为全部员工，再进行应用发布。
应用发布后，即可通过 **手机端** 或 **PC 端** 访问应用。首次访问需要登录并关联钉钉与 Flashduty 账号，后续可以免登录使用。
钉钉 → 工作台 → 搜索应用名称 → **打开应用**
钉钉 → 工作台 → 搜索应用名称 → **打开应用**
## 四、关联用户
在集成详情页的 **关联用户** 页签中，你可以查看团队成员与钉钉账号的关联状态，并快速完成批量关联。
### 查看关联状态
关联用户列表展示所有团队成员及其关联状态。你可以通过以下方式筛选：
| 筛选项 | 说明 |
| :------ | :-------------- |
| **全部** | 查看所有团队成员 |
| **已关联** | 仅查看已完成钉钉账号关联的成员 |
| **未关联** | 仅查看尚未关联钉钉账号的成员 |
支持通过名称或邮箱搜索成员。
### 一键关联
当存在未关联的成员时，可以点击 **一键关联** 按钮。系统将尝试通过手机号换取钉钉开放平台的账号 ID 并自动关联，效果等同于成员使用相同手机号在钉钉平台登录 Flashduty。
成员完成关联后，系统才能向其推送钉钉消息通知。如果关联失败，请确认成员的手机号是否与钉钉账号一致。
## 五、常见问题
前往 钉钉 → 工作台 → 搜索应用名称 → **打开应用**，完成一次登录以关联钉钉与 Flashduty 账号，系统才能获取用户身份并推送消息。
* 前往 钉钉 → 工作台 → 搜索应用名称 → **打开应用**，完成一次登录以关联钉钉与 Flashduty 账号。如果已经登录过，尝试点击右上角菜单，切换账户，重新登录来绑定账号
* 确保您已购买足够的 License。已使用 License 情况，可以在 控制台 → [**费用中心**](https://console.flashcat.cloud/wallet) 查看
1. 前往钉钉，选择群聊会话安装酷应用，否则无法获取群聊列表
2. 回到分派策略配置页面，刷新后重新选择群聊列表
3. 如果仍然无法获取群聊列表，请尝试在群内卸载酷应用后，重试以上步骤。如果问题依旧，请联系客户或专属技术支持
* 请再次检查是否为应用配置了作战室功能[所需权限](#war-room-scope)
* 请参考 [作战室介绍文档](/zh/on-call/advanced/war-room) 的 **常见问题** 部分
| **钉钉版本** | **调用总量/月** | **QPS** | **刷新时间** |
| :------: | :--------: | :-----: | :------: |
| 标准版 | 10,000 次 | 20 | 每月 1 日 |
| 专业版 | 50 万次 | 40 | 每月 1 日 |
| 专属版 | 550 万次 | 60 | 每月 1 日 |
超出 API 调用量限制后，钉钉应用将无法正常推送消息。建议合理使用通知渠道。详见 [钉钉官方文档](https://open.dingtalk.com/document/orgapp/descriptions-about-adjusting-limit-and-frequency-of-api-calls?spm=ding_open_doc.document.0.0.6f6b21d9WtkxJI)。