飞书 Lark集成

通过集成飞书自建应用，您可以在飞书端内接收和响应告警。

一、创建飞书应用

1. 创建自建应用

访问飞书开发者后台，创建企业内自建应用。应用图标可使用 Flashduty 官方 icon。

详见飞书开发文档创建企业自建应用。

2. 复制凭证信息

前往 凭证与基础信息 页面，复制 App ID 和 App Secret 备用。

3. 复制事件回调的 Token 信息

前往开发配置 → 事件与回调 → 加密策略 页面，生成并复制 Encrypt Key（推荐启用，更安全）和 Verification Token 备用。

二、添加飞书集成

回到 Flashduty 集成中心 页面，选择即时消息 → 飞书，在表单中填入 名称 以及上一步复制的 App ID、App Secret、Verification Token 和 Encrypt Key 后，点击保存完成创建。

创建成功后，您将在列表中看到已添加的飞书集成。点击其名称进入详情页面，即可查看 网页配置 地址、重定向 URL 和 消息卡片请求网址，这些信息将在后续步骤中使用。

三、配置飞书应用

1. 开通并配置应用能力

回到飞书开发者后台，进入刚才创建的飞书应用，进入添加应用能力 → 按能力添加 页面，同时开通 网页应用 和 机器人 能力。

前往 网页应用 页面，配置 桌面端主页 和 移动端主页，内容均为集成详情中的 网页配置 地址。详见飞书开发文档配置应用主页地址。

前往事件回调 → 事件配置 页面，配置 订阅方式（内容为集成详情中的 消息卡片请求网址）。然后，添加以下两项事件：

im.chat.disbanded_v1

im.message.receive_v1

前往事件回调 → 回调配置 页面，配置 订阅方式（内容为集成详情中的 消息卡片请求网址）。然后，订阅以下两项回调：

card.action.trigger

card.action.trigger_v1

2. 添加重定向 URL 到飞书应用

进入 安全设置 页面，配置 重定向URL，内容为集成详情中的 重定向 URL。

详见飞书开发文档配置重定向 URL。

3. 申请应用权限

进入 权限管理 页面，为先前步骤创建的群应用申请以下权限：

im:chat：获取与更新群组信息

im:message：获取与发送单聊、群组消息

contact:user.id:readonly：通过手机号或邮箱获取用户 ID

四、应用发布与使用

完成上述所有配置后，请发布应用。待管理员审核通过后即可使用。

详见飞书开发文档应用发布与使用。

为了确保所有人可以使用应用，需将应用 可见范围 调整为全部员工，再进行应用发布。

应用发布后，即可通过 手机端 或 PC 端 访问应用。首次访问需要登录并关联飞书与 Flashduty 账号，后续可以免登录使用。

手机端：通过飞书 → 工作台 → 搜索应用名称 → 打开应用 使用网页应用。

PC 端：通过飞书 → 工作台 → 搜索应用名称 → 打开应用 使用网页应用。

五、配置作战室

确保应用已被授权使用作战室功能所需的额外权限。

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

六、常见问题

消息无法投递到个人，操作记录提示 未关联应用？

前往飞书 → 工作台 → 搜索应用名称 → 打开应用，完成一次登录以关联飞书与 Flashduty 账号，系统才能获取用户身份进行消息推送。

消息卡片按钮点击无效或报错？

确保账户已经完成关联。您可以前往飞书 → 工作台 → 搜索应用名称 → 打开应用，完成一次登录。如果已经登录过，请尝试点击右上角菜单，切换账户后重新登录以绑定账号。

确保已购买足够的 License。已使用 License 情况，可以在控制台 → 费用中心 查看。

分派策略飞书群聊列表为空？

前往飞书，在指定群聊会话中添加已创建的 Flashduty 机器人。

回到分派策略配置页面，刷新后重新选择群聊列表。

飞书自建应用 API 限制？

调用量限制：

飞书版本	调用总量/月	刷新时间
基础免费版	10,000 次	每月 1 日
其他版本	不限制	-

频控限制：

场景	限制
所有接口	每个应用最高频率 50 次/秒
发消息接口	每个应用最高频率 1000 次/分钟
群机器人 Webhook	最高频率 100 次/分钟
给同一个用户或同一个群发消息	最高频率 5 次/秒

超出 API 调用量限制后，飞书应用将无法正常推送消息，建议合理使用通知渠道。详见飞书官方文档。

为什么作战室功能未按预期工作？

请再次检查是否为应用配置了作战室功能所需权限。

请参考 Flashduty 作战室介绍文档的 常见问题 部分。

飞书 Lark 集成指引

视频介绍

一、创建飞书应用

1. 创建自建应用

2. 复制凭证信息

3. 复制事件回调的 Token 信息

二、添加飞书集成

三、配置飞书应用

1. 开通并配置应用能力

2. 添加重定向 URL 到飞书应用

3. 申请应用权限

四、应用发布与使用

五、配置作战室

六、常见问题

飞书 Lark 集成指引

视频介绍#

一、创建飞书应用#

1. 创建自建应用#

2. 复制凭证信息#

3. 复制事件回调的 Token 信息#

二、添加飞书集成#

三、配置飞书应用#

1. 开通并配置应用能力#

2. 添加重定向 URL 到飞书应用#

3. 申请应用权限#

四、应用发布与使用#

五、配置作战室#

六、常见问题#

视频介绍

一、创建飞书应用

1. 创建自建应用

2. 复制凭证信息

3. 复制事件回调的 Token 信息

二、添加飞书集成

三、配置飞书应用

1. 开通并配置应用能力

2. 添加重定向 URL 到飞书应用

3. 申请应用权限

四、应用发布与使用

五、配置作战室

六、常见问题