​

飞书插件

飞书插件是 superun 与飞书之间的连接层。它的作用是：把你团队在飞书里已有的账号、群聊、机器人，直接变成业务系统的一部分，不需要你从零搭建。 如果你的团队日常用飞书办公，那么飞书插件可以帮你省掉大量”搬运”工作：

• 用户不用再注册新账号，飞书扫码就能登录你的系统
• 群里讨论的重要信息，不会被刷屏淹没，而是沉淀到看板里
• 系统发生变化时，机器人自动把消息推到飞书群，不用人工通知

---

​

飞书插件能做什么

superun 飞书插件提供三类核心能力，分别解决身份、消息推送、消息接收三个层面的问题：

---

​

各能力详解

​

1. 飞书扫码登录 — 身份打通

做什么：让你的网站或系统支持飞书扫码登录。用户打开页面，用飞书 App 扫一下二维码，就完成了登录，不需要注册账号、填写密码。 为什么需要： 很多内部系统面临一个矛盾——团队已经全员在飞书上了，但登录业务系统还要单独注册。这导致：

• 新用户嫌麻烦，不愿注册，流失在第一步
• 管理员要手动维护一套账号体系，反复处理”忘记密码”
• 无法限制”只有公司员工才能登录”

飞书扫码登录一次解决这三个问题。而且它还支持企业白名单——你可以配置”只有某个企业的飞书员工才能登录”，外部人员即使扫码也无法进入。 适合什么场景：

• 企业内部管理系统（OA、CRM、项目管理等），只希望公司员工能访问
• 客户门户，希望降低用户首次登录门槛
• 需要基于飞书组织架构做权限控制的系统

---

​

2. 飞书机器人消息推送 — 消息推出去

做什么：让你的系统能够主动给飞书群或个人发送消息。支持纯文本、富文本和交互卡片（带按钮的消息），有两种发送方式可选。 为什么需要： 业务系统里发生了重要事件（订单到了、审批通过了、服务器报警了），团队怎么知道？传统做法是——有人盯着看，然后去群里手动发消息。这显然不够及时，也不可靠。 机器人消息推送把这个环节自动化了。系统有变化时，自动往飞书群里发一条消息，相关人员第一时间就能看到。飞书消息的打开率远高于邮件，几乎不会漏看。 superun 提供两种推送方式，适合不同阶段： 适合什么场景：

• 监控告警：服务器异常、接口报错时，自动给运维群发告警卡片
• 业务通知：审批通过、订单状态变更、任务分配时，即时通知相关人
• 定时报表：每日/每周自动推送业务数据摘要到管理层群组
• 流程自动化：CI/CD 完成、数据处理结束后，自动汇报结果到责任人

---

​

3. 群消息看板 — 消息收进来

做什么：把飞书机器人所在的多个群聊消息，统一聚合到一个 Web 看板上展示。新消息实时推送到看板，也可以手动拉取历史消息。 为什么需要： 群消息是飞书里最活跃的信息流，但也是最容易丢失的——消息被新消息刷走之后，想回头找就很困难。特别是当你需要同时关注多个群的时候，逐个群翻找信息非常低效。 群消息看板解决的就是这个问题：

• 多个群的消息汇聚到一个页面，一屏掌握全局
• 消息自动存储到数据库，不怕丢失，支持随时回溯
• 新消息实时出现在看板上，不需要手动刷新

适合什么场景：

• 运维监控中心：告警群、发布群的消息聚合到统一看板，运维人员无需逐群翻找
• 客服管理：监听多个客户群的消息，按客户分组展示对话流，便于管理和跟进
• 项目协作：各项目群的进度汇报、问题反馈实时同步到项目管理面板
• 合规审计：金融、法务等场景需要留存群内沟通记录，看板提供结构化存储和查询

---

​

能力之间的关系

三个能力并非完全独立，它们之间有明确的依赖关系：

• 扫码登录 可以独立使用，不依赖其他能力
• 群消息看板 强依赖 机器人消息推送——因为需要先把机器人添加到群里，才能接收群消息

所以如果你的目标是群消息看板，需要先完成机器人的配置。

---

​

如何决定从哪个能力开始

不需要一次全部接入。建议根据你当前最痛的问题，选择一个能力先跑通： 先跑通一个场景，验证效果，再逐步叠加其他能力。

---

​

接入前的准备

所有飞书能力都有一个共同的前置步骤：在飞书开放平台创建一个企业自建应用。

---

​

下一步

确定了要使用哪个能力后，可以查看对应的详细指南：