Eyun 文档

Appearance

撤回消息 ​

撤回当前微信实例已发送的消息。

接口地址： POST /revokeMsg

前置条件 ​

  • 微信实例已登录，并已获得可用的 wId。
  • 待撤回消息必须由当前微信实例发送。
  • 请求中的 msgId、newMsgId、createTime 需要使用发送类接口返回值。
  • 微信侧对可撤回时间有自身限制，超过限制后会撤回失败。

请求参数 ​

参数名必选类型说明
wId是string登录实例标识
wcId是string接收方微信 ID/群 ID
msgId是long消息 ID，发送类接口返回
newMsgId是long新消息 ID，发送类接口返回
createTime是long发送时间戳，发送类接口返回

响应参数 ​

参数名类型说明
codestring1000 成功，1001 失败
messagestring反馈信息
datanull无业务数据返回

请求示例 ​

json
{
 "wId": "12491ae9-62aa-4f7a-83e6-9db4e9f28e3c",
 "wcId": "wxid_1dfgh4fs8vz22",
 "msgId": 697760203,
 "newMsgId": 4792296942111367533,
 "createTime": 1641456307
}

成功响应 ​

json
{
 "message": "成功",
 "code": "1000",
 "data": null
}

错误响应 ​

json
{
 "message": "失败",
 "code": "1001",
 "data": null
}

使用建议 ​

  • 发送消息成功后建议立即保存 msgId、newMsgId、createTime，撤回时不要从页面展示文本反查。
  • 撤回失败时优先检查消息是否由当前 wId 对应实例发送，以及是否超过微信侧可撤回时间。
  • 对群消息撤回建议记录操作人和业务原因，方便客服或运营追溯。