Skip to main content

​
飛書任務

飛書任務能力用於把產品裡的工作事項同步到飛書待辦中。它適合處理任務建立、負責人分配、截止時間、狀態同步和提醒等流程。

​
適合什麼場景

  • 表單提交後自動建立飛書任務。
  • 審批、客服、招聘、專案管理流程中自動分配負責人。
  • 將產品裡的任務狀態與飛書待辦保持同步。
  • 為關鍵事項設定截止時間和提醒，減少遺漏。

​
接入前需要準備

飛書任務是用戶級能力。誰建立或操作任務，通常取決於當前登入並完成授權的飛書用戶。

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

進入飛書開放平台 → 找到你的企業自建應用 →「權限管理」，申請下面兩條 user 類型 權限。 推薦使用飛書權限管理中的「批量導入」：
老權限 task:task / task:task:readonly 不適用於當前任務 v2 接入。即使舊專案裡保留了它們，也需要新增 task:task:read 和 task:task:write。
權限申請後還需要完成「建立版本 → 提交審批 → 發佈」。沒有發佈新版本時，superun 即使觸發重新授權，也拿不到新的任務權限。

​
如何在 superun 中啟用

1

確認飛書登入已接入

先讓相關用戶可以使用飛書登入你的產品。
2

在飛書後台開通任務權限

按上面的權限清單申請任務讀寫權限，並發佈飛書應用新版本。
3

啟用飛書任務

在「研發」→「技能庫」點擊「飛書任務」，描述你要接入的任務流程。
4

補充業務規則

說明任務從哪個業務動作生成、負責人如何確定、截止時間和提醒如何設定。
5

完成重新授權

按提示讓用戶同意新增的飛書任務權限，再測試建立、查詢或更新任務。

​
常見限制

  • 任務讀寫權限需要用戶重新授權後才會生效。
  • 如果用戶沒有對應任務的操作權限，刪除或更新任務可能失敗。
  • 只配置飛書應用憑證不等於已授權任務能力，需要同時完成權限開通和用戶授權。
  • 如果一直提示權限不足，優先檢查：權限是否已審批、飛書應用是否已發佈新版本、用戶是否重新同意授權。