> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 飛書任務

> 在 superun 中接入飛書任務和待辦能力，支援任務建立、負責人、狀態同步和提醒。

# 飛書任務

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

***

## 適合什麼場景

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

***

## 接入前需要準備

| 準備項    | 說明                                                       |
| ------ | -------------------------------------------------------- |
| 飛書基礎插件 | 先啟用 [飛書插件](/zh-Hant/superun/integrations/feishu)，並完成飛書登入 |
| 任務權限   | 在飛書開放平台開通任務讀取和寫入相關權限                                     |
| 用戶重新授權 | 如果用戶之前只授權過登入，需要重新同意任務權限                                  |
| 業務規則   | 明確任務標題、負責人、截止時間、提醒方式和狀態同步規則                              |

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

***

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

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

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

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

```json theme={null}
{
  "scopes": {
    "tenant": [],
    "user": ["task:task:read", "task:task:write"]
  }
}
```

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

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

***

## 如何在 superun 中啟用

<Steps>
  <Step title="確認飛書登入已接入">
    先讓相關用戶可以使用飛書登入你的產品。
  </Step>

  <Step title="在飛書後台開通任務權限">
    按上面的權限清單申請任務讀寫權限，並發佈飛書應用新版本。
  </Step>

  <Step title="啟用飛書任務">
    在「研發」→「技能庫」點擊「飛書任務」，描述你要接入的任務流程。
  </Step>

  <Step title="補充業務規則">
    說明任務從哪個業務動作生成、負責人如何確定、截止時間和提醒如何設定。
  </Step>

  <Step title="完成重新授權">
    按提示讓用戶同意新增的飛書任務權限，再測試建立、查詢或更新任務。
  </Step>
</Steps>

***

## 常見限制

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