Skip to content

发送图片

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

接口地址: POST /sendImage2

批量发送建议

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

前置条件

  • 微信账号已登录,并已获得可用的 wId
  • content 必须是公网可访问的图片 URL。
  • 图片资源服务器需要稳定,下载速度会影响发送速度。

请求参数

参数名必选类型说明
wIdstring登录实例标识
wcIdstring接收方微信 ID 或群 ID(如 24187765053@chatroom
contentstring图片 URL

响应参数

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

请求示例

json
{
  "wId": "0000016e-63eb-f319-0001-ed01076abf1f",
  "wcId": "LoChaX",
  "content": "http://photocdn.sohu.com/20120323/Img338614056.jpg"
}

成功响应

json
{
  "code": "1000",
  "message": "发送图片消息成功",
  "data": {
    "type": null,
    "msgId": 697760516,
    "newMsgId": 901023126355472137,
    "createTime": 0,
    "wcId": "LoChaX"
  }
}

错误响应

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

使用建议

  • 图片 URL 建议放在稳定 CDN,并确保外网可直接访问。
  • 批量发送同一图片时,建议先获取素材 XML,再使用转发接口,减少重复上传。
  • 对营销图片建议控制发送频率,避免短时间大量重复发送。

验证与排查

场景处理方式
图片发送慢先用稳定公网图片测试,确认是否为资源服务器下载慢
图片发送失败确认 URL 可公网访问,且返回真实图片内容
多账号发送同图使用转发方案,不要让每个账号重复上传
疑似风控降低频率,减少相同图片的批量发送