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

查询工单详情

接口说明:

返回该条工单的详细信息(包括自定义字段)

访问方式:

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

请求参数(Request Body):

字段编码字段名称字段类型长度可空备注说明
action调用方法名称String36值传queryTicketById
access_tokenToken编码string40
data要传的数据string4000详见下文
method访问方式string10值传get

请求data:

字段编码字段名称字段类型长度可空备注说明
ticketId工单idString36

请求示例:

curl https://www.sobot.com/ws-open/ticket/ticket_api \
-X POST \
-H 'content-type: application/json' \
-d '
{
"action" : "queryTicketById",
"access_token" : "xx",//获取access_token
"data" : {
"ticketId":"xx"
},
"method":"get"
}'

返回参数:

字段编码字段名称字段类型备注说明
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普通用户
startId发起人idString
startName发起人名称String
dealUserId受理人idString
dealUserName受理人名称String
dealGroupId受理组idString
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客服提交
getTicketTime获取工单信息时间Long毫秒时间戳
customerId对应客户idString
resultList自定义字段集合

resultList集合:

字段编码字段名称字段类型备注说明
fieldId字段idString
fieldType自定义字段名称Integer1单行文本 2 多行文本 3 日期 4 时间 5 数值 6 下拉列表 7 复选框 8 单选框
title字段名称String
value字段值StringfieldType的值为6,7,8时,这个字段的值对应的是下拉、复选、单选的value值
text文本值StringfieldType的值为6,7,8时,这个字段的值对应的是下拉、复选、单选的文本值

返回示例:

{
"data":
"item":[
{"ticketId": "xxx"
"ticketCode": 1480924540,
"ticketTitle": "xxx",
"ticketContent":"xxx",
"ticketLevel":0,
"ticketStatus":0,
"startType":0,
"startId":"xxx",
"startName":"xxx",
"dealUserId":"xxx",
"dealUserName":"xxx",
"dealGroupId":"xxx",
"dealGroupName":"xxx",
"createTime":1501142747,
"updateTime":1501142747,
"ticketTypeName":"xxx",
"ticketFrom":0,
"getTicketTime":1501224636,
"customerId":"xxx",
"resultList ":
[
{"fieldId ":"xxx",
"fieldType ":1,
"title":"单行文本",
"value":"单行文本",
"text":""
},
{"fieldId ":"xxx",
"fieldType ":6,
"title":"下拉列表",
"value":"500862697708553",
"text":"下拉一"
}
]
}
],
"code": "1000,正常返回!"
}