新增线索数据

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/salesleads/v1/addSalesLeads/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
	"empName":"负责人",
	"code":"code",
	"cus_name":"07271029",
	"poolName":"线索池名称",
	"source_type":"客户介绍",
	"market_name":"市场活动1",
	"linkman":"联系人1",
	"mobile":"18811111111",
	"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) 线索编码,校验是否已存在
cust_name VARCHAR(100) 客户名称
poolName VARCHAR(100) 线索名称,与负责人二者必填其一
source_type VARCHAR(100) 线索来源,校验是否存在
market_name VARCHAR(100) 市场活动名称,校验是否存在
linkman VARCHAR(100) 联系人
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[].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-失败, 其他参照附件错误码
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":"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) 线索池名称
cust_name VARCHAR(100) 客户名称
source_type VARCHAR(100) 线索来源,校验是否存在
market_name VARCHAR(100) 市场活动名称,校验是否存在
linkman VARCHAR(100) 联系人
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[].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-失败, 其他参照附件错误码
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-失败, 其他参照附件错误码
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) 创建时间起始
create_time_end VARCHAR(100) 创建时间结束
salesleads_status VARCHAR(1) 线索状态(1:待处理,2:跟进,3:无效,5:转换,6:未分配)
page INT 页码,默认1
pageSize INT 分页大小,默认1000

响应信息

{
    "return_code":"0",
    "return_msg":null,
    "msg_id":"90b4b267dd3d49aeace879038b1e7292",
    "response_data":{
        "id":"6789690485561771524",
        "cus_name":"api专用",
        "code":"",
        "source_type_name":"客户介绍",
        "market_name":"市场活动1",
        "linkman":"联系人1",
        "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",
        "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":"客户暂无需求",
        "customer_classification_name":"学校"
  }
}
参数 类型 必填 说明
id VARCHAR(32) 线索id
cust_name VARCHAR(100) 线索名称
source_type_name VARCHAR(100) 线索来源
market_name VARCHAR(100) 市场活动名称
linkman VARCHAR(100) 联系人
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) 负责人
status_value VARCHAR(100) 状态
result VARCHAR(100) 跟进内容
disable_reason_name VARCHAR(100) 线索无效原因
delete_reason_name 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) 创建时间
transf_time VARCHAR(100) 转换时间
owner_change_time VARCHAR(100) 负责人变更时间
follow_name VARCHAR(100) 最后跟进人
follow_time VARCHAR(100) 最后跟进时间
modifyier_name VARCHAR(100) 最后修改人
modify_time VARCHAR(100) 最后修改时间
customer_classification_name VARCHAR(100) 线索类型