接口说明:
1)通过客服id返回受理客服为该客服的工单列表,通过客户id返回相应客户为该客户的工单列表。
2)按照更新时间排序。
访问方式:
POST:https://www.sobot.com/ws-open/ticket/getTicketList
请求参数(Request Body):
字段编码 | 字段名称 | 字段类型 | 长度 | 可空 | 备注说明 |
---|---|---|---|---|---|
access_token | Token编码 | string | 40 | 否 | |
id | 客服或客户id | String | 36 | 否 | 如果获取客服工单列表传客服id,反之传客户id |
queryType | 查询类型 | Integer | 2 | 否 | 1客服 2 客户 |
请求示例:
curl https://www.sobot.com/ws-open/ticket/getTicketList \
-X POST \
-H 'content-type: application/json' \
-d '
{
"access_token" : "xx",//获取access_token
"id":"xx",
"queryType":2
}'
返回参数:
字段编码 | 字段名称 | 字段类型 | 备注说明 |
---|---|---|---|
code | 返回编码 | string | |
data | 数据对象 | 详见下文 |
返回data:
字段编码 | 字段名称 | 字段类型 | 备注说明 |
---|---|---|---|
ticketId | 工单id | String | |
ticketCode | 工单编号 | Long | |
ticketTitle | 工单标题 | String | |
ticketContent | 问题描述 | String | |
ticketLevel | 工单优先级 | Integer | 0低,1中,2高,3紧急 |
ticketStatus | 工单状态 | Integer | 0未受理,1受理中,2等待回复,3已解决,99已关闭,98已删除 |
startType | 工单发起人类型 | Integer | 0客服,1普通用户 |
startName | 发起人名称 | String | |
dealUserName | 受理人名称 | String | |
dealGroupName | 受理组名称 | String | |
createTime | 创建时间 | long | 毫秒时间戳 |
updateTime | 更新时间 | long | 毫秒时间戳 |
ticketTypeName | 工单分类名称 | String | 显示格式:一级/二级/三级 |
ticketFrom | 工单来源 | Integer | 0工单中心,1 PC普通用户留言提交,2 H5普通用户留言提交,3普通用户微信提交,4普通用户APP提交,5普通用户微博提交,6 在线工作台-PC客服提交,7客户中心,8呼叫中心 9 在线工作台-微信客服提交 10 在线工作台-H5客服提交 11 在线工作台-App客服提交 |
返回示例:
{
"data":
"items": [
{ "ticketId": "xxx"
"ticketCode":1500877941,
"ticketTitle": "xxx",
"ticketContent":"xxx",
"ticketLevel":0,
"ticketStatus":0,
"startType":0,
"startName":"xxx",
"dealUserName":"xxx",
"dealGroupName":"xxx",
"createTime":1501142747,
"updateTime":1501142747,
"ticketTypeName":"xxx",
"ticketFrom":0
},
{"ticketId": "xxx"
"ticketCode": 1510877947,
"ticketTitle": "xxx",
"ticketContent":"xxx",
"ticketLevel":1,
"ticketStatus":0,
"startType":0,
"startName":"xxx",
"dealUserName":"xxx",
"dealGroupName":"xxx",
"createTime":1500877941,
"updateTime":1501066376,
"ticketTypeName":"xxx",
"ticketFrom":1
}
],
"code": "1000,正常返回!"
}