# 撤回单聊消息

撤回机器人发送给当前用户的消息。发送超过 2 分钟的消息不可撤回。 成功返回 HTTP 200,无响应体。

  • 发送超出 2 分钟的消息不可撤回

# 请求

# 基础信息

字段
HTTP URL /v2/users/{user_openid}/messages/{message_id}
HTTP Method DELETE
接口频率限制 10 QPS

# 路径参数

名称 类型 必填 描述
user_openid string 用户 OpenID
message_id string 消息 ID

# 请求示例

示例1

DELETE /v2/users/A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4/messages/0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF
1

# 响应

# 响应示例

示例1

{}
1

# 错误码

错误码 描述 排查建议
306009 用户openid无效 请检查user_openid是否正确
40061001 请求参数无效 请检查请求参数格式
40061002 请求参数msgid无效 请检查msgid格式是否正确
40064004 已超出消息撤回时限 消息发送超过2分钟后不可撤回
上次更新: 7/22/2026, 6:23:09 PM
手机QQ扫码
开发者社区
加入官方频道开发者社区