# 客户联系人信息接口
# 新增客户联系人信息
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/linkman/v1/addLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| linkmans | 联系人列表 | ||
| linkmans .customer_id | VARCHAR(100) | 否 | 来源于第三方系统客户唯一标识，和勤策客户唯一标识不能同时为空 |
| linkmans .waiqin365_customer_id | VARCHAR(100) | 否 | 勤策客户唯一标识，和第三方系统客户唯一标识不能同时为空。waiqin365_customer_id、customer_id如果同时存在优先取waiqin365_customer_id |
| linkmans .linkman_id | VARCHAR(32) | 是 | 联系人唯一ID，来源于第三方 |
| linkmans .linkman | VARCHAR(32) | 是 | 联系人姓名 |
| linkmans .linkman_job | VARCHAR(32) | 否 | 联系人职务 |
| linkmans .linkman_mobile | VARCHAR(32) | 是 | 联系人手机号 |
| linkmans .linkman_fax | VARCHAR(32) | 否 | 联系人传真, 如：02544550010 |
| linkmans .linkman_office_tel | VARCHAR(32) | 否 | 联系人固定电话, 如：02544550010 |
| linkmans .linkman_sex | VARCHAR(1) | 否 | 联系人性别。M：男，F：女。默认M |
| linkmans .linkman_birthday | timestamp | 否 | 联系人生日 |
| linkmans .linkman_email | VARCHAR(100) | 否 | 联系人电子邮件 |
| linkmans .linkman_remarks | VARCHAR(4000) | 否 | 联系人备注 |
| linkmans .linkman_qq | VARCHAR(100) | 否 | 联系人QQ |
| linkmans .linkman_weixin | VARCHAR(100) | 否 | 联系人微信 |
| linkmans .linkman_dept | VARCHAR(200) | 否 | 联系人部门 |
| linkmans .linkman_main | VARCHAR(1) | 否 | 是否为主联系人。0：否，1：是。默认值:0 |
| linkmans .linkman_intimacy | VARCHAR(100) | 否 | 联系人亲密度，必须是系统预定义值 |
| linkmans .linkman_importance | VARCHAR(100) | 否 | 联系人重要程度，必须是系统预定义值 |
| linkmans .linkman_decision_relationship | VARCHAR(100) | 否 | 联系人决策关系，必须是系统预定义值 |
| linkmans .exts.linkman_ext_key | VARCHAR(100) | 否 | 联系人信息扩展字段key值，联系人信息扩展字段需先在勤策系统客户管理中创建自定义字段 |
| linkmans .exts.linkman_ext_value | VARCHAR(4000) | 否 | 联系人信息扩展字段value值 |
| linkmans .open_cus_account | VARCHAR(1) | 否 | 是否开通客户账号。1：开通客户账号，0：不开通客户账号。可以不传，不传表示不开通客户账号 |
| linkmans .cus_acc_roles | VARCHAR(4000) | 否 | 客户账号角色名称。如有多个角色用逗号隔开。如果是否开通客户账号的值传"是"，则此字段不能为空 |
响应示例：
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
# 修改客户联系人信息
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/linkman/v1/modifyLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| linkmans | 联系人列表 | ||
| linkmans .linkman_id | VARCHAR(32) | 否 | 来源于第三方系统联系人唯一标识，和勤策联系人唯一标识不能同时为空 |
| linkmans .waiqin365_linkman_id | VARCHAR(32) | 否 | 勤策联系人唯一标识，和第三方系统联系人唯一标识不能同时为空。linkman_id、waiqin365_linkman_id如果同时存在优先取waiqin365_linkman_id |
| linkmans .customer_id | VARCHAR(32) | 否 | 来源于第三方系统客户唯一标识，和勤策客户唯一标识不能同时为空 |
| linkmans .waiqin365_customer_id | VARCHAR(32) | 否 | 勤策客户唯一标识，和第三方系统客户唯一标识不能同时为空。waiqin365_customer_id、customer_id如果同时存在优先取waiqin365_customer_id |
| linkmans .linkman_status | VARCHAR(1) | 否 | 联系人状态。0：删除，1：正常 |
| linkmans .linkman_job | VARCHAR(32) | 否 | 联系人职务 |
| linkmans .linkman_mobile | VARCHAR(32) | 否 | 联系人手机号 |
| linkmans .linkman_office_tel | VARCHAR(32) | 否 | 联系人固定电话 |
| linkmans .linkman_fax | VARCHAR(32) | 否 | 联系人传真 |
| linkmans .linkman_email | VARCHAR(100) | 否 | 联系人电子邮件 |
| linkmans .linkman_sex | VARCHAR(1) | 否 | 联系人性别。F：女性，M：男性。默认值：M |
| linkmans .linkman_birthday | timestamp | 否 | 联系人生日 |
| linkmans .linkman_qq | VARCHAR(100) | 否 | 联系人qq |
| linkmans .linkman_weixin | VARCHAR(100) | 否 | 联系人微信 |
| linkmans .linkman_dept | VARCHAR(200) | 否 | 联系人部门 |
| linkmans .linkman_remarks | VARCHAR(4000) | 否 | 联系人备注 |
| linkmans .linkman | VARCHAR(100) | 否 | 联系人名称 |
| linkmans .linkman_main | VARCHAR(1) | 否 | 是否为主联系人。0：否，1：是。默认值：0 |
| linkmans .linkman_intimacy | VARCHAR(100) | 否 | 联系人亲密度，必须是系统预定义值 |
| linkmans .linkman_importance | VARCHAR(100) | 否 | 联系人重要程度，必须是系统预定义值 |
| linkmans .linkman_decision_relationship | VARCHAR(100) | 否 | 联系人决策关系，必须是系统预定义值 |
| linkmans .exts.linkman_ext_key | VARCHAR(100) | 否 | 联系人信息扩展字段key值，联系人信息扩展字段需先在勤策系统客户管理中创建自定义字段 |
| linkmans .exts.linkman_ext_value | VARCHAR(4000) | 否 | 联系人信息扩展字段value值 |
| linkmans .open_cus_account | VARCHAR(1) | 否 | 是否开通客户账号。1：开通客户账号，0：不开通客户账号。可以不传，不传表示不开通客户账号 |
| linkmans .cus_acc_roles | VARCHAR(4000) | 否 | 客户账号角色名称。如有多个角色用逗号隔开。如果是否开通客户账号的值传"是"，则此字段不能为空 |
响应示例：
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0：成功， 1：失败。 其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
# 删除客户联系人信息
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/linkman/v1/removeLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| linkman_id | VARCHAR(32) | 否 | 来源于第三方系统联系人唯一标识，和勤策联系人唯一标识不能同时为空 |
| waiqin365_linkman_id | VARCHAR(32) | 否 | 勤策联系人唯一标识，和第三方系统联系人唯一标识不能同时为空。linkman_id、waiqin365_linkman_id如果同时存在优先取waiqin365_linkman_id |
响应示例：
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0：成功，1：失败。 其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
# 查询客户联系人
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/linkman/v1/queryLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page_number | VARCHAR(32) | 否 | 页码默认1，每页最大1000条 |
| waiqin365_customer_id | VARCHAR(32) | 否 | 勤策客户ID |
| trade_type | VARCHAR(1) | 否 | 客户分类。1：客户，2：经销商，3：门店 |
| linkman_id | VARCHAR(100) | 否 | 客户联系人唯一ID，来源于第三方系统的客户联系人唯一标识 |
| waiqin365_linkman_id | VARCHAR(100) | 否 | 勤策客户联系人唯一ID |
| linkman_status | VARCHAR(100) | 否 | 联系人状态 |
| linkman | VARCHAR(1) | 否 | 联系人名称 |
| linkman_job | VARCHAR(1) | 否 | 联系人职务 |
| linkman_mobile | VARCHAR(10) | 否 | 联系人手机号 |
| linkman_office_tel | VARCHAR(10) | 否 | 联系人固定电话，如：02544550010 |
| linkman_fax | VARCHAR(19) | 否 | 联系人传真，如：02544550010 |
| linkman_email | VARCHAR(19) | 否 | 联系人电子邮件 |
| linkman_qq | VARCHAR(19) | 否 | 联系人qq |
| linkman_weixin | VARCHAR(19) | 否 | 联系人微信 |
| linkman_dept | VARCHAR(19) | 否 | 联系人部门 |
| create_date_start | VARCHAR(19) | 否 | 创建日期开始时间。格式：yyyy-MM-dd HH:mm:ss |
| create_date_end | VARCHAR(19) | 否 | 创建日期开始时间。格式：yyyy-MM-dd HH:mm:ss |
| modify_date_start | VARCHAR(19) | 否 | 修改日期开始时间。格式：yyyy-MM-dd HH:mm:ss |
| modify_date_end | VARCHAR(19) | 否 | 修改日期开始时间。格式：yyyy-MM-dd HH:mm:ss |
响应示例：
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"linkmans": [
{
"linkman": "张三",
"trade_type": "1",
"linkman_job": "店主",
"linkman_mobile": "13052125555",
"linkman_office_tel": "52365895",
"linkman_fax": "25758545",
"linkman_sex": "M",
"linkman_birthday": "1980-02-06",
"linkman_email": "abc@163.com",
"linkman_remarks": "",
"linkman_main": "1",
"linkman_qq": "qq",
"linkman_weixin": "微信",
"linkman_dept": "部门",
"open_cus_acc": "1",
"cus_acc_roles": "老板,员工",
"linkman_intimacy":"一星",
"linkman_importance":"二星",
"linkman_decision_relationship":"使用人",
"exts": [
{
"linkman_ext_key": "级别",
"linkman_ext_value": "四星"
},
{
"linkman_ext_key": "主营商品",
"linkman_ext_value": "食品,电器,日化用品"
}
]
},
{
"linkman": "李四",
"trade_type": "1",
"linkman_job": "店员",
"linkman_mobile": "13022215212",
"linkman_office_tel": "58755254",
"linkman_fax": "",
"linkman_sex": "F",
"linkman_birthday": "1981-02-14",
"linkman_email": "",
"linkman_remarks": "",
"linkman_main": "0",
"exts": [
{
"linkman_ext_key": "级别",
"linkman_ext_value": "四星"
},
{
"linkman_ext_key": "主营商品",
"linkman_ext_value": "食品,电器,日化用品"
}
]
}
]
}
]
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| linkmans | 联系人列表 | ||
| linkmans .linkman | VARCHAR(100) | 联系人名称 | |
| linkmans .waiqin365_linkman_id | VARCHAR(32) | 勤策联系人唯一ID | |
| linkmans .waiqin365_customer_id | VARCHAR(32) | 勤策客户ID | |
| linkmans .trade_type | VARCHAR(1) | 客户分类。1：客户，2：经销商，3：门店 | |
| linkmans .linkman_job | VARCHAR(32) | 联系人职务 | |
| linkmans .linkman_mobile | VARCHAR(32) | 联系人手机号 | |
| linkmans .linkman_office_tel | VARCHAR(32) | 联系人固定电话 | |
| linkmans .linkman_fax | VARCHAR(32) | 联系人传真 | |
| linkmans .linkman_sex | VARCHAR(1000) | 联系人性别。F：女性，M：男性。默认值：M | |
| linkmans .linkman_birthday | timestamp | 联系人生日 | |
| linkmans .linkman_email | VARCHAR(10) | 联系人电子邮箱 | |
| linkmans .linkman_remarks | VARCHAR(1000) | 联系人备注 | |
| linkmans .linkman_main | VARCHAR(1) | 是否为主联系人。0：否，1：是。默认值：0 | |
| linkmans .linkman_qq | VARCHAR(32) | 联系人qq | |
| linkmans .linkman_weixin | VARCHAR(100) | 联系人微信 | |
| linkmans .open_cus_acc | VARCHAR(100) | 是否开通客户账号 | |
| linkmans .cus_acc_roles | VARCHAR(4000) | 客户账号角色名称，多个角色用逗号隔开 | |
| linkmans .linkman_dept | VARCHAR(32) | 联系人部门 | |
| linkmans .linkman_status | VARCHAR(1) | 联系人状态 | |
| linkmans .linkman_create_time | timestamp | 创建时间。格式：yyyy-MM-dd HH:mm:ss | |
| linkmans .linkman_creator_id | VARCHAR(32) | 创建人id | |
| linkmans .linkman_modify_time | timestamp | 修改时间。格式：yyyy-MM-dd HH:mm:ss | |
| linkmans .linkman_modifyier_id | VARCHAR(32) | 修改人id | |
| linkmans .linkman_intimacy | VARCHAR(100) | 联系人亲密度 | |
| linkmans .linkman_importance | VARCHAR(100) | 联系人重要程度 | |
| linkmans .external_info_id | VARCHAR(100) | 客户联系人关联的企微外部联系人在平台外部联系人信息表中的id | |
| linkmans .external_contact_link_user_first | VARCHAR(100) | 外部联系人首次关联操作人 | |
| linkmans .linkman_decision_relationship | VARCHAR(100) | 联系人决策关系 | |
| linkmans .exts.linkman_ext_key | VARCHAR(100) | 联系人信息扩展字段key值，联系人信息扩展字段需先在勤策系统客户管理中创建自定义字段 | |
| linkmans .exts.linkman_ext_value | VARCHAR(4000) | 联系人信息扩展字段value值 |
# 推送客户联系人信息
客户/门店/经销商的联系人信息发生变化时向第三方系统推送数据
请求方式： POST（HTTPS）
请求地址： 第三方服务接口URL
dataType=cm_linkman
[
{
"waiqin365_customer_id":"8987154180832428625",
"waiqin365_linkman_id": "6974532596418213933",
"linkman_main": "1",
"linkman": "kktest2",
"linkman_job": "",
"linkman_status": "3",
"linkman_mobile": "12345678912",
"linkman_office_tel": "12345678912",
"linkman_fax": "233",
"linkman_sex": "M",
"linkman_birthday": "2018-02-01",
"linkman_email": "234.qq.com",
"linkman_remarks": "212",
"linkman_qq": "234",
"linkman_weixin": "234",
"linkman_dept": "1",
"status": "1"
}
]
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| waiqin365_customer_id | VARCHAR(4000) | 否 | 客户ID |
| waiqin365_linkman_id | VARCHAR(4000) | 否 | 联系人ID |
| linkman_main | VARCHAR(4000) | 否 | 是否主联系人。可选值：0，否，1：是。此字段默认为0 |
| linkman | VARCHAR(32) | 否 | 联系人姓名 |
| linkman_job | VARCHAR(32) | 否 | 联系人职务 |
| linkman_status | VARCHAR(32) | 否 | 联系人状态 |
| linkman_mobile | VARCHAR(32) | 否 | 联系人手机号 |
| linkman_office_tel | VARCHAR(32) | 否 | 固定电话 |
| linkman_fax | VARCHAR(32) | 否 | 联系人传真 |
| linkman_sex | VARCHAR(32) | 否 | 联系人性别。F：女性，M：男性。默认值为M |
| linkman_birthday | timestamp | 否 | 联系人生日 |
| linkman_email | VARCHAR(10) | 否 | 电子邮件 |
| linkman_remarks | VARCHAR(1000) | 否 | 备注 |
| linkman_qq | VARCHAR(32) | 否 | QQ号 |
| linkman_weixin | VARCHAR(100) | 否 | 微信号 |
| linkman_dept | VARCHAR(32) | 否 | 部门 |
| status | VARCHAR(32) | 否 | 状态。0：逻辑删除，1：未删除 |
响应示例：
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0：成功，1：失败, 其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |