# 新增线索数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/addSalesLeads/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
	"empName":"负责人",
	"code":"code",
	"cus_name":"api专用",
	"poolName":"线索池名称",
	"source_type":"客户介绍",
	"market_name":"市场活动1",
	"linkman":"联系人1",
	"mobile_country":"86",
	"mobile":"18811111111",
	"mobile_repeat":"0",
	"tel":"02588888888",
	"customer_classification_name":"学校",
	"position":"公务员",
	"detail":"线索详情线索详情",
	"mssProvinceName":"江苏省",
	"mssCityName":"南京市",
	"mssAreaName":"建邺区",
	"mssStreetName":"沙洲街道",
	"mark_addr":"江苏省南京市雨花台区春江路1号肯德基(铁心桥餐厅)",
	"email":"waiqin365@waiqin365.com",
	"website":"https://api.waiqin365.com/",
	"address":"江苏省南京市雨花台区春江路1号肯德基(铁心桥餐厅)",
	"latlon":"31.963018601806095,118.76207851993819",
    "exts":[ {
               "salesleads_ext_key":"自定义字段1",
                "salesleads_ext_value":"api测试用啊"
                 },{
                 "salesleads_ext_key":"自定义字段2",
                  "salesleads_ext_value":"测试用"
                  }]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
empName VARCHAR(100) 负责人
poolName VARCHAR(100) 线索池名称,与负责人二者必填其一
code VARCHAR(100) 线索编码,校验是否已存在
cus_name VARCHAR(100) 客户名称
source_type VARCHAR(100) 线索来源,校验是否存在
market_name VARCHAR(100) 市场活动名称,校验是否存在
linkman VARCHAR(100) 联系人
mobile_country VARCHAR(32) 手机号码国家码
mobile VARCHAR(100) 手机号码
mobile_repeat CHAR(1) 手机号码是否能重复,0:不可以,1或空:可以
tel VARCHAR(100) 固话
customer_classification_name VARCHAR(100) 线索类型
position VARCHAR(100) 职务
detail VARCHAR(4000) 线索详情
mssProvinceName VARCHAR(100) 省名称
mssCityName VARCHAR(100) 市名称
mssAreaName VARCHAR(100) 区县名称
mssStreetName VARCHAR(100) 乡镇街道名称
mark_addr VARCHAR(100) 地址
email VARCHAR(100) 邮箱
website VARCHAR(100) 网址
latlon VARCHAR(400) 标注位置
address VARCHAR(4000) 标注位置
exts List 自定义字段列表
exts.salesleads_ext_key VARCHAR(100) 自定义字段key
exts.salesleads_ext_value VARCHAR(100) 自定义字段value

响应示例:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": "90b4b267dd3d49aeace879038b1e7291",
    "response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 新增apaas线索数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/addSalesLeadsForApaas/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
	"company_name":"示例公司",
	"code":"L90188053235235",
	"source_type":"客户介绍",
	"customer_classification_name":"学校",
    "return_reason":"原因",
	"invalid_reason":"失效",
	"market_name":"市场活动名称",
	"mobile":{"phone":"18912804466","code": "86"},
	"linkman":"联系人",
	"telephone":"02588888888",
	"position":"公务员",
	"detail":"线索详情线索详情",
	"mss_country":"中国",
    "mss_province":"江苏省",
	"mss_city":"南京市",
	"mss_area":"建邺区",
	"mss_street":"沙洲街道",
	"mark_addr":"江苏省南京市雨花台区春江路1号肯德基(铁心桥餐厅)",
	"email":"waiqin365@waiqin365.com",
	"website":"https://api.waiqin365.com/",
	"latitude":"31.963018601806095",
    "longitude":"118.76207851993819",
    "address":"江苏省南京市雨花台区春江路",
    "allocation_status":"1",
    "salesleads_status":"1",
    "pool_name":"默认线索池",
    "removed_result":"暂无",
    "labels":"示例标签",
    "responsible_person":"负责人ID",
    "card_photo":"名片",
    "mobile_duplicate":"1",
    "exts":{  "field_kig9p__cywdzm9": "10000.00",
              "field_dacfk__cxuv3jd": "1214123412341234",
              "field_puezh__cdc07gx": "12341234125463457634567",
              "field_db3nn__ctvj575": "2024-07-26",
              "field_xvw5t__cz8n029": "j8gKhgpu",
              "field_swe5j__cpzhpuj": "xA62mwYV,QlmleNPY"
            }
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
code VARCHAR(100) 线索编码
company_name VARCHAR(100) 企业名称
source_type VARCHAR(100) 线索来源
customer_classification_name VARCHAR(100) 线索类型
return_reason VARCHAR(100) 退回原因
invalid_reason VARCHAR(100) 作废原因
market_name VARCHAR(100) 市场活动名称
market_id VARCHAR(100) 市场活动id
linkman VARCHAR(100) 联系人
mobile VARCHAR(100) 手机号码
mobile_duplicate CHAR(1) 手机号码是否能重复,0:不可以,1或空:可以
telephone VARCHAR(100) 固话
position VARCHAR(100) 职务
detail VARCHAR(4000) 线索详情
mss_country VARCHAR(100) 国家
mss_province VARCHAR(100) 省名称
mss_city VARCHAR(100) 市名称
mss_area VARCHAR(100) 区县名称
mss_street VARCHAR(100) 乡镇街道名称
latitude VARCHAR(400) 纬度
longitude VARCHAR(400) 经度
address VARCHAR(100) 标注位置
mark_addr VARCHAR(100) 地址
email VARCHAR(100) 邮箱
website VARCHAR(100) 网址
allocation_status VARCHAR(100) 分配状态 1:已分配, 0:未分配.未分配的线索进入线索池,必填线索池字段,负责人字段为空;已分配的线索,负责人字段必填
salesleads_status VARCHAR(100) 跟进状态 1:待处理,2:跟进中,5:转换
pool_name VARCHAR(100) 线索池
remove_result VARCHAR(100) 作废补充说明
labels VARCHAR(100) 线索标签
responsible_person VARCHAR(100) 负责人ID
card_photo VARCHAR(100) 名片
exts List 自定义字段列表
exts.salesleads_ext_key VARCHAR(100) 自定义字段key
exts.salesleads_ext_value VARCHAR(100) 自定义字段value

响应示例:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": "90b4b267dd3d49aeace879038b1e7291",
    "response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 修改线索数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/modifySalesLeads/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "id": 6789690485561771524,
    "code": "codezs",
    "poolName": "线索池名称",
    "cus_name": "api专用",
    "source_type": "客户介绍",
    "market_name": "市场活动1",
    "linkman": "联系人1",
    "mobile_country": "86",
    "mobile": "18811111111",
    "tel": "02588888888",
    "customer_classification_name": "学校",
    "position": "公务员",
    "detail": "线索详情线索详情",
    "mssProvinceName": "江苏省",
    "mssCityName": "南京市",
    "mssAreaName": "建邺区",
    "mssStreetName": "沙洲街道",
    "mark_addr": "南京市铁心桥",
    "email": "waiqin365@waiqin365.com",
    "website": "https://api.waiqin365.com/",
    "address": "江苏省南京市雨花台区春江路1号肯德基(铁心桥餐厅)",
    "latlon": "31.963018601806095,118.76207851993819",
    "exts": [
        {
            "salesleads_ext_key": "自定义字段1",
            "salesleads_ext_value": "api测试用啊"
        },
        {
            "salesleads_ext_key": "自定义字段2",
            "salesleads_ext_value": "测试用"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(40) 线索ID
code VARCHAR(100) 线索编码,校验是否已存在。与线索ID不能同时为空
poolName VARCHAR(100) 线索池名称
cus_name VARCHAR(100) 客户名称
source_type VARCHAR(100) 线索来源,校验是否存在
market_name VARCHAR(100) 市场活动名称,校验是否存在
linkman VARCHAR(100) 联系人
mobile_country VARCHAR(32) 手机号码国家码
mobile VARCHAR(100) 手机号码
tel VARCHAR(100) 固话
customer_classification_name VARCHAR(100) 线索类型
position VARCHAR(100) 职务
detail VARCHAR(4000) 线索详情
mssProvinceName VARCHAR(100) 省名称
mssCityName VARCHAR(100) 市名称
mssAreaName VARCHAR(100) 区县名称
mssStreetName VARCHAR(100) 乡镇街道名称
mark_addr VARCHAR(100) 地址
email VARCHAR(100) 邮箱
website VARCHAR(100) 网址
latlon VARCHAR(400) 标注位置
address VARCHAR(4000) 标注位置
exts List 自定义字段列表
exts Map 扩展字段集合。json数据格式为{"ext_keyA": "ext_valueA"}。参数格式参考 (opens new window)

响应示例:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": "90b4b267dd3d49aeace879038b1e7291",
    "response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 修改apaas线索数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/modifySalesLeadsForApaas/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "id": 5031887187231707391,
    "company_name": "掌控网络",
    "source_type": "智能拓店",
    "customer_classification_name": "运动场馆",
    "return_reason": "联系不上客户",
    "invalid_reason": "其他",
    "market_name": "市场活动",
    "linkman": "张三",
    "mobile": {
        "phone":"15444212232", 
        "code":"86"
    },
    "telephone": "",
    "position": "经理",
    "detail": "这是一个线索详情",
    "mss_country": "中国",
    "mss_province": "江苏省",
    "mss_city": "南京",
    "mss_area": "建邺区",
    "mss_street": "秣陵街道",
    "mark_address": "江苏省南京市建邺区国家广告产业园",
    "email": "qince@163.com",
    "website": "https://qince.com",
    "allocation_status": "1",
    "salesleads_status": "1",
    "pool_name": "默认线索池",
    "removed_result": null,
    "salesleads_label": null,
    "responsible_person: "5031887187231707391",
    "card_photo": null,
    "exts:{ "field_kig9p__cywdzm9": "10000.00",
            "field_dacfk__cxuv3jd": "1214123412341234",
            "field_puezh__cdc07gx": "12341234125463457634567",
            "field_db3nn__ctvj575": "2024-07-26",
            "field_xvw5t__cz8n029": "j8gKhgpu",
            "field_swe5j__cpzhpuj": "xA62mwYV,QlmleNPY"
         }
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id BIGINT 线索ID
code VARCHAR(100) 线索编码,校验是否已存在。与线索ID不能同时为空
company_name VARCHAR(100) 企业名称
source_type VARCHAR(100) 来源。支持传入来源选项值名称
customer_classification_name VARCHAR(100) 线索类型。支持传入选项值名称
return_reason VARCHAR(100) 退回原因。支持传入选项值名称
invalid_reason VARCHAR(100) 作废原因。支持传入选项值名称
market_name VARCHAR(100) 市场活动名称。市场活动取值优先级:市场活动勤策id>市场活动名称
market_id VARCHAR(100) 市场活动id。市场活动取值优先级:市场活动勤策id>市场活动名称
linkman VARCHAR(100) 联系人
mobile VARCHAR(100) phone:手机号. code:国家编码
telephone VARCHAR(100) 固话
position VARCHAR(100) 职位
detail VARCHAR(4000) 销售线索详情
mss_country VARCHAR(32) 国家名称
mss_province VARCHAR(32) 省名称
mss_city VARCHAR(32) 市名称
mss_area VARCHAR(32) 区县名称
mss_street VARCHAR(32) 乡镇街道名称
mark_address VARCHAR(200) 地址
email VARCHAR(100) 邮箱
website VARCHAR(200) 地址
allocation_status VARCHAR(200) 分配状态。1:已分配,0:未分配。未分配的线索进入线索池,必填线索池字段,负责人字段为空;已分配的线索,负责人字段必填
salesleads_status VARCHAR(200) 跟进状态。1:待处理,2:跟进中,5:已转换
pool_name VARCHAR(100) 线索池
removed_result VARCHAR(100) 作废补充说明
labels VARCHAR(100) 线索标签
responsible_person VARCHAR(32) 负责人id(勤策员工id)
card_photo VARCHAR(100) 名片
exts Map 扩展字段集合。json数据格式为{"ext_keyA": "ext_valueA"}。参数格式参考 (opens new window)

响应示例:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": "90b4b267dd3d49aeace879038b1e7291",
    "response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 删除线索数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/removeSalesLeads/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
	"code":"codezs",
	"emp_id":"5061962864497943367",
	"reason_id":1000025,
	"content":"api删除1342"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
id VARCHAR(40) 线索ID
code VARCHAR(100) 线索编码,校验是否已存在。与线索ID不能同时为空
reason_id VARCHAR(40) 作废原因编码,校验是否已存在
content VARCHAR(4000) 作废原因

响应示例:

{
    "return_code": "0",
    "return_msg": null,
    "msg_id": "90b4b267dd3d49aeace879038b1e7291",
    "response_data": null
}

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 线索数据查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/querySalesLeads/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
	"code":"codezs",
    "id":"5025653528380651509",
    "linkman":"联系人",
    "mobile":"18811111111",
    "emp_name":"张三",
    "cus_name":"线索1",
    "create_time_start":"2020-01-20",
    "create_time_end":"2020-09-20",
    "salesleads_status":"1",
    "page":1,
    "pageSize":10
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:
注:查询条件至少需要填写一个参数

参数 类型 必填 说明
code VARCHAR(100) 线索编码
id VARCHAR(100) 线索id
linkman VARCHAR(100) 联系人
mobile VARCHAR(40) 手机号码
emp_name VARCHAR(100) 负责人
cus_name VARCHAR(100) 线索名称
create_time_start VARCHAR(100) 创建时间起始。格式:yyyy-MM-dd
create_time_end VARCHAR(100) 创建时间结束。格式:yyyy-MM-dd
modify_time_start VARCHAR(100) 修改时间起始。格式:yyyy-MM-dd
modify_time_end VARCHAR(100) 修改时间结束。格式:yyyy-MM-dd
salesleads_status VARCHAR(1) 线索状态。1:待处理,2:跟进,3:无效,5:转换,6:未分配
page INT 页码,默认1
pageSize INT 分页大小,默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
     {
         "id":"6789690485561771524",
         "cus_name":"api专用",
         "code":"",
         "source_type_name":"客户介绍",
         "market_name":"市场活动1",
         "linkman":"联系人1",
		 "mobile_country":"86",
         "mobile":"18811111111",
         "tel":"02588888888",
         "position":"公务员",
         "detail":"线索详情",
         "mss_province":"江苏省",
         "mss_city":"南京市",
         "mss_area":"雨花台区",
         "mss_street":"",
         "mark_addr":"江苏省南京市雨花台区春江路1号肯德基(铁心桥餐厅)详细地址",
         "email":"waiqin365@waiqin365.com",
         "website":"https://api.waiqin365.com/",
         "emp_name":"李四",
         "status_value":"跟进",
         "emp_id_str":"5025653528380651509",
         "create_time":"2020-07-25 14:45",
         "owner_change_time":"2020-07-27 17:10",
         "result":"跟进内容",
         "disable_reason_name":"线索重复2",
         "disable_reason_ext":"误操作重复导入了",
         "creator_name":"系统",
         "follow_name":"张三",
         "follow_time":"2020-07-27 19:43",
         "modifyier_name":"张三",
         "transf_time":"",
         "modify_time":"2020-07-27 19:42",
         "pool_name":"",
         "distribution_name":"",
         "distribution_take_time":"",
         "return_reason_name":"",
         "delete_reason_name":"客户暂无需求",
         "delete_reason_ext":"录制错误了",
         "customer_classification_name":"学校",
         "cm_code":"CUS000044",
         "cm_name":"已转换客户名称",
         "labels":[
            {
                "salesleads_id":"6789690485561771524",
                "color":"#cc0000",
                "name":"重复",
                "rule_description":"新增、编辑线索时根据设置的查重条件检查当前线索是否与系统内已存在的线索重复,如果重复则打上此标签",
                "id":"1",
                "status":"1"
            }
         ],
         "exts":[
            {
                "ext_column":"ext_2206290023",
                "ext_key":"数值111",
                "ext_value":"10"
            }
         ]
     }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 线索id
cus_name VARCHAR(100) 线索名称
code VARCHAR(100) 线索编码
source_type_name VARCHAR(100) 线索来源
market_name VARCHAR(100) 市场活动名称
linkman VARCHAR(100) 联系人
mobile_country VARCHAR(32) 手机号码国家码
mobile VARCHAR(100) 手机号码
tel VARCHAR(100) 固话
position VARCHAR(100) 职务
detail VARCHAR(4000) 线索详情
mss_province VARCHAR(100) 省名称
mss_city VARCHAR(100) 市名称
mss_area VARCHAR(100) 区县名称
mss_street VARCHAR(100) 乡镇街道名称
mark_addr VARCHAR(100) 地址
email VARCHAR(100) 邮箱
website VARCHAR(100) 网址
emp_name VARCHAR(100) 负责人
emp_id_str VARCHAR(100) 负责人勤策id
status_value VARCHAR(100) 状态
result VARCHAR(100) 跟进内容
disable_reason_name VARCHAR(100) 线索无效原因
disable_reason_ext VARCHAR(100) 无效补充说明
delete_reason_name VARCHAR(100) 作废原因
delete_reason_ext VARCHAR(100) 作废补充说明
return_reason_name VARCHAR(4000) 退回原因
pool_name VARCHAR(4000) 所属线索池
distribution_name VARCHAR(100) 分配人
distribution_take_time VARCHAR(100) 分配时间
creator_name VARCHAR(100) 创建人
create_time VARCHAR(100) 创建时间。格式:yyyy-MM-dd HH:mm
transf_time VARCHAR(100) 转换时间
owner_change_time VARCHAR(100) 负责人变更时间。格式:yyyy-MM-dd HH:mm
follow_name VARCHAR(100) 最后跟进人
follow_time VARCHAR(100) 最后跟进时间。格式:yyyy-MM-dd HH:mm
modifyier_name VARCHAR(100) 最后修改人
modify_time VARCHAR(100) 最后修改时间。格式:yyyy-MM-dd HH:mm
customer_classification_name VARCHAR(100) 线索类型
cm_code VARCHAR(100) 已转换客户编码
cm_name VARCHAR(100) 已转换客户名称
labels List 标签列表
labels.salesleads_id VARCHAR(100) 标签对应线索id
labels.color VARCHAR(100) 标签颜色
labels.name VARCHAR(100) 标签名
labels.rule_description VARCHAR(100) 标签规则描述
labels.id VARCHAR(100) 标签id
labels.status VARCHAR(100) 标签status
exts List 自定义字段列表
exts.ext_key VARCHAR(100) 自定义字段key
exts.ext_value VARCHAR(100) 自定义字段value
exts.ext_column VARCHAR(100) 自定义字段column

# 线索apaas数据查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/querySalesLeadsForApaas/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
	"code":"codezs",
    "id":"5025653528380651509",
    "linkman":"联系人",
    "mobile":"18811111111",
    "emp_name":"张三",
    "cus_name":"线索1",
    "create_time_start":"2025-01-20",
    "create_time_end":"2025-09-20",
    "modify_time_start":"2025-01-20",
    "modify_time_end":"2025-01-21",
    "salesleads_status":"1",
    "sorts": {"field_key": "create_time", "type": "asc"},
    "query_group": {"connector": "AND", "filters": {"field_key": " ", "field_values":" ","operator": ""} },
    "page":1,
    "pageSize":10
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:
注:查询条件至少需要填写一个参数

参数 类型 必填 说明
code VARCHAR(100) 线索编码
id VARCHAR(100) 线索id
linkman VARCHAR(100) 联系人
mobile VARCHAR(40) 手机号码
emp_name VARCHAR(100) 负责人
cus_name VARCHAR(100) 线索名称
create_time_start VARCHAR(100) 创建时间起始。格式:yyyy-MM-dd
create_time_end VARCHAR(100) 创建时间结束。格式:yyyy-MM-dd
modify_time_start VARCHAR(100) 修改时间起始。格式:yyyy-MM-dd
modify_time_end VARCHAR(100) 修改时间结束。格式:yyyy-MM-dd
salesleads_status VARCHAR(1) 线索状态。1:待处理,2:跟进,3:无效,5:转换,6:未分配
sort List 排序,默认按照创建时间排序
sort.field_key VARCHAR(30) 排序字段
sort.type VARCHAR(1) 排序类型:asc正序, desc倒序
query_group List 查询条件列表
query_group.connector List 组内查询条件,条件AND或OR
query_group.filters VARCHAR(4) 组内查询条件
query_group.filters.field_key VARCHAR(30) 字段key
query_group.filters.operator VARCHAR(32) 操作符,详见附录操作符说明 (opens new window)
query_group.filters.field_values List 字段值集合
page INT 页码,默认1
pageSize INT 分页大小,默认1000

响应示例:

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "card_photo": [
      {
        "path": "apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
        "name": null,
        "url": "http://image-test.waiqin365.com/7872470323618986146/apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg"
      }
    ],
    "code": "L2025040300000568",
    "mss_province": {
      "code": "320000",
      "name": "江苏省"
    },
    "return_reason_id": {
      "code": "THYY0001",
      "label": "联系不上客户",
      "content": null
    },
    "customer_classification":{
        "code": "YDCG",
        "label": "运动场馆",
        "content": null
    },
    "salesleads_status": {
      "code": "4YJHrhGk",
      "label": "待处理",
      "content": null
    },
    "source_type_id": {
      "code": "LY0002",
      "label": "会议",
      "content": null
    },
    "mss_area": {
      "code": "320105",
      "name": "建邺区"
    },
    "mark_addr": "国家广告园",
    "tel": "8875412",
    "mss_street": {
      "code": "320105002",
      "name": "沙洲街道"
    },
    "id": "4983449723663499848",
    "exts": {
      "field_VjL4R__c": {
        "code": "选项1",
        "label": "选项1",
        "content": null
      },
      "field_dV3SL__c": [
        {
          "path": "apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
          "name": "5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
          "url": "http://image-test.waiqin365.com/7872470323618986146/apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg"
        },
        {
          "path": "apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
          "name": "5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
          "url": "http://image-test.waiqin365.com/7872470323618986146/apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg"
        }
      ],
      "field_8wbqi__c": "单行文本",
      "field_Jl4uS__c": {
        "format": "YYYY-MM-DD",
        "value": "2025-12-31"
      },
      "field_MB2ri__c": [
        {
          "code": "选项1",
          "label": "选项1",
          "content": null,
          "status": "1"
        },
        {
          "code": "选项2",
          "label": "选项2",
          "content": null,
          "status": "1"
        }
      ],
      "field_AaZnB__c": "22.00",
      "field_L0Ok0__c": {
        "code": "4LCM1jU6",
        "label": "选项1",
        "content": null
      },
      "field_1B7iQ__c": "多行文本",
      "field_JTEBH__c": [
        {
          "path": "apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
          "name": null,
          "url": "http://image-test.waiqin365.com/7872470323618986146/apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg"
        },
        {
          "path": "apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg",
          "name": null,
          "url": "http://image-test.waiqin365.com/7872470323618986146/apaas/salesleads_info/5fb13110e1de13d4c11e6e7f5b8026da_r.jpg"
        }
      ]
    },
    "email": "234242@qq.com",
    "owner": {
      "name": "老板",
      "id": "6044797260167447230",
      "status": "1"
    },
    "website": "http://www.dsdsd.com",
    "mss_country": {
      "code": "86",
      "name": "中国"
    },
    "mobile": {
      "code": "86",
      "phone": "15269887453"
    },
    "market_id": {
      "name": "试个水",
      "id": "7715879860058939412",
      "status": "1"
    },
    "label_names": "人工设置标签,人工设置标签1",
    "linkman": "联系人哇",
    "mss_city": {
      "code": "320100",
      "name": "南京市"
    },
    "pool_name": "默认线索池",
    "company_name": "测试企业",
    "invalid_reason_id": null,
    "allocation_status": {
      "code": "YWsaHzOn",
      "label": "已分配",
      "content": null
    },
    "removed_result": "找不到客户"
  }
]

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 线索id
company_name VARCHAR(100) 线索名称
code VARCHAR(100) 线索编码
source_type_id VARCHAR(100) 线索来源
customer_classification VARCHAR(100) 线索类型
return_reason_id VARCHAR(100) 退回原因
delete_reason_id VARCHAR(100) 作废原因
market_id VARCHAR(100) 市场活动
linkman VARCHAR(100) 联系人
mobile VARCHAR(100) 手机号码
tel VARCHAR(100) 固话
position VARCHAR(100) 职务
detail VARCHAR(4000) 线索详情
mss_country VARCHAR(100) 国家名称
mss_province VARCHAR(100) 省名称
mss_city VARCHAR(100) 市名称
mss_area VARCHAR(100) 区县名称
mss_street VARCHAR(100) 乡镇街道名称
mark_addr VARCHAR(100) 地址
email VARCHAR(100) 邮箱
website VARCHAR(100) 网址
allocation_status VARCHAR(100) 分配状态
salesleads_status VARCHAR(100) 跟进状态
label_names VARCHAR(100) 线索标签
pool_name VARCHAR(100) 线索池
removed_result VARCHAR(100) 作废说明
owner VARCHAR(100) 负责人
card_photo VARCHAR(100) 名片
exts List 自定义字段列表

# 推送线索跟进记录

当提交了线索跟进记录时则将跟进记录进行推送

请求方式: POST(HTTPS
请求地址: 第三方服务接口URL

请求参数:

参数名称 参数值
msgId 消息ID
dataId 数据ID
dataVersion 接口数据版本,如:001
dataFormat 数据格式:json
dataSource 数据来源。biz:业务功能产生,api:开放接口产生
timestamp 请求时间戳,如:1503276678552
status 数据同步状态。0:数据首次同步,2:数据失败同步
statusTime 上次同步失败时间。格式:yyyy-MM-dd HH:mm:ss
tenantId 企业ID,各注册企业在勤策中对应的唯一ID
digest 数据签名,md5(data|pushsecret|timestamp)
dataType salesLeads_follow
data <<请求数据体>> ,说明:格式为JSON格式数据

请求数据体:

{
      "lead_ID": "SK202101090003",
      "lead_code": "zsmd",
      "lead_name":"张三门店",
      "activity_type":"",
      "activity_content": "zhangsan",
      "location": "10,20",
      "offset": "50",
      "photo_path": "/aaa/bb.png",
      "create_by": "创建人",
      "department": "部门",
      "create_at": "yyyy-mm-dd hh:mm",
      "ext_*":"自定义字段"
   }

参数说明:

参数 类型 必填 说明
lead_ID INT8 线索ID
lead_code VARCHAR(32) 线索编码
lead_name VARCHAR(32) 客户名称
activity_type VARCHAR(32) 跟进方式,取跟进方式描述
activity_content VARCHAR(32) 跟进内容
location VARCHAR(32) 位置,取位置描述
offset varchar(32) 偏差(米)
photo_path VARCHAR(32) 照片路径。格式:yyyy-mm-dd
create_by VARCHAR(32) 跟进人(跟进人姓名)
department VARCHAR(32) 跟进人部门,跟进人所在部门描述
create_at VARCHAR(32) 跟进时间。格式:yyyy-mm-dd hh:mm
ext_* VARCHAR(32) 自定义字段

响应示例:

{
    "return_code": 0,
    "return_msg": "",
    "msg_id": "X0001"
}

参数说明:

参数 说明
return_code 响应编码
return_msg 响应消息内容
msg_id 消息ID