常见问题

本文介绍钉钉待办任务的常见问题和错误。

创建待办接口调用成功，为什么在钉钉客户端上没有出现红点？

待办创建完成后，会显示在所有参与者的待办列表中。如果此待办任务指定了截止时间，且截止时间为当天或者待办状态为已逾期时，则会在待办任务的创建者和执行者的待办首页展示小红点。

钉钉待办红点规则：

待办入口显示的红数字 = 已逾期待办数量 + 当前待办数量
待办红点设置

创建待办接口调用成功，为什么在我的待办列表中未实时显示？

出现该问题时一般排查下调用创建待办接口时传入的isOnlyShowExecutor参数是否为true。

在isOnlyShowExecutor为true时表示该待办只会出现在执行人待我处理列表中，若此时执行人executorIds参数没有传的话，那就将看不到该待办了。

通过接口创建的待办，是否可以在待办列表操作完成？

待办业务接入目前主要有两类场景：

待办通知场景

待办通知场景完全复用钉钉官方待办能力（与用户在钉钉客户端创建的待办完全一致），调用新增待办接口创建待办时不需要传三方详情页链接，用户在钉钉客户端操作时可以在待办列表直接完成，点击跳转详情时将跳转至钉钉官方待办详情页。

流程如下图所示：

第三方业务自闭环场景

第三方业务自闭环场景是创建待办时，需传入业务自身应用详情页链接，用户在钉钉客户端操作时无法在列表直接完成，仅支持直接跳转至三方应用详情页进行操作。

流程如下图所示：

开放接口path中的unionId、creatorId、executorId、participantId、operatorId有什么区别？

unionId：设计用于区分个人、企业场景资源归属地，目前开放接口仅支持企业场景，这个可以理解为创建者，直接传创建者ID即可。

creatorId：创建该待办的用户。

executorId：要执行待办任务的人。

participantId：待办任务的参与人，仅关注查看任务信息，无操作权限。

operatorId：本次请求的操作用户。

待办推送重复的信息，提示 EXTRA string=call hsf service result error: task existed, string= and taskId is xxx 是什么问题？

原因是sourceId（业务系统侧的唯一标识ID，即来源业务ID）重复了。

说明

当三方业务接入钉钉待办后，需传递三方应用业务系统侧的唯一标识任务ID。当待办创建成功后，需要更换新的sourceId，保持一个待办任务对应一个sourceId。

有没有链接可以从外部唤起钉钉待办事项？

可以用dingtalk协议唤起（需所在环境支持dingtalk协议）：

dingtalk://dingtalkclient/action/switchtab?index=1&type=task

待办支持跳转小程序吗？

支持，dingtalk协议支持直接唤起钉钉小程序，拼接如下链接：

dingtalk://dingtalkclient/action/open_mini_app?miniAppId=1999&query=number%3D1&page=x%2Fy%2Fz

其中：

miniAppId为应用的ID。

query参数解析如下：number%3D1 === encodeURIComponent('number=1').

path参数解析如下：x%2Fy%2Fz === encodeURIComponent('x/y/z').

说明

更多详细信息，请参考小程序 scheme。

为什么我下载的是最新的SDK, 但是没有待办任务2.0的API呢?

参考新版服务端API SDK地址：https://developers.dingtalk.com/document/app/sdk-download

待办每个接口的调用频率限制，有对应的文档吗？

参考文档：调用频率限制。

创建待办接口调用成功，为什么在钉钉客户端上没有出现红点？#

创建待办接口调用成功，为什么在我的待办列表中未实时显示？#

通过接口创建的待办，是否可以在待办列表操作完成？#

待办通知场景#

第三方业务自闭环场景#

开放接口path中的unionId、creatorId、executorId、participantId、operatorId有什么区别？#

待办推送重复的信息，提示 EXTRA string=call hsf service result error: task existed, string= and taskId is xxx 是什么问题？#

有没有链接可以从外部唤起钉钉待办事项？#

待办支持跳转小程序吗？#

为什么我下载的是最新的SDK, 但是没有待办任务2.0的API呢?#

待办每个接口的调用频率限制，有对应的文档吗？#