编辑联系人
POST https://qw-openapi-tx.dustess.com/customer/v1/batchEditCustomer?accessToken=
Content-Type: application/json| 请求参数名 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| customer_list | Object[] | 联系人列表 | ture |
| customer_list.id | String | 尘锋联系人id（和external_id二选一必填） | false |
| customer_list.external_id | String | 外部联系人id （和id二选一必填） | false |
| customer_list.remark | String | 联系人名称 | false |
| customer_list.category_id | String | 联系人类型id联系人类型 | false |
| customer_list.corp_id | String | 企业id 查询企业列表 | false |
| customer_list.corp_full_name | String | 企业全称 | false |
| customer_list.mobiles | Object[] | 联系方式（联系人去重核心字段） | false |
| customer_list.mobiles.tel | String | 联系方式具体内容，如：type=mobile，则值为手机号码，支持传递国际手机号码，支持前缀传"+" | false |
| customer_list.mobiles.type | String | mobile（手机号），landline（座机），other（其他）,11b90rp60zya（自定义联系方式，如：微信号，id为示例，非真实自定义联系方式id）联系人联系方式 | false |
| customer_list.mobiles.display | String | 联系方式名称 | false |
| customer_list.position | String | 职务 | false |
| customer_list.source | String | 来源id，可传任意层级的来源id，该联系人会挂在来源id的所属层级来源列表查询（企业&联系人） | false |
| customer_list.prov_city | String | 省市区（县）,传参格式示例："四川省-成都市-武侯区" 或 "四川省/成都市/武侯区"，同时支持只传省、省市 | false |
| customer_list.address | String | 地址 | false |
| customer_list.birthday | String | 生日 | false |
| customer_list.email | String | email信息 | false |
| customer_list.gender | Int | 外部联系人性别 0-未知 1-男性 2-女性 | false |
| customer_list.description | String | 描述 | false |
| customer_list.custom_fields | Object[] | 自定义字段查询字段模版 | false |
| customer_list.custom_fields.id | String | 字段id | false |
| customer_list.custom_fields.array_value | Object[] | 字段类型为：checkbox（多项选择）,cascader（多级联选单选），multiCascader（多级联选多选）时使用此字段 | false |
| customer_list.custom_fields.type | String | 字段类型 | false |
| customer_list.custom_fields.float_value | Float64 | 字段类型为：Int（数字）时使用此字段 | false |
| customer_list.custom_fields.string_value | String | 字段类型为：radio（单选），date（日期），datetime（日期时间），text（单行文本），textarea（多行文本）时使用此字段 | false |
| customer_list.custom_fields.files_value | Object[] | 字段类型为：附件列表 时使用此字段, 最大文件个数5个 | false |
| customer_list.custom_fields.files_value.name | String | 文件名称, 使用附件类型必填 | false |
| customer_list.custom_fields.files_value.url | String | 文件链接, 使用附件类型必填 | false |
| customer_list.custom_fields.files_value.file_type | String | 文件类型, 可填为: word、image、text、pdf、audio、spreadsheetml(excel)、presentationml(ppt)、video、other | false |
| customer_list.tags | String[] | 好友标签id集合 | false |
| customer_list.age | Int | 年龄 | false |
| customer_list.national | String | 民族 | false |
| customer_list.nationality | String | 国籍 | false |
| customer_list.education | String | 学历id（小学 01，初中 02，高中 03，专科 04，本科 05，硕士 06，博士 07） | false |
| customer_list.major | String | 专业 | false |
| customer_list.id_card | String | 身份证 | false |
| customer_list.wx | String | 微信 | false |
| customer_list.qq | String | false | |
| customer_list.owner | String | 联系人主跟进人id 查询员工信息 | false |
| customer_list.pool | String | 公海id（和联系人主跟进人id二选一必填）,公海参数请确保系统中已经存在该公海，否则可能添加成功但查询不到联系人的情况 查询联系人公海列表 | false |
| customer_list.reason | String | 无效原因id 无效&放弃&删除原因查询 | false |
| customer_list.status | String | 联系人状态id 查询跟进状态列表 | false |
| customer_list.share_uids | String[] | 共享人员工id集合 | false |
json - Request-Example:{
"customer_list":[
{
"id":"d3e83957-175a-11eb-b365-1111111111111",
"custom_fields":[
{
"id":"field01",
"string_value":"",
"type":"text"
},
{
"id":"field71",
"array_value":[
"撒旦法",
"地方"
],
"type":"checkbox"
},
{
"id":"field91",
"array_value":[
"嗯嗯"
],
"type":"checkbox"
},{
"id": "field15",
"array_value": [
"组01=testttest"
],
"type":"multi-cascader"
},{
"id": "field16",
"array_value": [
"组01/组001/组001001=path/to/value"
],
"type":"multi-cascader"
}
],
"mobiles": [
{
"tel":"12500010002",
"type":"mobile",
"display":"手机号"
},
{
"tel": "ead12312acxzcasd",
"type": "11b90rp60zya",
"display": "微信号"
}
],
"categoryId":"00000000-0000-0000-0000-000000000000",
"age":26,
"remark":"张三",
"tags":[
"etDolHEAAAF2A3f71_Y81111111111",
"etDolHEAAAG0BIKWd7UHHP52U1111111"
],
"source":"searchEngines",
"prov_city":"天津市-天津市-河东区",
"address":"某村",
"birthday":"2020-09-16",
"gender":1,
"corp_full_name":"北京尘锋信息技术有限公司",
"corp_id":"cda55210-9fe5-11ea-bce3-111111111111",
"email":"test@qq.com",
"national":"02",
"position":"高级工程师",
"qq":"test",
"education":"05",
"description":"我是描述",
"nationality":"中国",
"id_card":"23451521111",
"wx":"dsaf111",
"major":"工程造价"
}
]
}| 响应参数名 | 类型 | 说明 |
|---|---|---|
| success | Bool | 请求状态，true：成功，false：失败 |
| code | Int | 响应代码 |
| msg | String | 消息提示 |
| data | Object | 数据信息 |
{
"success": true,
"msg": "",
"data": {
"fail": null,
"success": [
{
"code": 0,
"index": 1,
"id": "ad14ce98-ee88-11ea-9926-acde48001122",
"msg":""
},
{
"code": 0,
"index": 2,
"uuid": "ad334abc-ee88-11ea-9926-acde48001122",
"msg":""
}
]
}
} {
"success": false,
"code": 4126,
"msg": "",
"data": {
"fail": [{
"code": 13001,
"index": 3,
"id": "",
"msg":""
}],
"success": [{
"code": 0,
"index": 1,
"id": "ad14ce98-ee88-11ea-9926-acde48001122",
"msg":""
},{
"code": 0,
"index": 2,
"id": "ad334abc-ee88-11ea-9926-acde48001122",
"msg":""
}
]
}
} {
"success": false,
"code": 4126,
"msg": "",
"data": {
"fail": [{
"code": 13001,
"index": 1,
"id": "0",
"msg":""
},{
"code": 13000,
"index": 2,
"id": "0",
"msg":""
}
],
"success":null
}
}修改于 2025-03-18 02:33:41