转发文件消息

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

接口地址： POST /sendRecvFile

前置条件

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

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方微信 ID 或群 ID
content	是	string	文件消息 XML 内容

响应参数

参数名	类型	说明
code	string	1000 成功；其他值都是失败，通常是 1001
message	string	反馈信息
data.type	int	类型
data.msgId	long	消息 ID
data.newMsgId	long	新消息 ID
data.createTime	long	发送时间戳（秒）
data.wcId	string	接收方 ID

请求示例

HTTP

POST {BASE_URL}/sendRecvFile
Authorization: Bearer <你的调用凭证>
Content-Type: application/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>"
}

curl

curl -X POST '{BASE_URL}/sendRecvFile' \
  -H 'Authorization: Bearer <你的调用凭证>' \
  -H 'Content-Type: application/json' \
  --data-raw '{
 "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>"
}'

Python

import requests

url = "{BASE_URL}/sendRecvFile"
headers = {"Authorization": "Bearer <你的调用凭证>", "Content-Type": "application/json"}
body = r"""{
 "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>"
}"""

resp = requests.post(url, headers=headers, data=body.encode("utf-8"))
print(resp.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

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

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder(URI.create(url))
    .header("Authorization", "Bearer <你的调用凭证>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

PHP

<?php

$url = '{BASE_URL}/sendRecvFile';
$body = <<<'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;

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer <你的调用凭证>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

成功响应

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

错误响应

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

使用建议

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