> ## 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.

# 飞书/Lark

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

<Tip>**版本要求**：IM 集成需要 On-call 专业版及以上订阅。[了解更多](https://flashcat.cloud/flashduty/price/)</Tip>

<div className="hide" />

## 一、创建飞书应用

***

### 1. 创建自建应用

访问 [飞书开发者后台](https://open.feishu.cn/app)，创建企业内自建应用。应用图标可使用 [Flashduty 官方 icon](https://download.flashcat.cloud/flashcat_logo_circular.png)。

详见飞书开发文档 [创建企业自建应用](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#132c1aac)。

![2025-09-18-10-37-08](https://docs-cdn.flashcat.cloud/images/png/d456a3be638252127dde907617d63fb7.png)

### 2. 复制凭证信息

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

![2025-09-18-10-38-52](https://docs-cdn.flashcat.cloud/images/png/69f98fad9e5a076aac5f9b0058ebd8dc.png)

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

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

![2025-09-18-10-42-01](https://docs-cdn.flashcat.cloud/images/png/ac558d48464310fe27ef97912b298df1.png)

## 二、添加飞书集成

***

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

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

![2025-09-18-10-44-00](https://docs-cdn.flashcat.cloud/images/png/1e8ffb6c39f99ef12bd85ae49992ebad.png)

## 三、配置飞书应用

***

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

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

![2025-09-18-10-45-48](https://docs-cdn.flashcat.cloud/images/png/5ab84aec1593c7118782765676a51c6a.png)

2. 前往 **网页应用** 页面，配置 `桌面端主页` 和 `移动端主页`，内容均为集成详情中的 **网页配置** 地址。详见飞书开发文档 [配置应用主页地址](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step1#8366b844)。

![2025-09-18-10-47-46](https://docs-cdn.flashcat.cloud/images/png/d91efc598bda17e1bfcb367aec47c779.png)

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

* `im.chat.disbanded_v1`
* `im.message.receive_v1`

![2025-09-18-11-06-05](https://docs-cdn.flashcat.cloud/images/png/71910d8af8d60b5f30baf009081646df.png)

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

* `card.action.trigger`
* `card.action.trigger_v1`

![2025-09-19-18-43-03](https://docs-cdn.flashcat.cloud/images/png/f58b20e52fc53f428bc493e18f0a567f.png)

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

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

详见飞书开发文档 [配置重定向 URL](https://open.feishu.cn/document/uYjL24iN/uYjN3QjL2YzN04iN2cDN?lang=zh-CN#c863e533)。

![2025-09-18-10-53-24](https://docs-cdn.flashcat.cloud/images/png/00a7cdd10c09c90c2d7b2f0a99ee4d8d.png)

### 3. 申请应用权限

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

* `im:chat`：获取与更新群组信息
* `im:message`：获取与发送单聊、群组消息
* `contact:user.id:readonly`：通过手机号或邮箱获取用户 ID
* `im:message.group_msg`：读取群聊历史消息（AI 生成复盘报告需要读取作战室聊天记录） <span id="war-room-scope" />

![2025-09-18-10-55-14](https://docs-cdn.flashcat.cloud/images/png/d919be62107f6b9d0c662f440d620e61.png)

## 四、应用发布与使用

完成上述所有配置后，请发布应用。待管理员审核通过后即可使用。详见飞书开发文档 [应用发布与使用](https://open.feishu.cn/document/uYjL24iN/uMTMuMTMuMTM/development-guide/step-4)。

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

![2025-09-18-10-56-20](https://docs-cdn.flashcat.cloud/images/png/6bbc285986808af14c29d0eb633a2bf7.png)

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

<Tabs>
  <Tab title="手机端">
    飞书 → 工作台 → 搜索应用名称 → **打开应用**
  </Tab>

  <Tab title="PC 端">
    飞书 → 工作台 → 搜索应用名称 → **打开应用**
  </Tab>
</Tabs>

![2025-09-18-10-57-46](https://docs-cdn.flashcat.cloud/images/png/eed8557808874a0c488b958c4049ea72.png)

## 五、配置作战室

> 确保应用已被授权使用作战室功能所需的[额外权限](#war-room-scope)。

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

<Warning>
  同一时间仅支持在一个 IM 集成中开启作战室功能。如果你已在其他 IM 集成（如钉钉、Slack、企业微信）中启用了作战室，需要先在该集成中关闭后，才能在当前飞书集成中开启。
</Warning>

## 六、关联用户

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

### 查看关联状态

关联用户列表展示所有团队成员及其关联状态。你可以通过以下方式筛选：

| 筛选项     | 说明              |
| :------ | :-------------- |
| **全部**  | 查看所有团队成员        |
| **已关联** | 仅查看已完成飞书账号关联的成员 |
| **未关联** | 仅查看尚未关联飞书账号的成员  |

支持通过名称或邮箱搜索成员。

### 一键关联

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

<Tip>
  成员完成关联后，系统才能向其推送飞书消息通知。如果关联失败，请确认成员的手机号或邮箱是否与飞书账号一致。
</Tip>

## 七、常见问题

<AccordionGroup>
  <Accordion title="消息无法投递到个人，操作记录提示「未关联应用」？">
    前往 飞书 → 工作台 → 搜索应用名称 → **打开应用**，完成一次登录以关联飞书与 Flashduty 账号，系统才能获取用户身份进行消息推送。
  </Accordion>

  <Accordion title="消息卡片按钮点击无效或报错？">
    * 确保账户已经完成关联。您可以前往 飞书 → 工作台 → 搜索应用名称 → **打开应用**，完成一次登录。如果已经登录过，请尝试点击右上角菜单，切换账户后重新登录以绑定账号
    * 确保已购买足够的 License。已使用 License 情况，可以在 控制台 → **费用中心** 查看
  </Accordion>

  <Accordion title="分派策略飞书群聊列表为空？">
    * 前往飞书，在指定群聊会话中添加已创建的 Flashduty 机器人
    * 回到分派策略配置页面，刷新后重新选择群聊列表

    ![2025-09-18-14-24-40](https://docs-cdn.flashcat.cloud/images/png/0e21e9e689855d9a636fb94848f58c13.png)
  </Accordion>

  <Accordion title="飞书自建应用 API 限制？">
    **调用量限制：**

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

    **频控限制：**

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

    <Warning>
      超出 API 调用量限制后，飞书应用将无法正常推送消息，建议合理使用通知渠道。详见 [飞书官方文档](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/platform-updates-/custom-app-api-call-limit)。
    </Warning>
  </Accordion>

  <Accordion title="为什么作战室功能未按预期工作？">
    * 请再次检查是否为应用配置了作战室功能[所需权限](#war-room-scope)
    * 请参考 [作战室介绍文档](/zh/on-call/advanced/war-room) 的 **常见问题** 部分
  </Accordion>
</AccordionGroup>