接口说明:
数据字典包含:受理客服组、受理客服、工单分类、工单状态、工单优先级、抄送数据。
其中,受理客服组,受理客服,抄送,工单分类为动态字典项,返回数据会随企业自身配置会发生变化!
访问方式:
GET:https://www.sobot.com/ws-open/ticket/getDataDict
请求参数(Request Body):
字段编码 | 字段名称 | 字段类型 | 长度 | 可空 | 备注说明 |
---|---|---|---|---|---|
access_token | Token编码 | string | 40 | 否 |
请求示例:
curl https://www.sobot.com/ws-open/ticket/getDataDict \
-X POST \
-H 'content-type: application/json' \
-d '
{
"access_token" : "xx"//获取access_token
}'
返回参数:
字段编码 | 字段名称 | 字段类型 | 备注说明 |
---|---|---|---|
code | 返回编码 | string | |
data | 数据对象 | object | 详见下文 |
返回data:
字段编码 | 字段名称 | 展现形式 | 备注说明 |
---|---|---|---|
ticketTypeList | 所有工单分类集合 | 树形结构 | 企业自定义分类,业务变化频繁 |
groupList | 受理客服组集合 | 下拉框 | 业务变化频繁 |
serviceList | 受理客服集合 | 下拉框 | 业务变化频繁,抄送数据也是这个 |
ticketLevelList | 工单优先级集合 | 下拉框 | |
ticketStatusList | 工单状态集合 | 下拉框 |
集合ticketTypeList:
字段编码 | 字段名称 | 字段类型 | 备注说明 |
---|---|---|---|
typeId | 分类id | string | |
typeName | 分类名称 | string | |
parentId | 父id | string | 值为父级的typeId |
typeLevel | 分类级别 | Integer | 最多三级(第一级,2:第二级,3:第三级) |
nodeFlag | 是否为叶子节点 | Integer | 0是 1 不是 |
items | 子级集合 | 详见下文 |
集合groupList:
字段编码 | 字段名称 | 字段类型 |
---|---|---|
groupId | 组id | string |
groupName | 组名称 | string |
集合serviceList:
字段编码 | 字段名称 | 字段类型 |
---|---|---|
serviceId | 客服id | string |
serviceName | 客服名称 | string |
集合ticketLevelList:
字段编码 | 字段名称 | 字段类型 |
---|---|---|
dictValue | 优先级code | string |
dictName | 优先级名称 | string |
集合ticketStatusList:
字段编码 | 字段名称 | 字段类型 |
---|---|---|
dictValue | 状态code | string |
dictName | 状态名称 | string |
返回示例:
{
"data":{
"ticketTypeList" : [{"typeId":"XX",
"typeName":"xxx",
"parentId":"xxx",
"typeLevel":0,
"nodeFlag":1,
"item":[{"typeId":"XX",
"typeName":"xxx",
"parentId":"xxx",
"typeLevel":0,
"nodeFlag":1,
"item":[{"typeId":"XX",
"typeName":"xxx",
"parentId":"xxx",
"typeLevel":0,
"nodeFlag":0
}]
}]
}],
"groupList" : [{
"groupId":"xxx",
"groupName":"xxx"
},
{
"groupId":"xxx",
"groupName":"xxx"
}
],
"serviceList" : [{
"serviceId ":"xxx",
"serviceName ":"xxx"
},
{
"serviceId ":"xxx",
"serviceName ":"xxx"
}
],
"ticketLevelList" : [{
"dictValue":"xxx",
"dictName":"xxx"
},
{
"dictValue":"xxx",
"dictName":"xxx"
}
],
"ticketStatusList" : [{
"dictValue":"xxx",
"dictName":"xxx"
},
{
"dictValue":"xxx",
"dictName":"xxx"
}
]
},
"code": "1000,正常返回!"
}