跳转到主要内容

​
飞书插件

飞书插件是 superun 连接飞书开放平台的基础能力。启用后，你可以把飞书账号、组织架构、群消息、机器人通知、日程和任务接入到自己的产品中。 飞书能力采用“基础插件 + 子能力”的方式组织：基础插件负责保存飞书应用凭证和登录授权，子能力按业务场景逐个启用。你不需要一次接入所有能力。

​
可以接入哪些能力

​
接入前需要准备

  • 飞书开放平台管理员权限。
  • 一个企业自建应用，并取得 App ID 和 App Secret。
  • 已发布的 superun 项目域名，用于配置飞书回调地址和安全域名。
  • 根据要接入的子能力，在飞书后台开通对应权限，并创建新版本发布。
如果只接入飞书登录，通常只需要完成基础应用和登录权限配置。任务、日程等子能力会在需要时追加授权。

​
子能力权限速查

在飞书开放平台申请权限后，必须创建并发布新版本。任务、日程等 user 类型权限还需要用户重新同意授权。

​
推荐接入顺序

1

先启用飞书基础插件

在项目的「研发」→「技能库」中启用飞书插件，按提示填写飞书应用的 App ID 和 App Secret。
2

先跑通飞书登录

飞书登录会建立用户身份和授权基础。后续任务、日程等用户级能力会复用这套登录授权。
3

按场景启用子能力

根据业务需要继续启用飞书消息、日程、任务或通讯录，不需要重复配置基础凭证。
4

完成平台授权和测试

如果新开通了权限，需要在飞书开放平台发布新版本；涉及用户授权的能力，需要用户重新同意授权。

​
常见问题

通常不需要。任务、日程、消息和通讯录会复用飞书基础插件里的应用凭证。你只需要按对应能力补充飞书后台权限，并在需要时让用户重新授权。
飞书权限变更后需要创建新版本并发布。对于任务、日程这类用户级能力，用户还需要重新同意授权，新的权限才会生效。
可以。先启用飞书基础插件，再按业务需要启用某个子能力即可。

​
子能力说明

飞书消息

接入机器人通知、群消息、消息卡片和事件订阅。

飞书日程

接入日程创建、查询、会议安排和可用时间检查。

飞书任务

接入任务创建、负责人、状态同步和提醒流程。

飞书通讯录

接入成员查询、部门树、组织架构和身份映射。