飛書插件
飛書插件是 superun 連接飛書開放平台的基礎能力。啟用後,你可以把飛書帳號、組織架構、群訊息、機器人通知、日程和任務接入到自己的產品中。 飛書能力採用「基礎插件 + 子能力」的方式組織:基礎插件負責保存飛書應用憑證和登入授權,子能力按業務場景逐個啟用。你不需要一次接入所有能力。可以接入哪些能力
接入前需要準備
- 飛書開放平台管理員權限。
- 一個企業自建應用,並取得 App ID 和 App Secret。
- 已發佈的 superun 專案網域,用於配置飛書回呼地址和安全網域。
- 根據要接入的子能力,在飛書後台開通對應權限,並建立新版本發佈。
如果只接入飛書登入,通常只需要完成基礎應用和登入權限配置。任務、日程等子能力會在需要時追加授權。
子能力權限速查
建議接入順序
1
先啟用飛書基礎插件
在專案的「研發」→「技能庫」中啟用飛書插件,按提示填寫飛書應用的 App ID 和 App Secret。
2
先跑通飛書登入
飛書登入會建立用戶身份和授權基礎。後續任務、日程等用戶級能力會複用這套登入授權。
3
按場景啟用子能力
根據業務需要繼續啟用飛書訊息、日程、任務或通訊錄,不需要重複配置基礎憑證。
4
完成平台授權和測試
如果新開通了權限,需要在飛書開放平台發佈新版本;涉及用戶授權的能力,需要用戶重新同意授權。
常見問題
已經啟用了飛書登入,再啟用任務或日程還需要重新配置 App ID 嗎?
已經啟用了飛書登入,再啟用任務或日程還需要重新配置 App ID 嗎?
通常不需要。任務、日程、訊息和通訊錄會複用飛書基礎插件裡的應用憑證。你只需要按對應能力補充飛書後台權限,並在需要時讓用戶重新授權。
為什麼開通權限後還是提示權限不足?
為什麼開通權限後還是提示權限不足?
飛書權限變更後需要建立新版本並發佈。對於任務、日程這類用戶級能力,用戶還需要重新同意授權,新的權限才會生效。
可以只接入某一個子能力嗎?
可以只接入某一個子能力嗎?
可以。先啟用飛書基礎插件,再按業務需要啟用某個子能力即可。
子能力說明
飛書訊息
接入機器人通知、群訊息、訊息卡片和事件訂閱。
飛書日程
接入日程建立、查詢、會議安排和可用時間檢查。
飛書任務
接入任務建立、負責人、狀態同步和提醒流程。
飛書通訊錄
接入成員查詢、部門樹、組織架構和身份映射。

