新增客户接口
该接口用于向客户列表中增加新的客户,调用该接口需要有新增客户的权限。
请求方式:GET(HTTPS)
请求地址:/open/customer/create_customer?access_token=asdad154ad5545ad5d445a4d56a
请求包体:
{
"username": "admin",
"customer_class": "1",
"customer_name": "XX科技有限公司",
"type": "直接客户",
"industry": "互联网/信息技术",
"customer_tel": "1524435****",
"source": "线索转化",
"fax": "1515454****",
"scope": "1-10人",
"main_product": "主营产品",
"url": "www.baidu.com",
"memo": "备注备注",
"cooperater": "shenq,yuhy",
"label": "vip客户,黑铁客户",
"province": "山东省",
"city": "临沂市",
"area": "兰山区",
"address": "临沂大学",
"contact_name": "小耳",
"phone": "1322501****",
"tel": "15458548***",
"email": "zh121@qq.com",
"qq": "268216***",
"wechat": "zez6**",
"sex": "2",
"field": {
"网址": "www.baidu.com",
"港口": "A港口,B港口",
"到达时间":"2020-03-16",
"往来时间":"2020-03-06 07:45",
"文件附件":"8766ce39fe896062.xlsx,8766ce39fe896062.xlsx"
}
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 授权凭证,参考:access_token接口 |
username | 是 | 账号 |
customer_class | 是 | 客户属性:1:企业客户 2:个人客户 |
customer_name | 是 | 客户名称 |
corporate_name | 否 | 工作单位(仅个人客户) |
create_time | 否 | 创建时间(秒级时间戳格式),不填默认为当前时间 |
type | 否 | 客户类型,例:直接客户 |
level | 否 | 客户等级,例:潜在客户 |
industry | 否 | 所属行业,例:互联网/信息技术 |
customer_tel | 否 | 客户电话 |
source | 否 | 客户来源,例:线索转化 |
fax | 否 | 传真 |
scope | 否 | 客户规模,例:1-10人 |
main_product | 否 | 主营产品 |
url | 否 | 客户网址 |
memo | 否 | 备注 |
cooperater | 否 | 客户协作人,例:zhangsan,lisi |
label | 否 | 客户标签,例:A类客户,B类客户 |
province | 否 | 省份 |
city | 否 | 市 |
area | 否 | 区 |
address | 否 | 详细地址 |
contact_name | 否 | 联系人姓名,若该字段存在,则为该客户新增一条联系人信息 |
phone | 否 | 手机 |
tel | 否 | 电话 |
否 | 邮箱 | |
否 | ||
否 | 微信 | |
sex | 否 | 性别 1男 2女 |
belong_user | 否 | 归属人(不填默认为账号) |
status | 否 | 客户状态 默认为正常状态 -1为公海 |
field | 否 | 自定义字段 例如:字段=》值 |
∟网址(单行文本) | 否 | www.baidu.com |
∟港口(下拉多选) | 否 | A港口,B港口 |
∟到达时间(日期) | 否 | 2020-03-16 |
∟往来时间(日期+时间) | 否 | 2020-03-16 07:45 |
∟文件附件(附件) | 否 | 8766ce39fe896062.xlsx,8766ce39fe896062.xlsx |
返回结果:
{
"code": 0,
"msg": "ok",
"customer_id": "aToxMjs"
}
参数说明:
参数 | 说明 |
---|---|
code | 出错返回码,为0表示成功,非0表示调用失败 |
msg | 返回码提示语 |
customer_id | 客户的唯一标识 |