Skip to main content

​
飛書日程

飛書日程能力可以把產品中的會議、預約、排班和提醒流程接入飛書日曆。啟用後，superun 可以根據你的業務需求，幫助產品建立、查詢、更新或同步飛書日程。

​
適合什麼場景

  • 在產品中建立會議後，同步生成飛書日程。
  • 查詢成員可用時間，輔助安排會議或預約。
  • 將報名、面試、拜訪等業務節點同步到日曆。
  • 在產品頁面展示用戶的飛書日程或會議安排。

​
接入前需要準備

飛書日曆通常需要同時具備「讀取」和「寫入」兩類權限。只開通寫入權限時，查詢主日曆或讀取日程可能仍會失敗。

​
飛書後台需要開通的權限

進入飛書開放平台 → 找到你的企業自建應用 →「權限管理」，申請下面兩條 user 類型 權限。日程能力建議兩條同時開通。 推薦使用飛書權限管理中的「批量導入」：
calendar:calendar 雖然名字裡沒有 write，但在當前接入中不能替代讀取權限。需要查詢日程、查詢主日曆或做「先讀後寫」的流程時，必須同時申請 calendar:calendar:readonly。
權限申請後還需要完成「建立版本 → 提交審批 → 發佈」。沒有發佈新版本時，用戶重新授權頁面不會展示新增的日曆權限。

​
如何在 superun 中啟用

1

確認飛書登入已接入

日程能力依賴飛書登入授權。建議先讓目標用戶至少完成一次飛書登入。
2

在飛書後台開通日曆權限

同時申請日曆讀取和寫入權限，並發佈飛書應用新版本。
3

啟用飛書日程

在「研發」→「技能庫」點擊「飛書日程」，描述你希望接入的日程場景。
4

補充業務規則

說明什麼時候建立日程、參與人來自哪裡、是否需要會議室、提醒時間和同步方向。
5

完成授權測試

按提示在飛書授權頁同意新增日曆權限，然後在產品中測試建立或查詢日程。

​
常見問題

登入預設只會申請基礎身份權限。日程屬於額外能力，需要在飛書後台開通日曆權限，並讓用戶重新授權。
可以按業務簡化功能，但實際實現中通常仍需要讀取主日曆、校驗日程或同步結果，因此建議一次性開通讀取和寫入權限。
通常是應用新版本還沒有發佈。權限申請通過後，需要進入「版本管理與發佈」建立並發佈新版本。