查询工单列表
若您初次使用智齿客服开放平台接口-工单系统业务接口,请在使用前阅读说明文档。
接口说明:
接口类型:主动调用接口
接口作用:可通过调用该接口来查询工单列表。通过客服id返回受理客服为该客服的工单列表,通过客户id返回相应客户为该客户的工单列表。
按照更新时间排序
访问方式:
请求方法: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,正常返回!"
}