微信联系人接口-多微信号切换
Service端接口改动文档 · 2026-04-27
一、当前接口
1.1 获取微信联系人列表
POST /action/crm/getWxContact
请求参数:
{
"name": "关键词",
"page": 1,
"pageSize": 20
}
| 字段 | 类型 | 说明 |
|---|---|---|
| name | String | 好友名称(模糊搜索) |
| page | Int | 页码 |
| pageSize | Int | 每页条数 |
响应结果:
{
"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
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| wxId | String | 否 | 微信ID,不传则查当前登录微信 |
| name | String | 否 | 好友名称(模糊搜索) |
| page | Int | 是 | 页码 |
| pageSize | Int | 是 | 每页条数 |
2.2 响应结果(不变)
{
"success": true,
"result": {
"list": [...],
"count": 100,
"page": 1,
"pageSize": 20
}
}
三、APP端改动
3.1 导入微信联系人界面
功能说明:支持从微信导入联系人到系统
| 字段 | 类型 | 说明 |
|---|---|---|
| wxId | String | 微信ID,用于区分哪个微信的联系人 |
| 联系人列表 | Array | 微信好友列表 |
3.2 绑定微信联系人界面
功能说明:将微信联系人与系统客户进行绑定关联
| 字段 | 类型 | 说明 |
|---|---|---|
| wxId | String | 微信ID |
| friendId | String | 微信好友ID |
| customerId | String | 系统客户ID |
3.3 多微信号切换
功能说明:支持在同一APP中切换不同微信账号
- 微信切换器组件
- 显示当前登录微信
- 支持快速切换
3.4 工作手机APP改动(xkw-workphone)
项目路径:xkw-workphone
功能说明:解析当前双开微信用户数据,提供给联系人选择界面
接口:getUseWxList(位于 xkw-workphone 项目中)
| 字段 | 类型 | 说明 |
|---|---|---|
| wxId | String | 微信ID(唯一标识) |
| wxNick | String | 微信昵称 |
| wxNo | String | 微信号 |
| headImg | String | 微信头像URL |
| isActive | Boolean | 是否当前登录 |
数据来源:工作手机双开微信环境下的微信用户列表
使用场景:员工在选择微信联系人前,需要先切换/选择对应的微信账号
{
"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查询联系人 |