飞书日程

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

适合什么场景

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

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

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

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

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

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

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

确认飞书登录已接入

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

在飞书后台开通日历权限

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

启用飞书日程

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

补充业务规则

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

完成授权测试

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

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

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

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

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

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

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