私信图片

向指定视频号用户发送图片私信。

接口地址： POST /privateSendImg

注意

首次私信通常不能直接发送图片，需要对方回复后再发送图片。

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• 已通过获取私信 SessionId 接口拿到有效的 sessionId。
• imgUrl 必须是接口服务可访问的图片链接。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
toUserName	是	string	目标视频号用户编码
sessionId	是	string	通过 /getSessionId 获取的私信会话 ID
imgUrl	是	string	图片地址

请求示例

{
  "wId": "{{wId}}",
  "toUserName": "v2_060000231003b20faec8cae18a1ec5d0cb07ea33b077ba915250774edbea38082ea6b24af229@finder",
  "sessionId": "a37c87fbfb8c07ca21d29bea6e3feef1cd740982cfda8407bde2dc2ccbba7f0c@findermsg",
  "imgUrl": "https://cdn.e-yun.example/feed/customer-service.jpeg"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	发送结果
data.newMsgId	number	新消息 ID

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "newMsgId": 1248576160896589973
  }
}

错误响应

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

使用建议

• 发送图片前先确认双方已经建立可发送图片的私信关系。
• 图片链接建议使用稳定 HTTPS 地址，并提前校验可访问性。
• 发送成功后保存 newMsgId，便于后续对账、展示或问题排查。