更新联系人

Path：/third_api/contacts/update
Method：POST
接口描述：
  • 最大一批次支持200条
  • 联系人必需关联客户记录，未传 customer_id 认为是异常 数据不处理
  • 按规则匹配励销云联系人记录匹配上会建立关联关系并且更新联系人数据；如果未匹配会新增一条联系人记录

Header 参数说明

参数名称 参数值 必填 备注
Content-Type application/json 是 数据类型
Access-Token **** 是 励销云为每个平台单独颁发唯一Token；通过申请人邮件发送
Company-Code **** 是 企业/账号绑定标识

请求示例

{
    "contacts": [
        {
            "customer_id": "1CC7957B94334B83B69063869876BF03",
            "contact_id": "RCF8A4B15A90B442BC8179D573F03E80B7",
            "name": "联系人1",
            "job": "销售",
            "phone": "15023456435",
            "wechat": "wxas3",
            "qq": "8273494",
            "email": "2739@qq.com",
            "gender": "male",
            "birth_date": "1994-02-23",
            "updated_at": "2018-12-31 18:00"
        }
    ]
}

Body 参数说明

参数名称 类型 必填 备注
customer_id String 是 接入方客户标识 （会根据传入查询励销云关联客户）
contact_id String 是 励销云需要更新联系人ID （根据业务需求可传入接入方联系人ID，会根据关联记录进行更新）
name String 是 名称
job String 否 职位
phone String 是 手机号
qq String 否 QQ
wechat String 否 微信号
email String 否 邮箱
gender String 否 性别；male / female
birth_date String 否 生日
created_at String 是 创建时间
updated_at String 是 更新时间

返回数据

{
    "code": 0,
    "success": true,
    "message": "接口请求成功",
    "data": {
        "success": {
                "111": "44556"
        },
        "failed": {
                "112": "励销云客户不存在/未绑定"
        }
    }
}

返回结果⚠️
data中返回success和faield 两种结果：

  • success中返回的为保存成功的数据，key：对接方联系人标识； value：我公司联系人标识
  • failed中返回保存失败的数据 key：对接方联系人标识； value：我公司联系人标识
文档更新时间: 2024-08-12 10:22   作者：梅翔