# 接口
## 客服系统接口文档
* [客服系统接口文档](https://www.kancloud.cn/wangcwei/dqlkfxt/990422#_0)
* [商户分组信息](https://www.kancloud.cn/wangcwei/dqlkfxt/990422#_4)
* [用户与客服系统建立连接](https://www.kancloud.cn/wangcwei/dqlkfxt/990422#_50)
* [自定义推送url](https://www.kancloud.cn/wangcwei/dqlkfxt/990422#url_73)
#### 商户分组信息
* **请求URL**
> [客服系统域名/api/group/\[business\_id\]](https://www.kancloud.cn/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=](https://www.kancloud.cn/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**用户自定义
![](https://box.kancloud.cn/663e9306943b917779f6fc1c965ad690_823x524.png)
* **推送参数**
| 请求参数 | 参数说明 |
| --- | --- |
| visiter\_id | 用户ID |
| content | 发送聊天内容 |
| business\_id | 客服系统ID |
| service\_id | 客服ID |
| direction | 发送方向 to\_visiter 或 to\_service |
| timestamp | 时间戳 |
| group | 客服分组 |
| state | 访客状态 online 或 offline |
| service\_name | 客服昵称 |
| service\_url | 客服链接 |
* **返回参数**
对接方自定义