- 开发指南
- 基础接口
- 客户设置
- 消息推送
- 客户&线索&待分配
- 客户查询
- 客户导入
- 客户
- 线索&待分配
- 商机
- 个人客户转企业客户
- 企业客户联系人
- 客户旅程
- 客户操作
- 按企微员工id列出企微好友客户详情POST
- 公海
- 企微组织架构
- 企微标签库
- 企业
- 合同
- 电商平台
- 营销
- 数据统计
- 内容访客
- 电销手机
- SOP任务
- 群发消息
- 管控
- 工单
- 素材
- 应用通知
- 附录
- 群数据
- 店主活码
修改联系人
POST
/api/v3/contacts/update
请求参数
Header 参数
appId
string
应用 appId
默认值:
{{appId}}
timestamp
string
请求时间戳
默认值:
{{timestamp}}
sign
string
请求消息签名值
默认值:
{{sign}}
appKey
string
应用 appKey
默认值:
{{appKey}}
Body 参数application/json
customerId
number
企业客户id
salesId
number
员工id
contacts
array [object {2}]
联系人信息
contactId
integer
联系人id
fields
array [object {2}]
联系人字段信息
示例
{
"customerId": 478452324988992,
"salesId": 463352988837952,
"contacts": [
{
"contactId": 487856702894080,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-01"
]
},
{
"id": 916,
"value": [
"0719联系人01"
]
},
{
"id": 913,
"value": [
"207191159001"
]
},
{
"id": 3996,
"value": [
"207191159001"
]
},
{
"id": 915,
"value": [
"120002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856702670848,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-02"
]
},
{
"id": 916,
"value": [
"0719联系人02"
]
},
{
"id": 913,
"value": [
"207191159002"
]
},
{
"id": 3996,
"value": [
"207191159002"
]
},
{
"id": 915,
"value": [
"220002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856702386176,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-03"
]
},
{
"id": 916,
"value": [
"0719联系人03"
]
},
{
"id": 913,
"value": [
"207191159003"
]
},
{
"id": 3996,
"value": [
"207191159000"
]
},
{
"id": 915,
"value": [
"30002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856702132224,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-04"
]
},
{
"id": 916,
"value": [
"0719联系人04"
]
},
{
"id": 913,
"value": [
"207191159004"
]
},
{
"id": 3996,
"value": [
"207191159004"
]
},
{
"id": 915,
"value": [
"40002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856701767680,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-05"
]
},
{
"id": 916,
"value": [
"0719联系人05"
]
},
{
"id": 913,
"value": [
"207191159005"
]
},
{
"id": 3996,
"value": [
"207191159005"
]
},
{
"id": 915,
"value": [
"50002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856701378560,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-06"
]
},
{
"id": 916,
"value": [
"0719联系人06"
]
},
{
"id": 913,
"value": [
"207191159006"
]
},
{
"id": 3996,
"value": [
"207191159006"
]
},
{
"id": 915,
"value": [
"620002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856701085696,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-07"
]
},
{
"id": 916,
"value": [
"0719联系人07"
]
},
{
"id": 913,
"value": [
"207191159007"
]
},
{
"id": 3996,
"value": [
"207191159007"
]
},
{
"id": 915,
"value": [
"70002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856700854272,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-08"
]
},
{
"id": 916,
"value": [
"0719联系人08"
]
},
{
"id": 913,
"value": [
"207191159008"
]
},
{
"id": 3996,
"value": [
"207191159008"
]
},
{
"id": 915,
"value": [
"820002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856700526592,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-09"
]
},
{
"id": 916,
"value": [
"0719联系人09"
]
},
{
"id": 913,
"value": [
"207191159009"
]
},
{
"id": 3996,
"value": [
"207191159009"
]
},
{
"id": 915,
"value": [
"920002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856697102336,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-10"
]
},
{
"id": 916,
"value": [
"0719联系人10"
]
},
{
"id": 913,
"value": [
"207191159010"
]
},
{
"id": 3996,
"value": [
"207191159011"
]
},
{
"id": 915,
"value": [
"120002000测试描述瞎填915测试描述瞎填9152"
]
}
]
}
]
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v3/contacts/update' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"customerId": 478452324988992,
"salesId": 463352988837952,
"contacts": [
{
"contactId": 487856702894080,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-01"
]
},
{
"id": 916,
"value": [
"0719联系人01"
]
},
{
"id": 913,
"value": [
"207191159001"
]
},
{
"id": 3996,
"value": [
"207191159001"
]
},
{
"id": 915,
"value": [
"120002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856702670848,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-02"
]
},
{
"id": 916,
"value": [
"0719联系人02"
]
},
{
"id": 913,
"value": [
"207191159002"
]
},
{
"id": 3996,
"value": [
"207191159002"
]
},
{
"id": 915,
"value": [
"220002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856702386176,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-03"
]
},
{
"id": 916,
"value": [
"0719联系人03"
]
},
{
"id": 913,
"value": [
"207191159003"
]
},
{
"id": 3996,
"value": [
"207191159000"
]
},
{
"id": 915,
"value": [
"30002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856702132224,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-04"
]
},
{
"id": 916,
"value": [
"0719联系人04"
]
},
{
"id": 913,
"value": [
"207191159004"
]
},
{
"id": 3996,
"value": [
"207191159004"
]
},
{
"id": 915,
"value": [
"40002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856701767680,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-05"
]
},
{
"id": 916,
"value": [
"0719联系人05"
]
},
{
"id": 913,
"value": [
"207191159005"
]
},
{
"id": 3996,
"value": [
"207191159005"
]
},
{
"id": 915,
"value": [
"50002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856701378560,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-06"
]
},
{
"id": 916,
"value": [
"0719联系人06"
]
},
{
"id": 913,
"value": [
"207191159006"
]
},
{
"id": 3996,
"value": [
"207191159006"
]
},
{
"id": 915,
"value": [
"620002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856701085696,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-07"
]
},
{
"id": 916,
"value": [
"0719联系人07"
]
},
{
"id": 913,
"value": [
"207191159007"
]
},
{
"id": 3996,
"value": [
"207191159007"
]
},
{
"id": 915,
"value": [
"70002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856700854272,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-08"
]
},
{
"id": 916,
"value": [
"0719联系人08"
]
},
{
"id": 913,
"value": [
"207191159008"
]
},
{
"id": 3996,
"value": [
"207191159008"
]
},
{
"id": 915,
"value": [
"820002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856700526592,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-09"
]
},
{
"id": 916,
"value": [
"0719联系人09"
]
},
{
"id": 913,
"value": [
"207191159009"
]
},
{
"id": 3996,
"value": [
"207191159009"
]
},
{
"id": 915,
"value": [
"920002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"contactId": 487856697102336,
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},{
"id": 920,
"value": [
"2022-06-10"
]
},
{
"id": 916,
"value": [
"0719联系人10"
]
},
{
"id": 913,
"value": [
"207191159010"
]
},
{
"id": 3996,
"value": [
"207191159011"
]
},
{
"id": 915,
"value": [
"120002000测试描述瞎填915测试描述瞎填9152"
]
}
]
}
]
}'返回响应
🟢200成功
application/json
Body
code
integer
必需
message
string
必需
data
integer
必需
示例
{
"code": 0,
"message": "success",
"data": {
"errId": 487929766217728
}
}🟢200失败
修改于 2022-07-27 03:15:42