H5云客服發送商品和訂單 · 芝麻小客服幫助文檔

### 用戶發送商品或訂單給客服（僅支持H5云客服）通過該功能，可以實現，用戶在H5聊天頁面，自主選擇商品或訂單，發送給客服。效果如下： ![](https://img.kancloud.cn/08/61/0861906facf5a2e6807f363567f30124_375x811.png) #### 如何使用? 1、填寫接口地址，設置簽名秘鑰 - 用戶點擊選擇訂單發送時，我們會向填寫的接口地址請求用戶的訂單列表。請按照文檔，返回對應參數。 - 簽名秘鑰用于對請求進行加密，我們會按照下述加密方式對請求加密生成簽名，請開發者自行進行校驗簽名是否正確，以保證安全性。 ![](https://img.kancloud.cn/20/17/20178b9107da0cc426b2546af42d2356_1204x284.png) 2、簽名生成方式按照字段key值自然升序排序后，將請求參數（參數值需要urlencode）和簽名秘鑰（secret）拼接在一起后MD5加密，如果值等于接收到的signature，那么表示驗證通過。示例： ~~~ signature = md5(chanelid=urlencode(\*\*)&openid=urlencode(\*\*)&pagenum=urlencode(\*\*)pagesize=urlencode(\*\*)&&secret=urlencode(\*\*)&time=urlencode(\*\*)) ~~~ 3、獲取商品接口 - 請求參數： | 參數名 | 描述 | 格式 | 備注 | | --- | --- | --- | --- | | chanelid | 渠道ID | int | 咨詢的渠道ID | | pagesize | 每頁展示數量 | int | 固定為10 | | pagenum | 頁碼 | int | - | | time | 請求時間 | 秒級時間戳 | 用于校驗請求有效性 | | signature | 簽名 | 字符串 | 用于校驗請求有效性，祥見上問2、簽名生成方式 | - 請求示例 ~~~ { "chanelid": 14126, "pagesize": 10, "pagenum": 1, "time": 1659335427, "signature": "01b73beab91625326df3efbfa98d7823" } ~~~ - 收到請求后，請按照如下格式返回結果。 | 參數名 | 描述 | 是否必填 | 格式 | 備注 | | --- | --- | --- | --- | --- | | total | 商品總數 | 是 | | 符合條件的商品總數 | | data | - | 是 | 對象數組 | | | data.tmptype | 模板類型 | 是 | 字符串 | 商品類型模板固定為goods，訂單類型模板固定為order | |data.tmpTitle | 商品標題 | 是 | 字符串 | 最多20個字，需要urlencode | |data.tmpDescription | 商品描述 | 否 | 字符串 | 最多40個字，需要urlencode ，不傳則不展示描述。該字段也可以用來展示商品規格。| |data.tmpThumb | 商品縮略圖 | 是 | 字符串 | 請傳遞圖片的鏈接，確保該鏈接可訪問。需要urlencode | | data.tmpValue | 商品價格 | 是 | 浮點型數字 | 最多兩位小數 | | data.tmpUrl | 商品鏈接 | 否 | 字符串 | 不傳，則客戶和客服無法在聊天界面打開商品鏈接 | - 返回示例 ~~~ { "res": 0, "msg": "", "total":100, "data": [ { "tmptype": "goods", "tmpTitle": "測試商品380082", "tmpDescription": "風切", "tmpThumb": "https://xiaokefu.com.cn/static/home/img/logo.png", "tmpValue": "777.77", "tmpUrl": "https://xiaokefu.com.cn?a=53456" }, ... ] } ~~~ 4、獲取訂單接口 - 請求參數： | 參數名 | 描述 | 格式 | 備注 | | --- | --- | --- | --- | | chanelid | 渠道ID | int | 咨詢的渠道ID | | openid | 用戶的openid | 字符串 | 咨詢的用戶id。請配合傳入客戶資料使用 | | pagesize | 每頁展示數量 | int | 固定為10 | | pagenum | 頁碼 | int | - | | time | 請求時間 | 秒級時間戳 | 用于校驗請求有效性 | | signature | 簽名 | 字符串 | 用于校驗請求有效性，祥見上問2、簽名生成方式 | - 請求示例 ~~~ { "chanelid": 14126, "openid": "12342311qw" "pagesize": 10, "pagenum": 1, "time": 1659335427, "signature": "01b73beab91625326df3efbfa98d7823" } ~~~ - 收到請求后，請按照如下格式返回結果。 | 參數名 | 描述 | 是否必填 | 格式 | 備注 | | --- | --- | --- | --- | --- | | total | 訂單總數 | 是 | | 符合條件的訂單總數 | | data | - | 是 | 對象數組 | | | data.tmptype | 模板類型 | 是 | 字符串 | 商品類型模板固定為goods，訂單類型模板固定為order | | data.tmpTitle | 商品標題 | 是 | 字符串 | 最多20個字，需要urlencode。多商品時，傳遞其中某一個的商品標題 | | data.tmporderThumb | 商品縮略圖 | 是 | 字符串 | 訂單商品的縮略圖地址，多商品時傳遞其中一個即可。需要urlencode | | data.tmporderid | 訂單號 | 是 | 字符串 | 最多128個字符，需要urlencode | |data.tmpordertime | 下單時間 | 是 | 時間戳 | 下單時間，取秒級時間戳。| | data.tmpordernum | 商品數 | 否 | int | 訂單商品數，必須為整數。不填則不展示 | | data.tmporderprice | 訂單金額 | 否 | float | 訂單金額。不填則不展示 | | data.tmporderurl | C端點擊跳轉鏈接 | 否 | 字符串 | 客戶在聊天界面點擊查看詳情的跳轉鏈接。注意，請自行在鏈接對應的頁面校驗登錄態。需要urlencode。不填則不能跳轉到訂單詳情 | | data.tmporderstaffurl | 客服跳轉鏈接 | 否 | 字符串 | 客服在聊天界面點擊查看詳情的跳轉鏈接。不填則默認取C端跳轉鏈接。如果C端跳轉鏈接也未填，則不可跳轉。注意，請自行校驗登錄態。| - 返回示例 ~~~ { "res": 0, "msg": "", "total":100, "data": [ { "tmptype": "order", "tmpTitle": "游山玩水", "tmporderThumb": "https://xiaokefu.com.cn/static/home/img/logo.png", "tmporderid": "60688", "tmpordertime": "2022-08-01 14:40:35", "tmpordernum": "67936", "tmporderprice": "7419.00", "tmporderurl": "https://xiaokefu.com.cn?a= 94057", "tmporderstaffurl": "https://xiaokefu.com.cn?a=33736" } ] } ~~~