接口说明:
1)调用此接口,系统会优先根据提交的参数“工单发起方式”判断是以客户邮箱还是客户电话去查找客户,如果匹配成功,则根据本次提交的其它参数更新对应客户信息。
2)如果邮箱和电话均没有匹配成功,则创建新用户。
访问方式:
POST:https://www.sobot.com/ws-open/ticket/ticket_api
请求参数(Request Body):
字段编码 | 字段名称 | 字段类型 | 长度 | 可空 | 备注说明 |
---|---|---|---|---|---|
action | 调用方法名称 | String | 36 | 否 | 值传addCustomerTicket |
access_token | Token编码 | string | 40 | 否 | |
data | 要传的数据 | string | 4000 | 否 | 详见下文 |
method | 访问方式 | string | 10 | 否 | 值传post |
请求data:
字段编码 | 字段名称 | 字段类型 | 长度 | 可空 | 备注说明 |
---|---|---|---|---|---|
companyId | 企业id | string | 36 | 否 | |
ticketTitle | 工单标题 | string | 300 | 否 | |
ticketStartWay | 工单发起方式 | Integer | 2 | 否 | 1邮箱,2手机 |
ticketContent | 问题描述 | string | 3000 | 否 | |
customerEmail | 客户邮箱 | string | 300 | 是/否 | 是否为空看发起方式,发起方式为邮箱不可为空 |
customerPhone | 客户手机号 | string | 11 | 是/否 | 是否为空看发起方式,发起方式为手机不可为空 |
soruce | 普通用户来源 | Integer | 2 | 否 | 0PC,1微信,2 APP,3微博,4WAP |
ticketStatus | 工单状态 | Integer | 2 | 否 | 0尚未受理,1受理中,2等待回复,3已解决,99已关闭,98已删除 |
ticketLevel | 工单优先级 | Integer | 2 | 否 | 0低,1中,2高,3紧急 |
fileStr | 附件路径 | string | 500 | 是 | 多个附件,附件路径之间以分号分隔 |
请求示例:
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,正常返回!"
}