飞书任务

在 superun 中接入飞书任务和待办能力，支持任务创建、负责人、状态同步和提醒。

飞书任务

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

---

适合什么场景

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

---

接入前需要准备

准备项	说明
飞书基础插件	先启用 飞书插件，并完成飞书登录
任务权限	在飞书开放平台开通任务读取和写入相关权限
用户重新授权	如果用户之前只授权过登录，需要重新同意任务权限
业务规则	明确任务标题、负责人、截止时间、提醒方式和状态同步规则

飞书任务是用户级能力。谁创建或操作任务，通常取决于当前登录并完成授权的飞书用户。

---

飞书后台需要开通的权限

进入飞书开放平台 → 找到你的企业自建应用 →「权限管理」，申请下面两条 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 即使触发重新授权，也拿不到新的任务权限。

---

如何在 superun 中启用

1. 确认飞书登录已接入

   先让相关用户可以使用飞书登录你的产品。

2. 在飞书后台开通任务权限

   按上面的权限清单申请任务读写权限，并发布飞书应用新版本。

3. 启用飞书任务

   在「研发」→「技能库」点击「飞书任务」，描述你要接入的任务流程。

4. 补充业务规则

   说明任务从哪个业务动作生成、负责人如何确定、截止时间和提醒如何设置。

5. 完成重新授权

   按提示让用户同意新增的飞书任务权限，再测试创建、查询或更新任务。

---

常见限制

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