飛書插件
飛書插件是 superun 與飛書之間的連接層。它的作用是:把你團隊在飛書裡已有的帳號、群聊、機器人,直接變成業務系統的一部分,不需要你從零搭建。
如果你的團隊日常用飛書辦公,那麼飛書插件可以幫你省掉大量「搬運」工作:
- 用戶不用再註冊新帳號,飛書掃碼就能登入你的系統
- 群裡討論的重要資訊,不會被刷屏淹沒,而是沉澱到看板裡
- 系統發生變化時,機器人自動把訊息推到飛書群,不用人工通知
飛書插件能做什麼
superun 飛書插件提供三類核心能力,分別解決身份、訊息推送、訊息接收三個層面的問題:
| 能力 | 一句話說明 | 解決什麼問題 |
|---|
| 掃碼登入 | 用飛書帳號直接登入你的系統 | 不用再維護獨立的帳號體系 |
| 機器人訊息推送 | 從系統主動給飛書群/個人發訊息 | 不用人工去群裡通知 |
| 群訊息看板 | 把飛書群聊訊息聚合到 Web 看板 | 不用翻聊天記錄找關鍵資訊 |
各能力詳解
1. 飛書掃碼登入 — 身份打通
做什麼:讓你的網站或系統支援飛書掃碼登入。用戶打開頁面,用飛書 App 掃一下二維碼,就完成了登入,不需要註冊帳號、填寫密碼。
為什麼需要:
很多內部系統面臨一個矛盾——團隊已經全員在飛書上了,但登入業務系統還要單獨註冊。這導致:
- 新用戶嫌麻煩,不願註冊,流失在第一步
- 管理員要手動維護一套帳號體系,反覆處理「忘記密碼」
- 無法限制「只有公司員工才能登入」
飛書掃碼登入一次解決這三個問題。而且它還支援企業白名單——你可以配置「只有某個企業的飛書員工才能登入」,外部人員即使掃碼也無法進入。
適合什麼場景:
- 企業內部管理系統(OA、CRM、專案管理等),只希望公司員工能存取
- 客戶門戶,希望降低用戶首次登入門檻
- 需要基於飛書組織架構做權限控制的系統
2. 飛書機器人訊息推送 — 訊息推出去
做什麼:讓你的系統能夠主動給飛書群或個人發送訊息。支援純文字、富文本和互動卡片(帶按鈕的訊息),有兩種發送方式可選。
為什麼需要:
業務系統裡發生了重要事件(訂單到了、審批通過了、伺服器報警了),團隊怎麼知道?傳統做法是——有人盯著看,然後去群裡手動發訊息。這顯然不夠及時,也不可靠。
機器人訊息推送把這個環節自動化了。系統有變化時,自動往飛書群裡發一條訊息,相關人員第一時間就能看到。飛書訊息的開啟率遠高於電子郵件,幾乎不會漏看。
superun 提供兩種推送方式,適合不同階段:
| 方式 | 適合誰 | 特點 |
|---|
| Webhook 模式 | 想 5 分鐘跑通的人 | 在群裡新增一個自訂機器人,拿到 URL 就能發,不需要任何審批 |
| API 模式 | 需要靈活控制的人 | 可以向任意群或個人發訊息,支援選擇發送目標,但需要配置應用憑證 |
適合什麼場景:
- 監控告警:伺服器異常、介面報錯時,自動給維運群發告警卡片
- 業務通知:審批通過、訂單狀態變更、任務分配時,即時通知相關人
- 定時報表:每日/每週自動推送業務資料摘要到管理層群組
- 流程自動化:CI/CD 完成、資料處理結束後,自動回報結果到負責人
機器人訊息推送是群訊息看板的前置依賴。如果你想使用訊息看板,需要先完成機器人的配置和加群。
3. 群訊息看板 — 訊息收進來
做什麼:把飛書機器人所在的多個群聊訊息,統一聚合到一個 Web 看板上展示。新訊息即時推送到看板,也可以手動拉取歷史訊息。
為什麼需要:
群訊息是飛書裡最活躍的資訊流,但也是最容易遺失的——訊息被新訊息刷走之後,想回頭找就很困難。特別是當你需要同時關注多個群的時候,逐個群翻找資訊非常低效。
群訊息看板解決的就是這個問題:
- 多個群的訊息匯聚到一個頁面,一屏掌握全局
- 訊息自動儲存到資料庫,不怕遺失,支援隨時回溯
- 新訊息即時出現在看板上,不需要手動重新整理
適合什麼場景:
- 維運監控中心:告警群、發布群的訊息聚合到統一看板,維運人員無需逐群翻找
- 客服管理:監聽多個客戶群的訊息,按客戶分組展示對話流,便於管理和跟進
- 專案協作:各專案群的進度回報、問題回饋即時同步到專案管理面板
- 合規稽核:金融、法務等場景需要留存群內溝通記錄,看板提供結構化儲存和查詢
能力之間的關係
三個能力並非完全獨立,它們之間有明確的依賴關係:
- 掃碼登入 可以獨立使用,不依賴其他能力
- 群訊息看板 強依賴 機器人訊息推送——因為需要先把機器人新增到群裡,才能接收群訊息
所以如果你的目標是群訊息看板,需要先完成機器人的配置。
如何決定從哪個能力開始
不需要一次全部接入。建議根據你當前最痛的問題,選擇一個能力先跑通:
| 你遇到的問題 | 建議先做 | 預期效果 |
|---|
| 用戶要單獨註冊帳號,流程繁瑣 | 掃碼登入 | 用戶用飛書掃碼直接進入系統 |
| 系統有變化需要人工去群裡通知 | 機器人訊息推送 | 系統自動發訊息到飛書群 |
| 群訊息太多太快,回頭找不到關鍵資訊 | 群訊息看板 | 多群訊息聚合到一個看板,可搜可回溯 |
先跑通一個場景,驗證效果,再逐步疊加其他能力。
接入前的準備
所有飛書能力都有一個共同的前置步驟:在飛書開放平台建立一個企業自建應用。
權限變更後需要建立新版本並發布才會生效——這是很多人第一次接入時容易忽略的步驟。
下一步
確定了要使用哪個能力後,可以查看對應的詳細指南: