查询工单列表(按创建时间段)

若您初次使用智齿客服开放平台接口-工单系统业务接口,请在使用前阅读说明文档

接口说明:

按照工单创建时间段查询工单信息。

访问方式:

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

请求参数(Request Body):

字段编码 字段名称 字段类型 长度 可空 备注说明
access_token Token编码 string 40 -
createStartTime 创建开始时间 long 11 秒时间戳
createEndTime 创建结束时间 long 11 秒时间戳(查询时创建时间段不能大于一个月)
ticketStatus 工单状态 Integer 2 0未受理,1受理中,2等待回复,3已解决,99已关闭,98已删除
ticketFrom 工单来源 Integer 2 0:工单中心,1:PC客户留言 2:H5客户留言,3:微信公众号客户留言,4:APP客户留言 ,6:PC-在线工作台,7:客户中心,8:呼叫中心,9:微信公众号-在线工作台,10:H5-在线工作台,11:APP-在线工作台,12:邮件留言,13:语音留言,14:微信小程序-在线工作台,15:企业微信-在线工作台,16:微信小程序客户留言,17:企业微信客户留言
ticketTypeId 工单分类id string 36 -
pageNo 当前页数 Integer 4 -
pageSize 当前页显示条数 Integer 4 默认每页显示15条,最大每页显示50条

请求示例:

curl https://www.sobot.com/ws-open/ticket/getTicketList \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "access_token" : "xx",//获取access_token
  "createStartTime":1538323200,
  "createEndTime":1540915200,
  "ticketStatus":1,
  "ticketFrom":1,
  "ticketTypeId":"xxx",
  "pageNo":1,
  "pageSize":15
}'

返回参数:

字段编码 字段名称 字段类型 备注说明
code 返回编码 string -
data 数据对象 - 详见下文
pageCount 总页数 integer -
totalCount 总条数 integer -
pageNo 当前页数 integer -
pageSize 每页显示条数 integer -

返回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客户留言 ,6:PC-在线工作台,7:客户中心,8:呼叫中心,9:微信公众号-在线工作台,10:H5-在线工作台,11:APP-在线工作台,12:邮件留言,13:语音留言,14:微信小程序-在线工作台,15:企业微信-在线工作台,16:微信小程序客户留言,17:企业微信客户留言

返回示例:

{
    "data": [
                  { "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
                 }

     ],
    "pageCount": 2,
    "totalCount": 30,
"pageNo": 1,
"pageSize": 15,
    "code": "1000,正常返回!"
}

results matching ""

    No results matching ""