编辑线索
最后更新:2025/01/15企业可通过此接口编辑线索
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/clue/edit
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"clue_id": 1591005521987920962,
"clue_name": "线索1",
"clue_corp_name": "企业",
"clue_pool_id": 1591005280874161218,
"follow_user_id": "wovvCXcAAAT_dzekbq54K27FeMRBQJ2Q",
"label": "BQ",
"gender": "1",
"birthday": 1638720000000,
"email": "copr@email.com",
"area": "区域",
"area_code": "354271",
"remark": "描述",
"work_id": 200,
"coop_mode_type": "1",
"user_id": "wovvCXcAAAT_dzekbq48K27FeMRBQJ1Q",
"uin": "",
"encrypt_flag": 0,
"field_map":{
"customField": "自定义字段"
},
"address": "详细地址",
"business_tag_ids": "wfhsdihfsd,wsifhwefosdhfd",
"update_specified_fields": ["clue_name", "mf_clue_1"]
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
clue_id | long | 是 | 线索id |
clue_name | string | 是 | 线索名称 |
clue_corp_name | string | 否 | 线索企业名称,如果为空则会清空线索企业名称数据 |
clue_pool_id | long | 是 | 线索池id, |
follow_user_id | string | 是 | 跟进人id(分配的指定人员工id) |
label | string | 否 | 标签,如果为空则会清空标签数据 ,传标签ID, 英文逗号分隔 |
gender | string | 否 | 性别 0:男 1:女,如果为空则会清空性别数据 |
birthday | long | 否 | 生日,如果为空则会清空生日数据, 格式传秒级时间戳,如 1285904160 |
string | 否 | 邮箱,如果为空则会清空邮箱数据 | |
area | string | 否 | 地区,如果为空则会清空地区数据,格式 如"湖北省-武汉市-武昌区" |
area_code | string | 否 | 地区码,如果为空则会清空地区码数据(字段已废弃,可直接传area字段,传中文如"湖北省-武汉市-武昌区",系统会自动解析) |
access_customer_channel | string | 否 | 获客渠道,如果为空则会清空获客渠道数据,传输格式请参考自定义值字段设置的级联字段选项中文,如 "一级-二级-三级" |
remark | string | 否 | 描述,如果为空则会清空描述数据 |
work_id | int | 否 | 工单ID,如果为空则会清空工单ID数据 |
user_id | string | 是 | 用户id |
uin | string | 否 | 第三方线索id,如果为空则会清空第三方线索id数据 |
encrypt_flag | int | 否 | 是否加密.0-不加密,1-加密.默认不加密。如果为空则会清空是否加密数据 |
field_map | map | 否 | 自定义字段,当自定义字段为必填时,该字段必填; 当必填字段为单选时,传入ID值,如aaa:123465 多选,级联等字段时,需要入参字段数组id,如aaa:[1,2,3] 单行文本,多行文本等字段时,入参对应文本值即可 |
address | string | 否 | 详细地址,如果为空则会清空详细地址数据 |
business_tag_ids | string | 否 | 业务标签ID集合,使用英文逗号分隔 |
update_specified_fields | string | 否 | 单字段编辑时,指定的要编辑的字段KEY列表,不传或为空视为全部字段编辑,如编辑线索名称和自定义字段mf_clue_1,则传参["clue_name", "mf_clue_1"] |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": true
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | bool | 是否编辑成功 |