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

创建工单(客户提交)

接口说明:

1)调用此接口,系统会优先根据提交的参数“工单发起方式”判断是以客户邮箱还是客户电话去查找客户,如果匹配成功,则根据本次提交的其它参数更新对应客户信息。

2)如果邮箱和电话均没有匹配成功,则创建新用户。

访问方式:

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

请求参数(Request Body):

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

请求data:

字段编码字段名称字段类型长度可空备注说明
companyId企业idstring36
ticketTitle工单标题string300
ticketStartWay工单发起方式Integer21邮箱,2手机
ticketContent问题描述string3000
customerEmail客户邮箱string300是/否是否为空看发起方式,发起方式为邮箱不可为空
customerPhone客户手机号string11是/否是否为空看发起方式,发起方式为手机不可为空
soruce普通用户来源Integer20PC,1微信,2 APP,3微博,4WAP
ticketStatus工单状态Integer20尚未受理,1受理中,2等待回复,3已解决,99已关闭,98已删除
ticketLevel工单优先级Integer20低,1中,2高,3紧急
fileStr附件路径string500多个附件,附件路径之间以分号分隔

请求示例:

curl https://www.sobot.com/ws-open/ticket/
 ticket_api \
-X POST \
-H 'content-type: application/json' \
-d '
{
"action": "addCustomerTicket ",
"access_token" : "xx",//获取access_token
"data" : {
"companyId":"xx",
"ticketTitle":"xx",
"ticketStartWay":1,
"ticketContent":"xx",
"customerEmail":"xx",
"customerPhone":"xx",
"soruce":1,
"ticketStatus":1,
"ticketLevel":1,
"fileStr":"xx"
},
"method":"post"
}'

返回参数:

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

返回示例:

{
"data":{
"item":"XXX"
},
"code": "1000,正常返回!"
}