> ## 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 中接入飞书任务和待办能力，支持任务创建、负责人、状态同步和提醒。

# 飞书任务

飞书任务能力用于把产品里的工作事项同步到飞书待办中。它适合处理任务创建、负责人分配、截止时间、状态同步和提醒等流程。

***

## 适合什么场景

* 表单提交后自动创建飞书任务。
* 审批、客服、招聘、项目管理流程中自动分配负责人。
* 将产品里的任务状态与飞书待办保持同步。
* 为关键事项设置截止时间和提醒，减少遗漏。

***

## 接入前需要准备

| 准备项    | 说明                                               |
| ------ | ------------------------------------------------ |
| 飞书基础插件 | 先启用 [飞书插件](/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>

***

## 常见限制

* 任务读写权限需要用户重新授权后才会生效。
* 如果用户没有对应任务的操作权限，删除或更新任务可能失败。
* 只配置飞书应用凭证不等于已授权任务能力，需要同时完成权限开通和用户授权。
* 如果一直提示权限不足，优先检查：权限是否已审批、飞书应用是否已发布新版本、用户是否重新同意授权。