客户导入

该接口是针对呼叫中心的用户数据设计的，所以phone参数为必须且真实有效的数据。调用该接口需要使用appkey和appsecret，该参数在“管理后台->系统->扩展与集成->开发者ID”中获取。首次进入信息对接页面时，开发者ID中只有appkey，appsecret项只有一个“重置”按钮，点击之后会第一次生产appsecret，之后再次点击就是刷新appsecret。 *开发者ID信息一般用于消息接口，只有专业版及以上才有此模块。

调用说明

本接口只支持POST请求；

本接口请求Content-Type类型为：application/json;charset=utf-8；

本接口返回类型为JSON，同时进行UTF-8编码。

数据校验

参考通用说明-数据校验

接口参数说明

使用该接口可以批量更新客户中心中的客户资料，支持批量新增、修改、删除客户资料。

请求参数说明如下：

更新JSON参数中必须包含update或delete子元素其一。phone作为客户资料的唯一标识，如果系统中不存在phone对应的客户，则执行新增操作，否则执行更新操作。update中不允许存在两条phone一样的客户资料。在「客户信息字段」中配置了的，并且启用、显示的字段可以作为扩展字段，以「字段名称」作为属性名，如plateNumber参数。若未提前配置并启用，在导入数据后将查看不到对应的扩展字段（因为在调用接口导入过程中，服务端会直接忽略这些数据）。如果扩展字段在「客户信息字段」中配置的字段类型是时间控件，则值必须为毫秒数，如firstContactTime，如果字段类型是数字，则值必须为数字。

curl --location --request POST 'https://qiyukf.com/openapi/crm/syncCrmInfo?appKey=&time=&checksum=' \ --header 'Content-Type: application/json' \ --data-raw '{ "update": [{ "name":"周明月", "foreignId":"userId", "phone":"13725698555", "email":"mingyue@163.com", "address":"河南省开封市祥符区范庄村", "leader":-1, "firstContactTime":1483009843582, "lastContactTime":1483957441234, "plateNumber":"豫BWD001" },{ "name":"鲁城", "foreignId":"userId", "phone":"13725698666", "email":"lucheng@163.com", "address":"河南省开封市祥符区范庄村", "leader":124548, "firstContactTime":1483009963521, "lastContactTime":1483957965821, "plateNumber":"豫BWD002" }], "delete": [{ "phone":"13725698001" }, { "phone":"13725698002" }] }'

请求参数

Query 参数

appKey

string

必需

企业的appKey，1064deea1c3624c9ee26d1de5ce8481f

默认值:

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

update

array [object {9}]

需要更新的客户信息

可选

name

string

必需

访客姓名，更新时必须传

foreignId

string

可选

用户的uid，如果传了，则作为客户资料的唯一标识，否则使用 phone 作为唯一标识

phone

string

必需

string

访客邮箱

可选

address

string

地址

可选

leader

integer

可选

负责人客服ID，可在在线系统->设置->会话流程->访客分配->分配规则->ID查询处查询。如果要清除负责人，设置值为-1

firstContactTime

integer

可选

首次联系时间，必须为毫秒数

lastContactTime

integer

可选

末次联系时间，必须为毫秒数

plateNumber

string

作为自定义扩展字段

可选

delete

array [object {1}]

需要删除的客户信息

可选

phone

string

必需

电话号码，没有传 foreignId 时做为客户资料的唯一标识

示例

请求参数

返回响应