私信文字

向指定视频号用户发送文字私信。

接口地址： POST /privateSend

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• 已通过获取私信 SessionId 接口拿到有效的 sessionId。
• toUserName 与 sessionId 必须对应同一个目标用户。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
toUserName	是	string	目标视频号用户编码
myUserName	是	string	自己的视频号用户编码
sessionId	是	string	通过 /getSessionId 获取的私信会话 ID
content	是	string	私信内容

请求示例

{
  "wId": "{{wId}}",
  "toUserName": "v2_060000231003b20faec8c6e78010c3d4c605eb3cb077f16e37c172145877400390b1170a0299@finder",
  "myUserName": "v2_060000231003b20faec8cae18a1ec5d0cb07eab077ba915250774edbea38082ea6b24af229@finder",
  "sessionId": "69fd3a9cc1180847d8b5a1533bf285b99a83784cfd4cfdadea78974509359c74@findermsg",
  "content": "哈喽"
}

响应参数

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

成功响应

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

错误响应

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

使用建议

• 建议发送前先获取或刷新 sessionId，避免会话过期。
• 发送成功后保存 newMsgId，便于后续对账、展示或问题排查。
• 如果发送失败，先确认目标用户是否允许私信，以及 sessionId 是否匹配目标用户。