接口说明:
1)通过客服id返回受理客服为该客服的工单列表,通过客户id返回相应客户为该客户的工单列表。
2)按照更新时间排序。
访问方式:
请求参数(Request Body):字段编码字段名称字段类型长度可空备注说明access_tokenToken编码string40否
id客服或客户idString36否如果获取客服工单列表传客服id,反之传客户id
queryType查询类型Integer2否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工单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,正常返回!"
}