# 接口
## 客服系統接口文檔
* [客服系統接口文檔](http://www.hmoore.net/wangcwei/dqlkfxt/990422#_0)
* [商戶分組信息](http://www.hmoore.net/wangcwei/dqlkfxt/990422#_4)
* [用戶與客服系統建立連接](http://www.hmoore.net/wangcwei/dqlkfxt/990422#_50)
* [自定義推送url](http://www.hmoore.net/wangcwei/dqlkfxt/990422#url_73)
#### 商戶分組信息
* **請求URL**
> [客服系統域名/api/group/\[business\_id\]](http://www.hmoore.net/wangcwei/dqlkfxt/990422#)
* **請求方式**
> **GET**
* **請求參數**
| 請求參數 | 參數類型 | 參數說明 |
| --- | --- | --- |
| business\_id | Integer,**不可為空** | 客服系統ID |
* **返回參數**
| 返回參數 | 參數類型 | 參數說明 |
| --- | --- | --- |
| code | Integer | 執行結果code |
| message | String | 執行結果 |
| errorCode | Integer | 錯誤碼 |
* **返回示例**
~~~php
{
code: 0,
msg: [
{
id: 11,
groupname: "test1"
},
{
id: 12,
groupname: "多商戶分組1"
}
]
}
~~~
* * *
#### 用戶與客服系統建立連接
* **請求URL**
> [客服系統域名/index/index/home?visiter\_id=&visiter\_name=&avatar=&business\_id=&groupid=&product=](http://www.hmoore.net/wangcwei/dqlkfxt/990422#)
* **請求方式**
> **GET**
* **請求參數**
| 請求參數 | 參數類型 | 參數說明 |
| --- | --- | --- |
| visiter\_id | String,**可為空** | 用戶ID |
| visiter\_name | String,可為空 | 用戶昵稱 |
| avatar | String,可為空 | 用戶頭像 |
| business\_id | Integer,不可為空 | 客服系統ID |
| groupid | Integer,可為空 | 分組ID 從 商戶分組信息 獲取 |
| product | JSON 可為空 | {"pid":1,"title":" Apple MacBook Air ","img":"[http://www.wolive.cc/assets/images/pro.jpg","info":"13.3英寸筆記本電腦](http://www.wolive.cc/assets/images/pro.jpg%22,%22info%22:%2213.3%E8%8B%B1%E5%AF%B8%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91)銀色(2017款Core i5 處理器/8GB內存/128GB閃存 MQD32CH/A)","price":"￥7588.00","url":"[http://www.wolive.cc/demo/index/product1](http://www.wolive.cc/demo/index/product1)"} |
* * *
#### 自定義推送url
* **推送URL**用戶自定義
* **推送參數**
| 請求參數 | 參數說明 |
| --- | --- |
| visiter\_id | 用戶ID |
| content | 發送聊天內容 |
| business\_id | 客服系統ID |
| service\_id | 客服ID |
| direction | 發送方向 to\_visiter 或 to\_service |
| timestamp | 時間戳 |
| group | 客服分組 |
| state | 訪客狀態 online 或 offline |
| service\_name | 客服昵稱 |
| service\_url | 客服鏈接 |
* **返回參數**
對接方自定義
