新增线索接口
该接口用于向线索列表中增加新的线索,调用该接口需要有新增线索的权限。
请求方式:GET(HTTPS)
请求地址:/open/opportunity/create_opportunity?access_token=asdad154ad5545ad5d445a4d56a
请求包体:
{
"username": "ZhaoErZheng",
"contact_name": "张三",
"customer_name": "xxxx科技",
"phone": "xxxxxxx",
"tel": "xxxxx",
"email": "xxxxx@163.com",
"qq": "xxxxx",
"wechat": "xxxxx",
"duty": "产品研发",
"province": "上海市",
"city": "上海市",
"area": "浦东新区",
"address": "10号楼1003",
"source": "线上咨询",
"memo": "这个线索有意向",
"create_time": 1604046309,
"belong_user": "ZhaoErZheng",
"field": {
"备注": "这是一条线索",
"港口": "A港口",
"颜色": "红色,绿色"
}
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 授权凭证,参考:access_token接口 |
username | 是 | 账号 |
contact_name | 是 | 姓名 |
customer_name | 否 | 客户名称 |
phone | 否 | 手机(联系方式至少填一个) |
tel | 否 | 电话(联系方式至少填一个) |
否 | 邮箱(联系方式至少填一个) | |
否 | qq(联系方式至少填一个) | |
否 | 微信(联系方式至少填一个) | |
duty | 否 | 职位 |
province | 否 | 省 |
city | 否 | 市 |
area | 否 | 区 |
address | 否 | 地址 |
source | 否 | 来源 |
memo | 否 | 描述 |
create_time | 否 | 创建时间 (不填默认为当前时间) |
belong_user | 否 | 归属人(不填默认为账号) |
field | 否 | 自定义字段 例如:字段=》值 |
∟备注(单行文本) | 否 | 这是一条线索 |
∟港口(下拉单选) | 否 | A港口,B港口 |
∟颜色(下拉多选) | 否 | 红色,黄色,绿色 |
返回结果:
{
"code": 0,
"msg": "ok",
"opportunity_id": "aToxMjs"
}
参数说明:
参数 | 说明 |
---|---|
code | 出错返回码,为0表示成功,非0表示调用失败 |
msg | 返回码提示语 |
opportunity_id | 线索的唯一标识 |