获取私信 SessionId

获取当前登录实例与指定视频号用户的私信会话 ID。拿到 sessionId 后，可继续调用视频号私信发送接口。

接口地址： POST /getSessionId

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• toUserName 为目标视频号用户编码，通常来自搜索、主页、关注列表等视频号接口返回。
• type=1 表示使用视频号身份发起会话，myUserName 必传；type=2 表示使用微信号身份发起会话，myUserName 传空字符串。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
toUserName	是	string	目标视频号用户编码
myUserName	是	string	自己的视频号用户编码；type=2 时传空字符串
type	是	int	身份类型：1 视频号身份，2 微信号身份

请求示例

{
  "wId": "{{wId}}",
  "toUserName": "v2_060000231003b20faec8c6e78010c3d4c605eb3cb077f16e37c172145877400390b1170a0299@finder",
  "myUserName": "v2_060000231003b20faec8cae18a1ec5d0cb07eab077ba915250774edbea38082ea6b24af229@finder",
  "type": 1
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	会话信息
data.sessionId	string	私信会话 ID，发送私信时使用
data.enableAction	int	会话动作状态，按接口返回值处理
data.toUsername	string	目标视频号用户编码

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "sessionId": "69fd3a9cc1180847d8b5a1533bf285b99a83784cfd4cfdadea78974509359c74@findermsg",
    "enableAction": 0,
    "toUsername": "v2_060000231003b20faec8c6e78010c3d4c605eb3cb077f16e37c172145877400390b1170a0299@finder"
  }
}

错误响应

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

使用建议

• 发送私信前先缓存 sessionId，避免每次发送都重复获取。
• 当目标用户、发送身份或登录实例变化时，应重新获取 sessionId。
• 如果返回失败，先确认 wId 在线、toUserName 有效，以及当前账号是否具备向目标用户发私信的权限。