帮助中心首页
开发者文档
工单系统开放接口

查询工单列表

接口说明:

1)通过客服id返回受理客服为该客服的工单列表,通过客户id返回相应客户为该客户的工单列表。

2)按照更新时间排序。

访问方式:

POST:https://www.sobot.com/ws-open/ticket/getTicketList

请求参数(Request Body):

字段编码字段名称字段类型长度可空备注说明
access_tokenToken编码string40
id客服或客户idString36如果获取客服工单列表传客服id,反之传客户id
queryType查询类型Integer21客服 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工单idString
ticketCode工单编号Long
ticketTitle工单标题String
ticketContent问题描述String
ticketLevel工单优先级Integer0低,1中,2高,3紧急
ticketStatus工单状态Integer0未受理,1受理中,2等待回复,3已解决,99已关闭,98已删除
startType工单发起人类型Integer0客服,1普通用户
startName发起人名称String
dealUserName受理人名称String
dealGroupName受理组名称String
createTime创建时间long毫秒时间戳
updateTime更新时间long毫秒时间戳
ticketTypeName工单分类名称String显示格式:一级/二级/三级
ticketFrom工单来源Integer0工单中心,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,正常返回!"
}