>[danger] **[點此進入芝麻微客官網](https://zmwk.cn/?source=kanyun_t_mia_3088297)** **芝麻微客幫助文檔已轉移至：https://www.yuque.com/zhimaxiaoshiwangluo/htndcm 查看最新消息請點擊以上鏈接。** <br> ## 功能說明 1.API接口對接主要是為了增強客服能力，對自建系統，同時又具備一定開發對接能力的用戶，提供對接接口，完成對接后，可在芝麻微客側邊欄查看對應的客戶信息 2.該功能必須先獲取獲取客戶unionid，如客戶unionid獲取不到將會導致客戶信息無法同步至微客側邊欄[如何獲取客戶unionid？](http://doc.zmwk.cn/zmwk/3090818) ## 查詢地址 1.查詢地址接口是通過unionid在你方使用的系統中查看具體的客戶信息，返回結果將顯示在企微側邊欄-客戶畫像頁面 2.我方查詢方式為GET請求，對接時請務必注意 ## 使用方法 第一步：在開放接口-API對接頁面，填寫你方的查詢地址  添加后，我們會帶上用戶unionid和mobile，及其他參數信息，通過GET請求方式向你方所填寫的查詢地址發送接口參數并獲取具體的客戶信息 參數如下：  第二步：查詢結果參數要求如下： 如果你方使用的系統查詢到相關客戶信息，請按下方參數要求輸出返回json的形式數據：  ``` { ????????"msg":?"操作完成", ????????"res":?0, ????????"data":?{ ????????????????"title":?"一個標題", ????????????????"data":?[ { ????????????????????????????????"value_color":?"green", ????????????????????????????????"label":?"手機號碼", ????????????????????????????????"value":?"177962621" ????????????????????????}, ????????????????????????{ ????????????????????????????????"value_color":?"blue", ????????????????????????????????"label":?"購買數量", ????????????????????????????????"value":?100 ????????????????????????}, ????????????????????????{ ????????????????????????????????"value_color":?"blue", ????????????????????????????????"label":?"注冊時間", ????????????????????????????????"value":?"2024-10-11" ????????????????????????} ???????????????? ] ????????} } ``` 返回參數說明： data里的每一個對象，都是一組用戶信息，label表示標題，value表示具體的客戶信息。value\_color（可選返回值）表示value顯示顏色，支持顏色值：red、green、blue、geekblue <br> res非0值表示獲取用戶信息失敗，0代表獲取獲取用戶信息成功 <br> >[danger] **[點此進入芝麻微客官網](https://zmwk.cn/?source=kanyun_b_mia_3088297)** <br> 您有問題需要咨詢的話，可以掃描下方二維碼： </h>  </h> </h>