选择应用类型
企业内部应用开发

消息撤回旧版SDK

更新于 2023-01-18

接口调用量说明当前接口为钉钉专属版专用接口,你可升级钉钉专属版(Open API调用量500万次/月)获取接口调用权限以及扩容调用次数。
调用本接口根据消息发送的任务id撤回消息。

重要

超过24小时的消息无法撤回。

权限

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。

应用类型

是否支持调用

权限申请方式

API Explorer调试

企业内部应用

企业内部服务号消息权限

调试

第三方企业应用

第三方个人应用

基本信息

请求方式:POST

请求地址https://oapi.dingtalk.com/topapi/message/mass/recall

Query参数

名称

类型

是否必填

示例值

描述

access_token

String

30c9a84136943eaxxxx

调用该接口的应用凭证。

Body参数

名称

类型

是否必填

示例值

描述

unionid

String

jYdrJoCmTo0iE

服务号的unionid,可以通过查询服务号详情接口获取。

task_id

String

pushW1YOkyX5RDV5a2rjeI2SswiEiE

消息发送任务id,可以通过消息群发接口获取。

返回参数

名称

类型

示例值

描述

errmsg

String

ok

返回码描述。

errcode

Number

0

返回码。

request_id

String

ouad0q1rtlhw

请求ID。

示例

请求示例(HTTP)

Loading...

请求正文

Loading...

请求示例(JAVA SDK)

Loading...

返回示例

Loading...

错误码

错误码

说明

排查方法

800025

task_id不合法

检查传入task_id是否正确。

点击纠错