获取私信联系人信息

获取指定视频号私信联系人的详细信息，包括昵称、头像、地区和私信会话信息。

接口地址： POST /finder/getContactDetails

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• contactUserName 来自私信联系人、消息列表或私信相关接口返回。
• myUserName、myRoleType 建议从个人主页接口返回值中读取。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
contactUserName	是	string	私信联系人 username
myUserName	是	string	自己的视频号用户编码
myRoleType	是	int	自己的视频号角色类型

请求示例

{
  "wId": "{{wId}}",
  "contactUserName": "fv1_552fe39c023a38d299394e3832455d574586ae4e399e51f3f17d414691ae85b@findermsgstranger",
  "myUserName": "v2_060000231003b20faec8cae18a1ec5d0cb07eab077ba915250774edbea38082ea6b24af229@finder",
  "myRoleType": 3
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	array	联系人详情列表
data[].wxUsernameV5	string	微信 V5 用户编码
data[].signature	string	签名
data[].nickname	string	昵称
data[].headUrl	string	头像地址
data[].msgInfo	object	私信会话信息
data[].msgInfo.sessionId	string	私信会话 ID
data[].msgInfo.msgUsername	string	私信联系人消息用户名
data[].username	string	私信联系人 username
data[].extInfo	object	地区、性别等扩展信息

成功响应

{
  "code": "1000",
  "message": "查询视频号私信联系人详情成功",
  "data": [
    {
      "wxUsernameV5": "v5_020b0a16610401000000000023390adabe0bb3000000b1afa7d87e3dd43ef4317a780e33c2996857e4fdf7e8b0f6772a3d0e16c79d1a10bf247770dfef7bd0280d9b6a78205e554b90a5a94de2a3349cfcf4@stranger",
      "signature": "从",
      "nickname": "。",
      "headUrl": "https://wx.qlogo.cn/mmhead/ver_1/example/132",
      "msgInfo": {
        "sessionId": "552fe39c023a38d299394e3832455d5774586ae399e51f3f17d414691ae85b@findermsg",
        "msgUsername": "fv1_552fe39c023a38d299394e3832455d57586ae4e399e51f3f17d414691ae85b@findermsgstranger"
      },
      "username": "fv1_552fe39c023a38d299394e3832455774586ae4e399e51f3f17d414691ae85b@findermsgstranger",
      "extInfo": {
        "country": "CN",
        "province": "Jiangsu",
        "city": "Nanjing",
        "sex": 1
      }
    }
  ]
}

错误响应

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

使用建议

• 发送私信前可用本接口校验联系人信息和会话信息。
• msgInfo.sessionId 可用于后续私信发送；如果为空或失效，应重新获取会话。
• contactUserName 与普通视频号 userName 不完全相同，建议按接口返回值原样传递。