← 返回文档中心

微信联系人接口-多微信号切换

Service端接口改动文档 · 2026-04-27

一、当前接口

1.1 获取微信联系人列表

POST /action/crm/getWxContact

请求参数:

{
  "name": "关键词",
  "page": 1,
  "pageSize": 20
}
字段类型说明
nameString好友名称(模糊搜索)
pageInt页码
pageSizeInt每页条数

响应结果:

{
  "success": true,
  "result": {
    "list": [
      {
        "_id": "wxfriend_001",
        "m7WxNo": "wx_no_001",
        "m7Nick": "张三",
        "m7HeadImg": "https://xxx/head.png",
        "m7Phone": "13812345678",
        "m7Memo": "客户A",
        "onlyCode": "code_001",
        "customerName": "李四"
      }
    ],
    "count": 100,
    "page": 1,
    "pageSize": 20
  }
}
二、改动方案
改动说明:新增 wxId 参数,支持指定微信ID查询联系人列表,实现多微信号切换功能。

2.1 请求参数改动

POST /action/crm/getWxContact

NEW 新增 wxId 参数

请求参数:

{
  "wxId": "wx_xxx",
  "name": "关键词",
  "page": 1,
  "pageSize": 20
}
字段类型必填说明
wxIdString微信ID,不传则查当前登录微信
nameString好友名称(模糊搜索)
pageInt页码
pageSizeInt每页条数

2.2 响应结果(不变)

{
  "success": true,
  "result": {
    "list": [...],
    "count": 100,
    "page": 1,
    "pageSize": 20
  }
}
三、APP端改动

3.1 导入微信联系人界面

功能说明:支持从微信导入联系人到系统

字段类型说明
wxIdString微信ID,用于区分哪个微信的联系人
联系人列表Array微信好友列表

3.2 绑定微信联系人界面

功能说明:将微信联系人与系统客户进行绑定关联

字段类型说明
wxIdString微信ID
friendIdString微信好友ID
customerIdString系统客户ID

3.3 多微信号切换

功能说明:支持在同一APP中切换不同微信账号

  • 微信切换器组件
  • 显示当前登录微信
  • 支持快速切换

3.4 工作手机APP改动(xkw-workphone)

项目路径:xkw-workphone

功能说明:解析当前双开微信用户数据,提供给联系人选择界面

接口:getUseWxList(位于 xkw-workphone 项目中)

字段类型说明
wxIdString微信ID(唯一标识)
wxNickString微信昵称
wxNoString微信号
headImgString微信头像URL
isActiveBoolean是否当前登录

数据来源:工作手机双开微信环境下的微信用户列表

使用场景:员工在选择微信联系人前,需要先切换/选择对应的微信账号

{
  "list": [
    {
      "wxId": "wx_001",
      "wxNick": "工作微信A",
      "wxNo": "workwechat_a",
      "headImg": "https://xxx/head_a.png",
      "isActive": true
    },
    {
      "wxId": "wx_002",
      "wxNick": "工作微信B",
      "wxNo": "workwechat_b",
      "headImg": "https://xxx/head_b.png",
      "isActive": false
    }
  ]
}
四、开发任务清单

APP端(xkw-workphone)

任务优先级说明
getUseWxList接口P0解析双开微信用户数据,提供给联系人选择界面

APP端(主APP)

任务优先级说明
导入微信联系人界面P0支持从微信导入联系人到系统
绑定微信联系人界面P0将微信联系人与系统客户绑定
多微信号切换组件P0微信切换器,支持快速切换账号

Service端

任务优先级说明
getWxContact接口新增wxId参数P0支持指定微信ID查询联系人