SuperAPI AI 工具集

dingtalk-todo

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:本技能负责钉钉待办(Todo)的全部操作,当用户提到钉钉待办、待办任务、创建/新增/查看/完成/删除待办、待办列表、我的待办、设置截止时间、指派待办等需求时使用。

主要能力:创建待办、获取待办详情、查询待办列表(含分页)、更新待办、完成待办、删除待办,并支持在创建时指派同事(executorIds / participantIds)。

使用方式:先读取配置文件 ~/.dingtalk-skills/config,仅收集缺失项并一次性询问后写入持久化。所需配置为 DINGTALK_APP_KEY、DINGTALK_APP_SECRET、DINGTALK_MY_USER_ID(企业内部员工 ID,非手机号、非 unionId),DINGTALK_MY_OPERATOR_ID(unionId)由脚本通过 userId 自动转换写入。Token 有 7000 秒缓存,遇 401 重新获取。凡含变量替换、管道或多行逻辑的命令,先写入 /tmp/<task>.sh 再以 bash 执行,避免终端截断。凭证输出时仅显示前 4 位加 ****。

身份标识:待办 API 的路径参数 {unionId} 与查询参数 operatorId 均使用 unionId,指派同事也需 unionId;需先用旧版 access_token 调用接口将 userId 转为 unionId,注意返回体 result.unionid(无下划线)才有值。

限制与注意:通过 API 创建的待办显示在钉钉「待办」的 Teambition 分类下,而非「个人」分类;通过 API 创建的任务无法在钉钉 UI 手动删除,只能通过 API 删除。完整 API 请求格式、参数、返回值与错误码见 references/api.md,可用 grep 按章节提取。所需应用权限及其他费用、平台支持等信息资料未提供。