> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 飞书日程

> 在 superun 中接入飞书日历和日程能力，支持会议安排、日程同步和可用时间查询。

# 飞书日程

飞书日程能力可以把产品中的会议、预约、排班和提醒流程接入飞书日历。启用后，superun 可以根据你的业务需求，帮助产品创建、查询、更新或同步飞书日程。

***

## 适合什么场景

* 在产品中创建会议后，同步生成飞书日程。
* 查询成员可用时间，辅助安排会议或预约。
* 将报名、面试、拜访等业务节点同步到日历。
* 在产品页面展示用户的飞书日程或会议安排。

***

## 接入前需要准备

| 准备项    | 说明                                               |
| ------ | ------------------------------------------------ |
| 飞书基础插件 | 先启用 [飞书插件](/superun/integrations/feishu)，并完成飞书登录 |
| 日历权限   | 在飞书开放平台同时开通日历读取和写入相关权限                           |
| 用户重新授权 | 如果用户之前只授权过登录，需要重新同意日历权限                          |
| 版本发布   | 权限变更后，需要创建新版本并发布                                 |

<Warning>
  飞书日历通常需要同时具备“读取”和“写入”两类权限。只开通写入权限时，查询主日历或读取日程可能仍会失败。
</Warning>

***

## 飞书后台需要开通的权限

进入飞书开放平台 → 找到你的企业自建应用 →「权限管理」，申请下面两条 **user 类型**权限。日程能力建议两条同时开通。

| 权限 key                       | 权限名称    | 类型   | 用途                         |
| ---------------------------- | ------- | ---- | -------------------------- |
| `calendar:calendar:readonly` | 读取日历与日程 | user | 查询主日历、读取日程列表、读取日程详情、检查日程数据 |
| `calendar:calendar`          | 写入日历与日程 | user | 创建、编辑、删除日程，处理参会人和会议相关写入    |

推荐使用飞书权限管理中的「批量导入」：

```json theme={null}
{
  "scopes": {
    "tenant": [],
    "user": ["calendar:calendar:readonly", "calendar:calendar"]
  }
}
```

<Warning>
  `calendar:calendar` 虽然名字里没有 `write`，但在当前接入中不能替代读取权限。需要查询日程、查询主日历或做“先读后写”的流程时，必须同时申请 `calendar:calendar:readonly`。
</Warning>

权限申请后还需要完成「创建版本 → 提交审批 → 发布」。没有发布新版本时，用户重新授权页面不会展示新增的日历权限。

***

## 如何在 superun 中启用

<Steps>
  <Step title="确认飞书登录已接入">
    日程能力依赖飞书登录授权。建议先让目标用户至少完成一次飞书登录。
  </Step>

  <Step title="在飞书后台开通日历权限">
    同时申请日历读取和写入权限，并发布飞书应用新版本。
  </Step>

  <Step title="启用飞书日程">
    在「研发」→「技能库」点击「飞书日程」，描述你希望接入的日程场景。
  </Step>

  <Step title="补充业务规则">
    说明什么时候创建日程、参与人来自哪里、是否需要会议室、提醒时间和同步方向。
  </Step>

  <Step title="完成授权测试">
    按提示在飞书授权页同意新增日历权限，然后在产品中测试创建或查询日程。
  </Step>
</Steps>

***

## 常见问题

<AccordionGroup>
  <Accordion title="为什么已经能飞书登录，但日程接口还是提示权限不足？">
    登录默认只会申请基础身份权限。日程属于额外能力，需要在飞书后台开通日历权限，并让用户重新授权。
  </Accordion>

  <Accordion title="可以只做创建日程，不读取日程吗？">
    可以按业务简化功能，但实际实现中通常仍需要读取主日历、校验日程或同步结果，因此建议一次性开通读取和写入权限。
  </Accordion>

  <Accordion title="为什么飞书后台已经申请权限，授权页还是没有新增权限？">
    通常是应用新版本还没有发布。权限申请通过后，需要进入「版本管理与发布」创建并发布新版本。
  </Accordion>
</AccordionGroup>