# 客户联系人信息接口

# 新增客户联系人信息

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/linkman/v1/addLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
   "linkmans": [
        {
            "waiqin365_customer_id":"5896092306461054419",
            "linkman_id":"20190417001",
            "linkman": "张三",
            "linkman_job": "店主",
            "linkman_mobile": "13052125555",
            "linkman_office_tel": "52365895",
            "linkman_fax": "25758545",
            "linkman_sex": "M",
            "linkman_birthday": "1992-10-13",
            "linkman_email": "1259612641@qq.com",
            "linkman_remarks": "测试测试测试",
            "linkman_main": "1",
            "linkman_qq": "qq",
            "linkman_weixin": "微信",
            "linkman_dept": "部门",
            "linkman_intimacy":"一星",
            "linkman_importance":"二星",
            "linkman_decision_relationship":"使用人",
            "exts":[
                      {
                        "linkman_ext_key":"自定义文本框",
                        "linkman_ext_value":"测试用"
                      },{
                        "linkman_ext_key":"自定义",
                        "linkman_ext_value":"测试用"
                      }],
            "open_cus_account": "1",
            "cus_acc_roles": "老板(门店),员工(门店)"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准,建议调用时联系人信息放入单个。

参数说明:

参数 类型 必填 说明
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": [
        {
        	"waiqin365_customer_id":"5896092306461054419",
        	"linkman_id":"20190417001",
            "linkman": "张三001",
            "linkman_job": "店主",
            "linkman_mobile": "15051846373",
            "linkman_office_tel": "52365895",
            "linkman_fax": "25758545",
            "linkman_sex": "M",
            "linkman_birthday": "1992-10-13",
            "linkman_email": "259612641@qq.com",
            "linkman_remarks": "测试测试测试",
            "linkman_main": "1",
            "linkman_qq": "qq",
            "linkman_weixin": "微信",
            "linkman_dept": "部门",
            "linkman_intimacy":"一星",
            "linkman_importance":"二星",
            "linkman_decision_relationship":"使用人",
              "exts":[
              {
                "linkman_ext_key":"自定义文本框",
                "linkman_ext_value":"测试用"
              },{
                "linkman_ext_key":"自定义",
                "linkman_ext_value":"测试用"
              }],
            "open_cus_account": "1",
            "cus_acc_roles": "老板(门店),员工(门店)"
        }
    ]
}
说明: 本示例仅供参考,具体以参数说明为准,建议调用时联系人信息放入单个。

参数说明:

参数 类型 必填 说明
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": "CM0001",
     "waiqin365_linkman_id":"786272764026566666"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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 } 在线调试
请求示例:

{
    "waiqin365_customer_id": "8584076849528596666",
    "trade_type": "1",
    "linkman_id": "CM001",
    "waiqin365_linkman_id": "8584076849528595560",
    "linkman_status": "1",
    "linkman": "大型超市",
    "linkman_job": "华中大区,南京分区,秦淮社区",
    "linkman_mobile": "150622123456",
    "linkman_office_tel": "25758545",
    "linkman_fax":"25758545",
    "linkman_email":"qq",
    "linkman_weixin":"weixin",
    "linkman_dept":"开发"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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 响应说明