跳轉到主要內容

飛書插件

飛書插件是 superun 與飛書之間的連接層。它的作用是:把你團隊在飛書裡已有的帳號、群聊、機器人,直接變成業務系統的一部分,不需要你從零搭建。 如果你的團隊日常用飛書辦公,那麼飛書插件可以幫你省掉大量「搬運」工作:
  • 用戶不用再註冊新帳號,飛書掃碼就能登入你的系統
  • 群裡討論的重要資訊,不會被刷屏淹沒,而是沉澱到看板裡
  • 系統發生變化時,機器人自動把訊息推到飛書群,不用人工通知

飛書插件能做什麼

superun 飛書插件提供三類核心能力,分別解決身份、訊息推送、訊息接收三個層面的問題:
能力一句話說明解決什麼問題
掃碼登入用飛書帳號直接登入你的系統不用再維護獨立的帳號體系
機器人訊息推送從系統主動給飛書群/個人發訊息不用人工去群裡通知
群訊息看板把飛書群聊訊息聚合到 Web 看板不用翻聊天記錄找關鍵資訊

各能力詳解

1. 飛書掃碼登入 — 身份打通

做什麼:讓你的網站或系統支援飛書掃碼登入。用戶打開頁面,用飛書 App 掃一下二維碼,就完成了登入,不需要註冊帳號、填寫密碼。 為什麼需要 很多內部系統面臨一個矛盾——團隊已經全員在飛書上了,但登入業務系統還要單獨註冊。這導致:
  • 新用戶嫌麻煩,不願註冊,流失在第一步
  • 管理員要手動維護一套帳號體系,反覆處理「忘記密碼」
  • 無法限制「只有公司員工才能登入」
飛書掃碼登入一次解決這三個問題。而且它還支援企業白名單——你可以配置「只有某個企業的飛書員工才能登入」,外部人員即使掃碼也無法進入。 適合什麼場景
  • 企業內部管理系統(OA、CRM、專案管理等),只希望公司員工能存取
  • 客戶門戶,希望降低用戶首次登入門檻
  • 需要基於飛書組織架構做權限控制的系統

2. 飛書機器人訊息推送 — 訊息推出去

做什麼:讓你的系統能夠主動給飛書群或個人發送訊息。支援純文字、富文本和互動卡片(帶按鈕的訊息),有兩種發送方式可選。 為什麼需要 業務系統裡發生了重要事件(訂單到了、審批通過了、伺服器報警了),團隊怎麼知道?傳統做法是——有人盯著看,然後去群裡手動發訊息。這顯然不夠及時,也不可靠。 機器人訊息推送把這個環節自動化了。系統有變化時,自動往飛書群裡發一條訊息,相關人員第一時間就能看到。飛書訊息的開啟率遠高於電子郵件,幾乎不會漏看。 superun 提供兩種推送方式,適合不同階段:
方式適合誰特點
Webhook 模式想 5 分鐘跑通的人在群裡新增一個自訂機器人,拿到 URL 就能發,不需要任何審批
API 模式需要靈活控制的人可以向任意群或個人發訊息,支援選擇發送目標,但需要配置應用憑證
適合什麼場景
  • 監控告警:伺服器異常、介面報錯時,自動給維運群發告警卡片
  • 業務通知:審批通過、訂單狀態變更、任務分配時,即時通知相關人
  • 定時報表:每日/每週自動推送業務資料摘要到管理層群組
  • 流程自動化:CI/CD 完成、資料處理結束後,自動回報結果到負責人
機器人訊息推送是群訊息看板的前置依賴。如果你想使用訊息看板,需要先完成機器人的配置和加群。

3. 群訊息看板 — 訊息收進來

做什麼:把飛書機器人所在的多個群聊訊息,統一聚合到一個 Web 看板上展示。新訊息即時推送到看板,也可以手動拉取歷史訊息。 為什麼需要 群訊息是飛書裡最活躍的資訊流,但也是最容易遺失的——訊息被新訊息刷走之後,想回頭找就很困難。特別是當你需要同時關注多個群的時候,逐個群翻找資訊非常低效。 群訊息看板解決的就是這個問題:
  • 多個群的訊息匯聚到一個頁面,一屏掌握全局
  • 訊息自動儲存到資料庫,不怕遺失,支援隨時回溯
  • 新訊息即時出現在看板上,不需要手動重新整理
適合什麼場景
  • 維運監控中心:告警群、發布群的訊息聚合到統一看板,維運人員無需逐群翻找
  • 客服管理:監聽多個客戶群的訊息,按客戶分組展示對話流,便於管理和跟進
  • 專案協作:各專案群的進度回報、問題回饋即時同步到專案管理面板
  • 合規稽核:金融、法務等場景需要留存群內溝通記錄,看板提供結構化儲存和查詢

能力之間的關係

三個能力並非完全獨立,它們之間有明確的依賴關係:
  • 掃碼登入 可以獨立使用,不依賴其他能力
  • 群訊息看板 強依賴 機器人訊息推送——因為需要先把機器人新增到群裡,才能接收群訊息
所以如果你的目標是群訊息看板,需要先完成機器人的配置。

如何決定從哪個能力開始

不需要一次全部接入。建議根據你當前最痛的問題,選擇一個能力先跑通:
你遇到的問題建議先做預期效果
用戶要單獨註冊帳號,流程繁瑣掃碼登入用戶用飛書掃碼直接進入系統
系統有變化需要人工去群裡通知機器人訊息推送系統自動發訊息到飛書群
群訊息太多太快,回頭找不到關鍵資訊群訊息看板多群訊息聚合到一個看板,可搜可回溯
先跑通一個場景,驗證效果,再逐步疊加其他能力。

接入前的準備

所有飛書能力都有一個共同的前置步驟:在飛書開放平台建立一個企業自建應用。
權限變更後需要建立新版本並發布才會生效——這是很多人第一次接入時容易忽略的步驟。

下一步

確定了要使用哪個能力後,可以查看對應的詳細指南:
能力詳細指南
飛書掃碼登入飛書掃碼 OAuth 登入指南
飛書機器人訊息推送飛書機器人訊息推送指南
群訊息看板群訊息看板快速指南