手机号加粉
POST
/wxworkapi/message/exchange
isSearchOnly = 0 isSearchOnly = 1 请求示例：
{
"messageId": "20200205161619572724162503",
"phone":"13480110474",
"type": "robot.phone.contact.add",
"robotKey": "bcc23c5e76ab6887d51b0197cd017e66",
"reason": "加好友的话术"
"isSearchOnly": 1
}参数说明：
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| type | string | 是 | 命令字”robot.add.friend.from.group“ |
| messageld | String | 是 | 请求消息id，32个字符的唯一，应答时原样回传 |
| robotKey | String | 是 | 机器人robotKey |
| userId | string | 是 | userid，示例 "7881302985963919" |
| reason | string | 是 | 请求信息，示例 "我是xxxxx企业微信与xxx吧" |
| isSearchOnly | Integer | 否 | 执行逻辑，1只查询客户微信，不添加 ，0查询客户微信并发送添加请求 ，默认为 0 |
回调通知：
isSearchOnly = 1 时应答
{
"messageId": "20240318145946810761850001",
"phone": "17865431234",
"robotKey": "ae96354c66e94d0da8da62d784e1580c",
"dts": 1710846468318,
"code": "0",
"msg": "success",
"robotType": 2,
"isSearchOnly": 1,
"users": [
{
"corpName": "微信",
"namePinyin": "XXXX.",
"avatorUrl": "http:\/\/wx.qlogo.cn\/mmhead\/XxxxxDianwrKhSc\/0",
"wxOpenId": "orFrbsgyEVzq4LrwH79D_tzFjMYM",
"corpShortName": "微信",
"wechatImgUrl": "http:\/\/wx.qlogo.cn\/mmhead\/xxxxxrKhSc\/0",
"corpAuthType": 0,
"realName": "",
"isCustomer": 0,
"userId": 7881299590998761,
"corpanyId": 1970325134026788,
"name": "YANG.",
"isExternalUser": 1,
"wechatName": "",
"nameStatus": 1,
"isOuterUser": 1,
"isWorkChatCustomer": false,
"corpDescription": ""
},
{
"namePinyin": "**xy",
"avatorUrl": "http:\/\/wework.qpic.cn\/bizmail\/SULNrITeFbrURMic2PKNc2lHO0pU4qibLawgVRCaxVxBGfc1DCGIoFcQ\/0",
"wechatImgUrl": "http:\/\/wework.qpic.cn\/bizmail\/SULNrITeFbrURMic2PKNc2lHO0pU4qibLawgVRCaxVxBGfc1DCGIoFcQ\/0",
"realName": "**xy",
"isCustomer": 0,
"userId": 312834213941209029,
"corpanyId": 1970325052210733,
"name": "**夕阳",
"isExternalUser": 1,
"wechatName": "",
"ticket": "38C460577B3E35FAF08AFB4436A923A215AC283E933F9BE48BA6B09143471328D6E91C113DB43B44B9AD0F26498E2A0E4538F7A50337DE71B10D6C1B51F6D9F30EE4A495E9604B9A7091AFD07DA2DAF1",
"nameStatus": 1,
"isOuterUser": 0,
"isWorkChatCustomer": false
}
],
"type": "phone.contact.add",
"isCorpPhoneOrExternalUserPhone": 0
}isSearchOnly = 0 或未传 时应答
{
"messageId": "20240318145946810761850001",
"phone": "15622170229",
"robotKey": "ae96354c66e94d0da8da62d784e1580c",
"code": "0",
"msg": "OK",
"userData": {
"corpName": "微信",
"namePinyin": "listen",
"avatorUrl": "http:\/\/wx.qlogo.cn\/mmhead\/wprMnqDUJH4HN2usTRwDu4x8DiasJ5YibATCFxEoib3hkyLmnDLdCaKbQ\/0",
"wxOpenId": "orFrbsm6a4FyTCTCNx_F80Yx3ZAE",
"corpShortName": "微信",
"wechatImgUrl": "http:\/\/wx.qlogo.cn\/mmhead\/wprMnqDUJH4HN2usTRwDu4x8DiasJ5YibATCFxEoib3hkyLmnDLdCaKbQ\/0",
"corpAuthType": 0,
"realName": "",
"userId": 7881300384921417,
"corpanyId": 1970325134026788,
"name": "listen",
"isExternalUser": 1,
"wechatName": "",
"nameStatus": 1,
"isOuterUser": 1,
"isWorkChatCustomer": false,
"corpDescription": ""
},
"type": "phone.contact.add",
"isCorpPhoneOrExternalUserPhone": 0,
"robotType": 2,
"dts": 1710901815064
}参数说明：
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| isExternalUser | Integer | 是 | 是否可添加微信 1 是， 0 否 |
| isOuterUser | Integer | 是 | 微信类型 0 企业微信 1 个人微信 |
| ticket | Integer | 是 | 添加企业微信时的 ticket， 对个人微信为 空 |
| wxOpenId | Integer | 是 | 添加个人微信的标识， 企业微信为空 |
| isCustomer | Integer | 是 | 是否已经是客户， 1 是， 0 否 |
错误码：
| code | 错误描述 | 平台 | 描述 |
|---|---|---|---|
| -1 | 搜索的联系人不存在，请检查账号准确性 | win | |
| -18000039 | 添加好友过于频繁，请稍后再重试 | win | |
| -18000093 | 向微信好友发消息功能已被限制使用 | win | |
| 1 | mac的提示信息 | mac | |
| 100 | 好友关系已存在 | mac | |
| 102 | 未搜索到客户信息 | mac |
请求参数
Query 参数
Header 参数
请求示例代码
返回响应
修改于 2025-04-02 08:35:46