创建线索
最后更新:2025/01/15企业可通过此接口创建线索
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/clue/add
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"clue_name": "线索1",
"mobile_phone": "13000000000",
"clue_corp_name": "企业",
"clue_pool_id": 100,
"follow_user_id": "Wang",
"label": "BQ",
"gender": "1",
"birthday": 1638720000000,
"email": "copr@email.com",
"area": "区域",
"area_code": "354271",
"access_customer_channel": "1",
"remark": "描述",
"work_id": 200,
"coop_mode_type": "1",
"user_id": "Wang",
"data_source_type": 1,
"uin": "",
"encrypt_flag": 0,
"field_map":{
"customField": "自定义字段"
},
"address": "详细地址",
"business_tag_ids": "wfhsdihfsd,wsifhwefosdhfd"
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
clue_name | string | 是 | 线索名称 |
mobile_phone | 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 | 否 | 生日,秒级时间戳 |
string | 否 | 邮箱 | |
area | string | 否 | 地区,格式 如"湖北省-武汉市-武昌区" |
area_code | string | 否 | 地区码(字段已废弃,可直接传area字段,传中文如"湖北省-武汉市-武昌区",系统会自动解析) |
access_customer_channel | string | 否 | 获客渠道,传输格式请参考自定义值字段设置的级联字段选项中文,如 "一级-二级-三级" |
remark | string | 否 | 描述 |
work_id | int | 否 | 工单ID |
coop_mode_type | int | 否 | 字段已废弃; 协作模式1:多负责人,不开启企业模式,2:多负责人,开启企业模式,3:锁定负责人,不开启企业模式,4:锁定负责人,开启企业模式。 ; |
user_id | string | 是 | 用户id |
uin | string | 否 | 第三方线索id |
encrypt_flag | int | 否 | 是否加密.0-不加密,1-加密.默认不加密. |
field_map | map | 否 | 自定义字段,当自定义字段为必填时,该字段必填; 当必填字段为单选时,传入ID值,如aaa:123465 多选,级联等字段时,需要入参字段数组id,如aaa:[1,2,3] 单行文本,多行文本等字段时,入参对应文本值即可 |
address | string | 否 | 详细地址 |
business_tag_ids | string | 否 | 业务标签ID集合,使用英文逗号分隔 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": 21040
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | long | 线索id |