<br> [**点此进入芝麻小客服官网**](https://xiaokefu.com.cn/?source=kanyun_t_mia ) <br> 位置：其他设置---开放接口--客户资料同步接口 支持：H5、插件、小程序、公众号 1：使用同步资料接口，可以将小客服后台的客户资料实时与第三方系统进行同步。 2：数据拉取地址，填写后，当客户咨询时，将请求接口，包括两种场景：新客户咨询、被结束接待的客户重新咨询。 3：数据提交地址，填写后，当客服在接待界面修改了客户资料时，将向第三方提交修改内容。 4：请选择需要相互同步的资料字段，未选择的客户字段，将不会相互同步。 5：请注意保持接口的可用性，如果发现一天内有大量的超时响应，为了避免影响系统功能，同步功能将会被停用。 6：支持对自定义客户字段进行相互同步。 >注意：如果使用H5及插件同步资料时，需要注意openid的格式。由于H5及插件的openid后会有渠道识别符。返回的数据也必须带有渠道识别符，比如oRjZX5wXMcx6iTdJ6stTTU-4pDAM.0.21265。比如请求的数据示例：{"openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM.0.21265","field":\["name","province","city","weixin","mobile","age","sex","note"],"app\_id":"","zhima\_id":"dec5433bc39ef2f772bdcc60ac6d640e"}。返回的数据中的openid也必须匹配，比如：{"res":0,"msg":"\\u83b7\\u53d6\\u6210\\u529f\\uff01","data":{"name":"qingqiuceshi","sex":"0","age":"3","mobile":"33333333333","weixin":"ceshi3","province":"\\u9655\\u897f","city":"\\u897f\\u5b89"},"openid":"o1wljwPznfmmkiTSVj8RSok6Duk.0.21265"}  1、数据提交：当客服在小客服内修改客户资料区时，将向第三方提交修改内容 我方请求接口地址时，将带上以下参数  请求及返回数据格式举例： 数据格式：x-www-form-urlencoded 示例(请求)： {"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、数据拉取：当客户开始咨询时，小客服将向第三方接口请求客户资料数据 我方请求接口地址时，将带上我们这边的参数，请求方式及参数如下：  请求及返回数据格式举例： 数据格式：x-www-form-urlencoded 示例(请求)： {"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是否一致，不一致时不会更新用户信息 ------------------ >H5及插件使用流程 第一步：传递过来openid，这个openid是你们小程序的openid。用来识别用户的，方便后续拉取数据和提交数据时，你们用来识别用户。插件文档内有方法：https://doc.xiaokefu.com.cn/wikixkf/1343271 第二步：填写开放接口。填写后。 第三步：当客户咨询时，我们会向你们的接口发起请求。请求是post   json格式   具体类似于 {"openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM.0.21265","field":\["name","province","city","weixin","mobile","age","sex","note","ceshi1","ceshi2","ceshi3","ceshi4","ceshi5"\],"app\_id":"","zhima\_id":"dec5433bc39ef2f772bdcc60ac6d640e"} 其中openid中的oRjZX5wXMcx6iTdJ6stTTU-4pDAM，是你们传递的openid    后面的.0.xxxx是我们的渠道代号，具体是什么，跟请求时有关，你们返回给我们的数据，也要匹配上。比如   返回数据 {"res":0,"msg":"\\u83b7\\u53d6\\u6210\\u529f\\uff01","data":{"name":"qingqiuceshi","sex":"0","age":"3","mobile":"33333333333","weixin":"ceshi3","province":"\\u9655\\u897f","city":"\\u897f\\u5b89"},"openid":"o1wljwPznfmmkiTSVj8RSok6Duk.0.21265"} 第四步：客服在修改时，会向你们的接口提交数据，示例： {"field":{"name":"helen3","openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM.0.21265","province":"\\u9655\\u897f","city":"\\u897f\\u5b89","weixin":"444","mobile":"33333333333","age":"3"},"app\_id":"","openid":"oRjZX5wXMcx6iTdJ6stTTU-4pDAM.0.21265","zhima\_id":"dec5433bc39ef2f772bdcc60ac6d640e"} </h> </h> <br> <br> <br> <br><br> [**点此进入芝麻小客服官网**](https://xiaokefu.com.cn/?source=kanyun_b_mia ) 您有问题需要咨询的话，可以扫描下方二维码： </h>  </h> </h>