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

创建工单(客服提交)

接口说明:

客服创建工单并把工单关联到相对应的客户下

访问方式:

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

请求参数(Request Body):

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

请求data:

字段编码字段名称字段类型长度可空备注说明
ticketStartWay工单发起方式string36
ticketTitle工单标题string300
ticketTypeId工单分类idString36值为最后一级分类的id
ticketContent问题描述string3000
ticketFrom工单来源Integer20工单中心,1 PC普通用户留言提交,2 H5普通用户留言提交,3普通用户微信提交,4普通用户APP提交,5普通用户微博提交,6 在线工作台-PC客服提交,7客户中心,8呼叫中心 9 在线工作台-微信客服提交 10 在线工作台-H5客服提交 11 在线工作台-App客服提交
ticketStatus工单状态Integer20尚未受理,1受理中,2等待回复,3已解决,99已关闭,98已删除
ticketLevel工单优先级Integer20低,1中,2高,3紧急
fileStr附件路径string500多个附件,附件路径之间以分号分隔
dealGroupId受理客服组idstring36
dealGroupName受理客服组名string50
dealUserId受理客服idstring36
dealUserName受理客服名string50
copyUser抄送客服idstring36
customerId对应客户idstring36
extendFields自定义字段string1000格式:[{"id":"xx(filedId对应的值)","value":"xx(入力或选择的值)"}]
recordId记录idstring36呼叫记录id或会话记录id

请求示例:

curl https://www.sobot.com/ws-open/ticket/ticket_api \
-X POST \
-H 'content-type: application/json' \
-d '
{
"action" : "addServiceTicket",
"access_token" : "xx",//获取access_token
"data" : {
"ticketTypeId ":"xx",
"ticketTitle":"xx",
"ticketStartWay":1,
"ticketContent":"xx",
"ticketFrom":1,
"ticketStatus":1,
"ticketLevel":1,
"fileStr":"xx",
"dealGroupId":"xx",
"dealGroupName":"xx",
"dealUserId":"xx",
"dealUserName":"xx",
"copyUser":"xx",
"customerId":"xx",
"extendFields":"[{
'id":"xx(filedId对应的值)",
"value":"xx(入力或选择(传id)的值)"
},
{
"id":"xx(filedId对应的值)",
"value":"xx(入力或选择(传id,如复选框选择多个,中间以逗号分隔)的值)"
}
]",
"recordId":"xx",
},
"method":"post"
}'

返回参数:

字段编码字段名称字段类型备注说明
code返回编码string
data数据对象详见下文

返回示例:

{
"data":{
"item":[{"ticketId":"XXX","ticketCode":"xxx"}]
},
"code": "1000,正常返回!"
}