飞书日程

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

飞书日程

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

---

适合什么场景

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

---

接入前需要准备

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

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

---

飞书后台需要开通的权限

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

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

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

{
  "scopes": {
    "tenant": [],
    "user": ["calendar:calendar:readonly", "calendar:calendar"]
  }
}

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

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

---

如何在 superun 中启用

1. 确认飞书登录已接入

   日程能力依赖飞书登录授权。建议先让目标用户至少完成一次飞书登录。

2. 在飞书后台开通日历权限

   同时申请日历读取和写入权限，并发布飞书应用新版本。

3. 启用飞书日程

   在「研发」→「技能库」点击「飞书日程」，描述你希望接入的日程场景。

4. 补充业务规则

   说明什么时候创建日程、参与人来自哪里、是否需要会议室、提醒时间和同步方向。

5. 完成授权测试

   按提示在飞书授权页同意新增日历权限，然后在产品中测试创建或查询日程。

---

常见问题

为什么已经能飞书登录，但日程接口还是提示权限不足？

登录默认只会申请基础身份权限。日程属于额外能力，需要在飞书后台开通日历权限，并让用户重新授权。

可以只做创建日程，不读取日程吗？

可以按业务简化功能，但实际实现中通常仍需要读取主日历、校验日程或同步结果，因此建议一次性开通读取和写入权限。

为什么飞书后台已经申请权限，授权页还是没有新增权限？

通常是应用新版本还没有发布。权限申请通过后，需要进入「版本管理与发布」创建并发布新版本。