位置:开放接口--客户资料同步接口 1:使用同步资料接口,可以将小客服后台的客户资料实时与第三方系统进行同步。 2:数据拉取地址,填写后,当客户咨询时,将请求接口,包括两种场景:新客户咨询、被结束接待的客户重新咨询。 3:数据提交地址,填写后,当客服在接待界面修改了客户资料时,将向第三方提交修改内容。 4:请选择需要相互同步的资料字段,未选择的客户字段,将不会相互同步。 5:请注意保持接口的可用性,如果发现一天内有大量的超时响应,为了避免影响系统功能,同步功能将会被停用。 6:支持对自定义客户字段进行相互同步。 ![](https://img.kancloud.cn/8f/df/8fdf7c5c08512baf5e5425c32deffefb_1167x747.png) 1、数据提交:当客服在小客服内修改客户资料区时,将向第三方提交修改内容 我方请求接口地址时,将带上以下参数 ![](https://img.kancloud.cn/3c/f0/3cf02b2863b9d0dbfa34f5971241a276_1054x197.png) 请求及返回数据格式举例: 数据格式:json 示例(请求): {"field":{"name":"helen3","openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM","province":"\\u9655\\u897f","city":"\\u897f\\u5b89","weixin":"444","mobile":"33333333333","age":"3"},"app\_id":"","openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM","zhima\_id":"dec5433bc39ef2f772bdcc60ac6d640e"} 请求说明: field:\[type:obj\] 传递需要修改字段的相关属性值 app\_id:\[type:string\] 微信公众号appid(h5插件不含此项默认为空) zhima\_id:\[type:string\] 开放平台首页的zhima\_id字段内容 openid:\[type:string\] 用户的唯一标识ID,对应的是公众号的openid 示例(返回): {"res":0,"msg":"\\u83b7\\u53d6\\u6210\\u529f\\uff01"} 结果说明: res:\[type:int\] 0表示返回成功,非0表示返回失败 msg: \[type:string\]成功或失败提示语 2、数据拉取:当客户开始咨询时,小客服将向第三方接口请求客户资料数据 我方请求接口地址时,将带上我们这边的参数,请求方式及参数如下: ![](https://img.kancloud.cn/87/15/87157f649c98103116cb084d9f95f146_1056x191.png) 请求及返回数据格式举例: 数据格式:json 示例(请求): {"openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM","field":\["name","province","city","weixin","mobile","age","sex","note","ceshi1","ceshi2","ceshi3","ceshi4","ceshi5"\],"app\_id":"","zhima\_id":"dec5433bc39ef2f772bdcc60ac6d640e"} 请求说明: field:\[type:obj\] 传递需要获取字段的相关属性值 app\_id:\[type:string\] 微信公众号appid(h5插件不含此项默认为空) zhima\_id:\[type:string\] 开放平台首页的zhima\_id字段内容 openid:\[type:string\] 用户的唯一标识ID,对应的是公众号的openid 示例(返回): {"res":0,"msg":"\\u83b7\\u53d6\\u6210\\u529f\\uff01","data":{"name":"helen3","sex":"0","age":"3","mobile":"33333333333","weixin":"ceshi3","province":"\\u9655\\u897f","city":"\\u897f\\u5b89","ceshi1":"\\u8fd9\\u662fhelen3","ceshi2":"333","ceshi3":"1,2,3,4,5","ceshi4":"a,b,c,d","ceshi5":"333"},"openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM"} 结果说明: res:\[type:int\] 0表示返回成功,非0表示返回失败 msg: \[type:string\] 成功或失败提示语 data: \[type:obj\] 需要修改的字段属性值 openid: \[type:string\] 用于判断请求的和回应的openid是否一致,不一致时不会更新用户信息