飞书任务

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

适合什么场景

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

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

确认飞书登录已接入

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

在飞书后台开通任务权限

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

启用飞书任务

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

补充业务规则

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

完成重新授权

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