Eyun 文档

Appearance

发送文件 ​

通过文件 URL 向好友或群聊发送文件消息。平台会先下载文件资源，再转发到微信。

接口地址： POST /sendFile

批量发送建议

如果多个微信账号需要发送同一个文件，建议先获取素材 XML，再使用转发接口发送，避免每个账号重复上传。详见 批量发送相同素材。

前置条件 ​

  • 微信账号已登录，并已获得可用的 wId。
  • path 必须是公网可访问的文件 URL。
  • fileName 建议包含正确扩展名，便于微信端展示。

请求参数 ​

参数名必选类型说明
wId是string登录实例标识
wcId是string接收方微信 ID 或群 ID（如 24187765053@chatroom）
path是string文件 URL
fileName是string文件名

响应参数 ​

参数名类型说明
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",
  "path": "https://xc-1300726975.cos.ap-shanghai.myqcloud.com/%E4%B8%8B%E8%BD%BD%E6%96%87%E4%BB%B6.txt",
  "fileName": "文件.txt"
}

成功响应 ​

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

错误响应 ​

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

使用建议 ​

  • 文件 URL 建议放在稳定 CDN，避免下载慢、鉴权失败或链接过期。
  • fileName 应与真实文件类型一致，便于接收方打开和识别。
  • 多账号发送同一文件时，建议使用素材转发方案，减少重复上传和发送耗时。

验证与排查 ​

场景处理方式
文件发送慢检查文件 URL 下载速度和文件大小
文件无法打开检查 fileName 扩展名是否与文件类型一致
发送失败确认 URL 可公网访问，且没有鉴权、过期或防盗链限制
多账号发送同文件使用转发方案，减少重复上传