<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>