发送文件 Base64

性能建议

如需大批量微信发送同样微信内容查看批量发送优化方案

接口地址： POST /sendFileBase64

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 接收方 wcId 可以是好友微信 ID，也可以是群 ID。
• base64 需要是完整且可解析的文件 Base64 内容。
• 文件名 fileName 建议包含正确扩展名，方便接收方识别文件类型。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方微信 ID/群 ID
fileName	是	string	文件名，建议包含扩展名
base64	是	string	文件 Base64 内容，可使用在线工具验证格式

响应参数

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

请求示例

{
 "wId": "0000016f-a805-4715-0001-848f9a297a40",
 "wcId": "jack_623555049",
 "fileName": "123.txt",
 "base64": "data:text/plain;base64,5oiR5piv576O5Li955qE5rWL6K+V5paH5Lu2Cg=="
}

成功响应

{
 "code": "1000",
 "message": "发送文件消息成功",
 "data": {
 "type": 6,
 "msgId": 697760551,
 "newMsgId": 8262558808731059065,
 "createTime": 1641458290,
 "wcId": "jack_623555049"
 }
}

错误响应

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

使用建议

• 大文件或批量发送场景建议优先使用文件 URL 发送，减少请求体大小和重试成本。
• 发送前建议校验 Base64 是否完整，避免文件损坏或无法打开。
• 发送成功后保存 msgId、newMsgId、createTime，便于撤回和审计。