飛書任務

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

適合什麼場景

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

進入飛書開放平台 → 找到你的企業自建應用 →「權限管理」，申請下面兩條 user 類型權限。

權限 key	權限名稱	類型	用途
`task:task:read`	查看任務詳情	user	查詢任務詳情、任務狀態和任務清單相關資訊
`task:task:write`	查看 / 建立 / 編輯 / 刪除任務	user	建立任務、更新任務、完成任務、刪除任務、管理任務成員或提醒

推薦使用飛書權限管理中的「批量導入」：

{
  "scopes": {
    "tenant": [],
    "user": ["task:task:read", "task:task:write"]
  }
}

老權限 task:task / task:task:readonly 不適用於當前任務 v2 接入。即使舊專案裡保留了它們，也需要新增 task:task:read 和 task:task:write。

權限申請後還需要完成「建立版本 → 提交審批 → 發佈」。沒有發佈新版本時，superun 即使觸發重新授權，也拿不到新的任務權限。

確認飛書登入已接入

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

在飛書後台開通任務權限

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

啟用飛書任務

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

補充業務規則

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

完成重新授權

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