“客戶資料接口”是為增強客服能力，對有自建客戶系統，同時又具備一定開發對接能力的用戶，提供的對接接口。完成對接后，可以在微友助手后臺顯示用戶在您的客戶管理系統中的用戶信息，如訂單，歷史服務記錄等等。 ## 查詢接口 查詢接口是通過微信公眾平臺unionid去你方的客戶系統查詢具體的客戶信息。返回結果顯示在聚合聊天的“客戶畫像”選項卡里。 **查詢接口配置方法：** **1. 管理員賬號在應用市場-API對接中填寫你方的查詢地址**   配置好后，我們會帶上用戶微信公眾平臺unionid和mobile，及其他相關參數信息，向企業所填寫的查詢地址通過查詢接口獲取具體的客戶信息。 具體參數如下： | 參數名 |說明| 備注 | | --- | --- | --- | | unionid | 微信公眾平臺unionid | 微信聯系人對應的唯一身份標識 | | mobile | 用戶的客戶畫像的手機號信息 | timestamp | 請求時間戳 | 可以對時間做一個校驗，降低重放攻擊 | | nonce | 長度16的隨機數（字母+數字） | 增加簽名結果的隨機性 | | sign | 簽名 | 詳情見「關于簽名」 | **2. 查詢結果輸出參數要求** 如果客戶系統查詢到相關客戶信息，請您按一下參數要求輸出返回JSON的形式數據： ``` { "errcode":0, "data":{ crm_info: [ { "label":"手機號", "value":"13100000000" , "value_color":"red" }, { "label":"購買數", "value":"5" } ] } } ``` **返回參數說明：** data里的每一個對象，都是一組用戶信息，label表示標題，value表示具體的客戶信息。value_color（可選返回值）表示value顯示顏色，支持顏色值：red、green、blue、geekblue。  errcode為-100的時候，表示用戶未綁定，會展示下圖頁面,其它非0值表示獲取用戶信息失敗 <br> <br> ## 如何綁定unionid？ [如何綁定unionid](http://www.hmoore.net/weiyoubot/weiyouzhushou/2312568) ## 如何看到mobile？   ## 關于簽名 為了接口合法使用，我們對接口調用進行了鑒權。在設置界面完善信息后，我們系統會生成一串隨機碼，即密鑰（SecretKey）。在調用貴司接口的時候，我們服務端會根據SecretKey，計算出簽名值，即sign，具體算法如下： 所有發送的數據為集合M，集合M中添加secret= SecretKey (客戶資料對接界面顯示的secretKey)，將集合M內參數按照參數名ASCII碼從小到大排序（字典序），使用URL鍵值對的格式（即key1=value1&key2=value2…）拼接成字符串stringA，并對stringA進行sha256運算，再將得到的字符串所有字符轉換為大寫，得到sign值signValue