新增客户

Path：/third_api/customers/add
Method：POST
接口描述：
  • 最大一批次支持200条
  • 传入 user_id 不是绑定关系，数据不会新增客户

Header 参数说明

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

请求示例

{
   "customers": [
        {
            "open_user_id": "235D2446C3234078B39A3C5D96E0ADC3",
            "customer_id": "1CC7957B94334B83B69063869876BF03",
            "name": "客户A",
            "phone": "13960190002",
            "company_name": "测试公司",
            "status": "初次",
            "wechat": "wx83jdo",
            "qq": "28394",
            "user_id": "90031",
            "assist_users": ["90032", "90033"],
            "created_at": "2018-12-31 18:00",
            "updated_at": "2018-12-31 18:00",
            "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",
                "created_at": "2018-12-31 18:00",
                "updated_at": "2018-12-31 18:00"
            ]
        }
    ]
}

Body 参数说明

参数名称 类型 必填 备注
open_user_id String 否 外部接入方用户标识 (字段user_id为空时必填 )
customer_id String 是 接入方客户标识 （新增成功后会和导入数据建立关联关系）
name String 是 客户名称
phone String 是 手机号
company_name String 是 企业名称
status String 否 跟进状态（传入显示名称）
qq String 否 QQ
wechat String 否 微信号
user_id String 否 负责人（励销云传给接入方用户ID）
assist_users Array 否 客户协作人（励销云传给接入方用户ID）
created_at String 是 创建时间
updated_at String 是 更新时间
contacts Array 否 客户联系人
├─ contact_id String 接入方联系人标识
├─ name String 名称
├─ job String 职位
├─ phone String 手机
├─ wechat String 微信
├─ qq String QQ号
├─ email String 邮箱
├─ gender String 性别；male / female
├─ birth_date String 生日
├─ created_at String 创建时间
├─ updated_at String 最后更新时间

返回数据

{
    "code": 0,
    "success": true,
    "message": "接口请求成功",
    "data": {
        "success": {
                "1": "123"
        },
        "failed": {
                "2": "查重验证失败｜数据审批中"
        }
    }
}

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

  • success中返回的为保存成功的数据，key：接入方客户标识； value：我公司客户标识
  • failed中返回保存失败的数据 key：对接方客户标识； value：我公司客户标识
  • customer_id => 接入方客户标识未传入 value为空
文档更新时间: 2024-08-12 10:22   作者：梅翔