一、创建飞书应用
1. 创建自建应用
访问 飞书开发者后台，创建企业内自建应用。应用图标可使用 Flashduty 官方 icon。 详见飞书开发文档 创建企业自建应用。
2. 复制凭证信息
前往 凭证与基础信息 页面，复制App ID 和 App Secret 备用。
3. 复制事件回调的 Token 信息
前往 开发配置 → 事件与回调 → 加密策略 页面，生成并复制Encrypt Key（推荐启用，更安全）和 Verification Token 备用。
二、添加飞书集成
回到 Flashduty On-call 集成中心 页面，选择 即时消息 → 飞书，在表单中填入
名称 以及上一步复制的 App ID、App Secret、Verification Token 和 Encrypt Key 后，点击 保存 完成创建。
创建成功后，您将在列表中看到已添加的飞书集成。点击其名称进入详情页面，即可查看 网页配置 地址、重定向 URL 和 消息卡片请求网址，这些信息将在后续步骤中使用。
三、配置飞书应用
1. 开通并配置应用能力
- 回到飞书开发者后台，进入刚才创建的飞书应用，进入 添加应用能力 → 按能力添加 页面，同时开通 网页应用 和 机器人 能力。
- 前往 网页应用 页面，配置
桌面端主页和移动端主页，内容均为集成详情中的 网页配置 地址。详见飞书开发文档 配置应用主页地址。
- 前往 事件回调 → 事件配置 页面，配置
订阅方式（内容为集成详情中的 消息卡片请求网址）。然后，添加以下两项事件：
im.chat.disbanded_v1im.message.receive_v1
- 前往 事件回调 → 回调配置 页面，配置
订阅方式（内容为集成详情中的 消息卡片请求网址）。然后，订阅以下两项回调：
card.action.triggercard.action.trigger_v1
2. 添加重定向 URL 到飞书应用
进入 安全设置 页面，配置重定向URL，内容为集成详情中的 重定向 URL。
详见飞书开发文档 配置重定向 URL。
3. 申请应用权限
进入 权限管理 页面，为先前步骤创建的群应用申请以下权限：im:chat：获取与更新群组信息im:message：获取与发送单聊、群组消息contact:user.id:readonly：通过手机号或邮箱获取用户 ID
四、应用发布与使用
完成上述所有配置后，请发布应用。待管理员审核通过后即可使用。详见飞书开发文档 应用发布与使用。为了确保所有人可以使用应用，需将应用 可见范围 调整为全部员工，再进行应用发布。
应用发布后，即可通过 手机端 或 PC 端 访问应用。首次访问需要登录并关联飞书与 Flashduty 账号，后续可以免登录使用。
- 手机端
- PC 端
飞书 → 工作台 → 搜索应用名称 → 打开应用
五、配置作战室
确保应用已被授权使用作战室功能所需的额外权限。完成先前步骤后，在 Flashduty On-call 集成配置页面的 增强功能 模块，勾选 开启作战室 即可启用该功能，无需额外配置。
六、常见问题
消息无法投递到个人，操作记录提示「未关联应用」？
消息无法投递到个人，操作记录提示「未关联应用」？
前往 飞书 → 工作台 → 搜索应用名称 → 打开应用，完成一次登录以关联飞书与 Flashduty 账号，系统才能获取用户身份进行消息推送。
消息卡片按钮点击无效或报错？
消息卡片按钮点击无效或报错？
- 确保账户已经完成关联。您可以前往 飞书 → 工作台 → 搜索应用名称 → 打开应用，完成一次登录。如果已经登录过，请尝试点击右上角菜单，切换账户后重新登录以绑定账号
- 确保已购买足够的 License。已使用 License 情况，可以在 控制台 → 费用中心 查看
分派策略飞书群聊列表为空？
分派策略飞书群聊列表为空？
- 前往飞书，在指定群聊会话中添加已创建的 Flashduty 机器人
- 回到分派策略配置页面，刷新后重新选择群聊列表
飞书自建应用 API 限制？
飞书自建应用 API 限制？
调用量限制：
频控限制：
| 飞书版本 | 调用总量/月 | 刷新时间 |
|---|---|---|
| 基础免费版 | 10,000 次 | 每月 1 日 |
| 其他版本 | 不限制 | - |
| 场景 | 限制 |
|---|---|
| 所有接口 | 每个应用最高频率 50 次/秒 |
| 发消息接口 | 每个应用最高频率 1000 次/分钟 |
| 群机器人 Webhook | 最高频率 100 次/分钟 |
| 给同一个用户或同一个群发消息 | 最高频率 5 次/秒 |