Skip to content

转发文件消息

通过原始 XML 转发已收到的文件消息。

接口地址: POST /sendRecvFile

前置条件

  • 微信实例已登录,并已获得可用的 wId
  • 接收方 wcId 可以是好友微信 ID,也可以是群 ID。
  • content 需要来自已收到文件消息的回调 XML。
  • 该接口用于复用已收到的文件消息;发送新文件建议优先使用发送文件接口。

请求参数

参数名必选类型说明
wIdstring登录实例标识
wcIdstring接收方微信 ID 或群 ID
contentstring文件消息 XML 内容

响应参数

参数名类型说明
codestring1000 成功,1001 失败
messagestring反馈信息
data.typeint类型
data.msgIdlong消息 ID
data.newMsgIdlong新消息 ID
data.createTimelong发送时间戳(秒)
data.wcIdstring接收方 ID

请求示例

json
{
 "wId": "0000016f-a805-4715-0001-848f9a297a40",
 "wcId": "jack_623555049",
 "content": "<msg><appmsg appid=\"\" sdkver=\"0\"><title>报价单.pdf</title><type>6</type><appattach><totallen>248320</totallen><fileext>pdf</fileext></appattach></appmsg></msg>"
}

成功响应

json
{
 "code": "1000",
 "message": "转发文件成功",
 "data": {
 "type": 6,
 "msgId": 697760535,
 "newMsgId": 6957007917217750754,
 "createTime": 1641457929,
 "wcId": "jack_623555049"
 }
}

错误响应

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

使用建议

  • 建议保存原始文件消息回调 XML,转发时直接使用,避免手工拼接造成字段缺失。
  • 文件类消息可能受微信侧文件有效期影响,过期文件建议重新上传后再发送。
  • 发送成功后保存 msgIdnewMsgIdcreateTime,便于撤回或追踪。