获取联系人列表接口
该接口用于获取应用的权限范围内的联系人列表,调用该接口需要有联系人列表的权限。
请求方式:GET(HTTPS)
请求地址:/open/customer/get_contact_list?access_token=asdad154ad5545ad5d445a4d56a
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 授权凭证,参考access_token接口 |
username | 是 | 账号 |
contact_type | 否 | 联系人类型。默认全部 1客户联系人 、2线索联系人、3全部 |
teams | 否 | 查询范围。默认全部 1个人、2团队、3全部 |
page_size | 否 | 每次返回的联系人数,默认100条,每次最多返回200条 |
offset | 否 | 从第几条开始返回,默认第1条 |
start_time | 否 | 按修改时间查询。开始时间(时间戳) |
end_time | 否 | 按修改时间查询。结束时间(时间戳) |
返回结果:
{
"code": 0,
"msg": "ok",
"data": [
{
"id": "czo1OiI0OTQ2MCI7",
"contact_name": "李雷",
"phone": "13220621071",
"tel": "",
"email": "",
"wechat": "",
"qq": "",
"sex": null,
"department": null,
"duty": "",
"role": null,
"birthday": null,
"create_user": "赵尔征",
"create_time": "1589353370",
"memo": "",
"company_id": null,
"address_name": "",
"oppor_id": "czo1OiIzNjk3OCI7",
"enterprise_id": "45",
"contact_type": 2,
"company_name": null
},
{
"id": "czo1OiI0OTQ1OSI7",
"contact_name": "李华",
"phone": "13220621070",
"tel": "",
"email": "",
"wechat": "",
"qq": "",
"sex": "1",
"department": "",
"duty": "",
"role": "",
"birthday": "",
"create_user": "赵尔征",
"create_time": "1589346670",
"memo": "",
"company_id": "czo1OiIzNTA5MyI7",
"address_name": "",
"oppor_id": null,
"enterprise_id": "45",
"contact_type": 1,
"company_name": "测试客户"
}
]
}
参数说明:
参数 | 说明 |
---|---|
id | 联系人唯一标识 |
contact_name | 联系人姓名 |
sex | 性别 1男 2女 |
phone | 手机 |
tel | 座机 |
邮箱 | |
微信 | |
department | 所属部门 |
role | 角色,例:财务决策人 |
duty | 职务 |
birthday | 生日:2020-03-01 |
create_user | 创建人 |
create_time | 创建时间 |
memo | 备注 |
company_id | 所属客户 |
address_name | 地址 |
oppor_id | 所属线索 |
enterprise_id | 企业id |
contact_type | 联系人类型。1客户联系人、2线索联系人 |
company_name | 客户名称 |