# 工单中心

# 1、接口声明

在调用接口时必须在https请求的header中携带"token"参数。

token是智齿客服接口开放平台全局唯一的接口调用凭据。
开发者在调用各业务接口时都需使用token，开发者需要进行妥善保存。token的存储至少要保留32个字符空间。token的有效期目前为24个小时，需定时刷新，或根据接口返回的token失效提示，进行重新获取。请求token接口，无论token是否存在，都会返回新的token，并重置token的过期时间(目前24小时)。

token使用方式说明：
1、开发者需要统一获取和管理token，在调用智齿客服各个业务开放接口时都应该使用同一个的token，不应该每个业务都刷新获取新的 token，否则容易导致token失效，影响接口的正常调用；
2、目前token的有效期通过返回的expire_in来传达，目前是86400 秒之内的值。开发者需要根据这个有效时间提前去刷新新token。
3、开发者需要根据接口返回的token失效提示，进行重新获取token。

# 2、接口调用

# 2.1、获取访问token编码

接口说明：

获取API开放接口token，此token仅适用于智齿开放平台 5.0版本全部API接口 。API接口中的参数 appid, app_key 请联系智齿售后人员获取。

请求方式：

GET

请求地址：

https://www.sobot.com/api/get_token

请求参数：

参数	类型	必填	名称	备注
appid	String	是	接口凭证Id	第三方用户接口调用唯一凭证id
create_time	String	是	时间戳	时间戳,秒，例如 2019-09-25 15:49:33 的时间戳1569397773
sign	String	是	签名	md5(appid+create_time+app_key) sign签名,app_key为密钥

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	否	返回对象

item对象：

参数	类型	必填	名称	备注
token	String	是	token编码
expires_in	String	是	凭证有效时间	单位：秒

时间戳转换参考工具：

http://tool.chinaz.com/Tools/unixtime.aspx

sign签名生成示例：

例如，appid = "1"; create_time="1569397773"; app_key="2"

sign = Md5("115693977732") 为 258eec3118705112b2c53dc8043d4d34。

请求示例：

curl https://www.sobot.com/api/get_token?appid=1&create_time=1569397773&sign=258eec3118705112b2c53dc8043d4d34

返回示例：

{
    "item": {
        "token": "4ac37cb2e9c740dba4b75a34d5358802",
        "expires_in": "86400"
    },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.2、查询数据字典

接口说明：

数据字典包含：工单分类、工单状态、工单优先级、抄送数据其中抄送，工单分类为动态字典项，返回数据会随企业自身配置会发生变化。需要上述数据具体值时，请调用此接口获取。

请求方式：

GET

请求地址：

/api/ws/5/ticket/get_data_dict

请求参数：

参数	类型	必填	名称	备注
无

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	是	返回对象

item对象：

参数	类型	必填	名称	备注
ticket_type_list	List	是	工单分类信息	企业自定义分类，业务变化频繁
ticket_status_list	List	是	工单状态信息
ticket_level_list	List	是	工单优先级信息
group_list	List	是	技能组信息	业务变化频繁
agent_list	List	是	坐席信息	业务变化频繁

ticket_type_list集合：

参数	类型	必填	名称	备注
typeid	String	是	分类ID
companyid	String	是	公司ID
type_name	String	是	分类名称
parentid	String	是	父ID
type_level	String	是	分类级别	最多五级（第一级，2：第二级，3：第三级，4：第四级，5：第五级）
node_flag	String	是	是否叶子节点	0 是 1 不是
sub_type_list	List	是	子分类信息	内容与ticket_type_list一致

ticket_status_list集合：

参数	类型	必填	名称
dict_value	String	是	工单状态CODE
dict_name	String	是	工单状态名称

ticket_level_list集合：

参数	类型	必填	名称
dict_value	String	是	工单优先级CODE
dict_name	String	是	工单优先级名称

group_list集合：

参数	类型	必填	名称
groupid	String	是	技能组ID
group_name	String	是	技能组名称

agent_list集合：

参数	类型	必填	名称
agentid	String	是	坐席ID
agent_name	String	是	坐席名称

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/get_data_dict

返回示例：

{
    "item": {
        "ticket_level_list": [
            {
                "dict_name": "低",
                "dict_value": "0"
            },
            {
                "dict_name": "中",
                "dict_value": "1"
            },
            {
                "dict_name": "高",
                "dict_value": "2"
            },
            {
                "dict_name": "紧急",
                "dict_value": "3"
            }
        ],
        "group_list": [
            {
                "group_name": "测试电销组",
                "groupid": "acb290d666814d65834c70073aed65f2_4"
            },
            {
                "group_name": "智齿_123",
                "groupid": "e3b931da9ab24a2abcb6f6ae59ae8c0c"
            }
        ],
        "ticket_status_list": [
            {
                "dict_name": "尚未受理",
                "dict_value": "0"
            },
            {
                "dict_name": "受理中",
                "dict_value": "1"
            },
            {
                "dict_name": "等待回复",
                "dict_value": "2"
            },
            {
                "dict_name": "已解决",
                "dict_value": "3"
            },
            {
                "dict_name": "已关闭",
                "dict_value": "99"
            }
        ],
        "ticket_type_list": [
            {
                "companyid": "acb290d666814d65834c70073aed65f2",
                "node_flag": "0",
                "parentid": "-1",
                "type_level": "1",
                "type_name": "其他",
                "typeid": "9"
            }, 
            {
                "companyid": "acb290d666814d65834c70073aed65f2",
                "node_flag": "1",
                "parentid": "-1",
                "sub_type_list": [
                    {
                        "companyid":"acb290d666814d65834c70073aed65f2",
                        "node_flag": "0",
                        "parentid": "131b5060166d4dbbb4beda95a4ff3d32",
                        "type_level": "2",
                        "type_name": "系统/应用类问题",
                        "typeid": "42a4d00d26304a1fa3c94c552d47cfdf"
                    },
                    {
                        "companyid": "acb290d666814d65834c70073aed65f2",
                        "node_flag": "1",
                        "parentid": "131b5060166d4dbbb4beda95a4ff3d32",
                        "sub_type_list": [
                            {
                                "companyid": "acb290d666814d65834c70073aed65f2",
                                "node_flag": "1",
                                "parentid": "5dc2f4d31c894f35a779f6a6d175c803",
                                "sub_type_list": [
                                    {
                                    "companyid": "acb290d666814d65834c70073aed65f2",
                                    "node_flag": "0",
                                    "parentid": "d3c3a3efc71f4a949bb7be8af6643626",
                                    "type_level": "3",
                                    "type_name": "摄像问题",
                                    "typeid": "d3c3a3efc71f4a949bb7be8af6643626"
                                    }
                                ],
                            "type_level": "2",
                            "type_name": "拍照",
                                "typeid": "5dc2f4d31c894f35a779f6a6d175c803"
                            }
                        ],
                        "type_level": "1",
                        "type_name": "故障排查",
                        "typeid": "131b5060166d4dbbb4beda95a4ff3d32"
                    }
                ]
            }
        ],
        "agent_list": [
            {
                "agent_name": "ming",
                "agentid": "0a37c8156d094311890e48fbc06501c4"
            },
            {
                "agent_name": "智齿测试12",
                "agentid": "efcfda336b5d4caeb4fd71392c54b5c9"
            }
        ]
    },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.3、查询自定义字段定义信息

接口说明：

返回工单自定义字段的基本信息

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_ticket_extend_fields

请求参数：

参数	类型	必填	名称	备注
无

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	是	返回集合

items对象：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_name	String	是	自定义字段名称
field_type	String	是	自定义字段类型	1单行文本，2多行文本，3日期，4时间，5 数值，6下拉列表，7复选框，8单选框
fill_flag	String	是	自定义字段是否必填	0 否 1 是
field_data_list	List	否	选择型字段的选项信息

field_data_list集合：

参数	类型	必填	名称
data_name	String	是	自定义字段选项名称
data_value	String	是	自定义字段选项CODE值

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_ticket_extend_fields

返回示例：

{
    "items": [
        {
            "field_data_list": [
                {
                    "data_name": "999",
                    "data_value": "540264609760473"
                },
                {
                    "data_name": "777",
                    "data_value": "540264668320333"
                },
                {
                    "data_name": "888",
                    "data_value": "540264668320352"
                }
            ],
            "field_name": "下拉列表",
            "field_type": 6,
            "fieldid": "3ceef648f3d6412abdf8fd6aac5db9f3",
            "fill_flag": 1
        },
        {
            "field_data_list": [
                {
                    "data_name": "语文",
                    "data_value": "500862751814255"
                },
                {
                    "data_name": "数学",
                    "data_value": "500862751819356"
                },
                {
                    "data_name": "英语",
                    "data_value": "502372726676614"
                }
            ],
            "field_name": "复选",
            "field_type": 7,
            "fieldid": "8f52d2f19fad4a8eae22238437817b9c",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "测试234",
            "field_type": 5,
            "fieldid": "d1dc7e1e13794cf1a936d74b76c4ecc0",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "时间",
            "field_type": 4,
            "fieldid": "4e1e6b21b433461d9bac2cee6d3297d1",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "日期",
            "field_type": 3,
            "fieldid": "30b5071f2b514d57b6d34e7c95cdf431",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "567",
            "field_type": 2,
            "fieldid": "c2610afb04014d788e398324f7f01329",
            "fill_flag": 0
        }
    ],
    "ret_code": "000000",
    "ret_msg": "操作成功!"
}

# 2.4、工单自定义字段（选择型）添加选项信息

接口说明：

工单选择型自定义字段批量添加选项信息。

请求方式：

POST

请求地址：

/api/ws/5/ticket/save_option_data_value

请求参数：

参数	类型	必填	名称
fieldid	String	是	工单自定义字段ID
field_data_value	List	是	工单自定义字段选项信息
agentid	String	是	操作坐席ID
agent_name	String	是	操作坐席名称

data_value集合：

参数	类型	必填	名称
field_value	String	是	字段选项值
field_text	String	是	字段文本值

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/save_option_data_value -X POST -H 'content-type: application/json' 
-H 'token:4ac37cb2e9c740dba4b75a34d5358802'  -d '{"fieldid":"3ceef648f3d6412abdf8fd6aac5db9f3","agentid":"0a37c8156d094311890e48fbc06501c4","agent_name":"ming","field_data_value":[{"field_value":"539325753445693","field_text":"下列选项一"}]}'

返回示例：

 {
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.5、查询工单分类关联的工单模板

接口说明：

返回工单分类关联的工单模板中的自定义字段信息

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_fileds_by_typeid

请求参数：

参数	类型	必填	名称
ticket_typeid	String	是	工单分类ID

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	是	返回集合

items对象：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_name	String	是	自定义字段名称
field_type	String	是	自定义字段类型	1单行文本，2多行文本，3日期，4时间，5 数值，6下拉列表，7复选框，8单选框
fill_flag	String	是	自定义字段是否必填	0 否 1 是
field_data_list	List	否	选择型字段的选项信息

field_data_list集合：

参数	类型	必填	名称
data_name	String	是	自定义字段选项名称
data_value	String	是	自定义字段选项CODE值

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_fileds_by_typeid
?ticket_typeid=75c5b76905054a0bad862d0e725570e9

返回示例：

{
    "items": [
        {
            "field_data_list": [
                {
                    "data_name": "999",
                    "data_value": "540264609760473"
                },
                {
                    "data_name": "777",
                    "data_value": "540264668320333"
                },
                {
                    "data_name": "888",
                    "data_value": "540264668320352"
                }
            ],
            "field_name": "下拉列表",
            "field_type": 6,
            "fieldid": "3ceef648f3d6412abdf8fd6aac5db9f3",
            "fill_flag": 1
        },
        {
            "field_data_list": [
                {
                    "data_name": "语文",
                    "data_value": "500862751814255"
                },
                {
                    "data_name": "数学",
                    "data_value": "500862751819356"
                },
                {
                    "data_name": "英语",
                    "data_value": "502372726676614"
                }
            ],
            "field_name": "复选",
            "field_type": 7,
            "fieldid": "8f52d2f19fad4a8eae22238437817b9c",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "测试234",
            "field_type": 5,
            "fieldid": "d1dc7e1e13794cf1a936d74b76c4ecc0",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "时间",
            "field_type": 4,
            "fieldid": "4e1e6b21b433461d9bac2cee6d3297d1",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "日期",
            "field_type": 3,
            "fieldid": "30b5071f2b514d57b6d34e7c95cdf431",
            "fill_flag": 0
        },
        {
            "field_data_list": [],
            "field_name": "567",
            "field_type": 2,
            "fieldid": "c2610afb04014d788e398324f7f01329",
            "fill_flag": 0
        }
    ],
    "ret_code": "000000",
    "ret_msg": "操作成功!"
}

# 2.6、创建工单（客户）

接口说明：

1)调用此接口，系统会根据提交的参数按此优先级“客户ID > 对接ID > 客户邮箱 > 客户手机号”查找客户，如果匹配成功，用该客户作为工单关联客户，否则新建客户后关联。

备注：

1、此处所传工单自定义字段，必须是所传工单分类id关联工单模板中的自定义字段。 2、分类关联模板中的自定义字段通过“查询工单分类关联的工单模板信息“接口获取。 3、工单分类ID需要调用“查询数据字典”中工单分类获取具体值。 4、如需上传附件，需要调用“附件上传（客户）”进行。

请求方式：

POST

请求地址：

/api/ws/5/ticket/save_user_ticket

请求参数：

参数	类型	必填	名称	备注
companyid	String	是	企业ID
ticket_title	String	是	工单标题
userid	String	否	客户ID
partnerid	String	否	对接ID
ticket_content	String	是	工单问题描述
user_emails	String	否	客户邮箱
user_tels	String	否	客户电话
ticket_typeid	String	是	工单分类ID	叶子节点的分类ID
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
file_str	String	否	附件路径	多个附件，附件之间采用英文分号";"隔开
extend_fields	List	否	工单自定义字段信息

extend_fields集合：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_value	String	是	自定义字段值

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	否	返回对象

item对象：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/save_user_ticket -X POST -H 'content-type: application/json' -H 'token:4ac37cb2e9c740dba4b75a34d5358802' -d '{"companyid":"acb290d666814d65834c70073aed65f2","ticket_title":"测试工单","userid":"007e447e1c104583971c2e990df0d4ac","ticket_content":"测试工单",,"ticket_typeid":"4112bddd39cd4895808180f139cd497a",   "ticket_from":"1","extend_fields":[{"fieldid":"5ba3741d772c47d9a3066db1d3900b4e","field_value":"123"},{"fieldid":"3ceef648f3d6412abdf8fd6aac5db9f3","field_value":"539325753445693"}}'

返回示例：

{
    "item": {
        "ticketid": "5c4015d7bf71493db4a53a2877a1ae98"
    },
    "items": [],
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.7、创建工单（坐席）

接口说明：

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

备注：

1、此处所传工单自定义字段，必须是所传工单分类id关联工单模板中的自定义字段。 2、分类关联模板中的自定义字段通过“查询工单分类关联的工单模板信息“接口获取。 3、工单分类ID需要调用“查询数据字典”中工单分类获取具体值。 4、如需上传附件，需要调用“附件上传（坐席）”进行。

请求方式：

POST

请求地址：

/api/ws/5/ticket/save_agent_ticket

请求参数：

参数	类型	必填	名称	备注
companyid	String	是	企业ID
ticket_title	String	是	工单标题
userid	String	否	客户ID
ticket_content	String	是	工单问题描述
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
deal_groupid	String	否	受理技能组ID
deal_group_name	String	否	受理技能组名称
deal_agentid	String	否	受理坐席ID
deal_agent_name	String	否	受理坐席名称
create_agentid	String	是	创建坐席ID
create_agent_name	String	是	创建坐席名称
record_id	String	否	记录ID	呼叫记录ID或会话记录ID
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
ticket_typeid	String	是	工单分类ID	叶子节点的分类ID
file_str	String	否	附件路径	多个附件，附件之间采用英文分号";"隔开
copy_agent	List	否	抄送坐席
extend_fields	List	否	工单自定义字段信息

copy_agent 集合：

参数	类型	必填	名称	备注
agent_name	String	是	坐席名称
agent_mail	String	是	坐席邮箱

extend_fields集合：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_value	String	是	自定义字段值

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	否	返回对象

item对象：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/save_agent_ticket -X POST -H 'content-type: application/json' 
-H 'token:4ac37cb2e9c740dba4b75a34d5358802' 
-d '{"companyid":"acb290d666814d65834c70073aed65f2","ticket_title":"测试工单","userid":"007e447e1c104583971c2e990df0d4ac","ticket_content":"测试工单","ticket_status":"1","ticket_level":"0","create_agentid":"0a37c8156d094311890e48fbc06501c4","create_agent_name":"ming",
"ticket_typeid":"4112bddd39cd4895808180f139cd497a","ticket_from":"0","extend_fields":[{"fieldid":"5ba3741d772c47d9a3066db1d3900b4e","field_value":"123"},{"fieldid":"3ceef648f3d6412abdf8fd6aac5db9f3","field_value":"539325753445693"}]}'

返回示例：

{
    "item": {
        "ticketid": "5c4015d7bf71493db4a53a2877a1ae98"
    },
    "items": [],
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.8、回复工单（客户）

接口说明：

1)客户：客户可回复所有人
2)坐席：坐席回复分为仅回复坐席和回复所有人。

请求方式：

POST

请求地址：

/api/ws/5/ticket/save_user_reply

请求参数：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID
reply_content	String	是	工单回复内容
file_str	String	否	回复附件路径	多个附件，附件之间采用英文分号";"隔开

返回参数：

参数	类型	必填	名称	备注
ret_code	String	是	返回编码
ret_msg	String	是	返回信息

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/save_user_reply -X POST -H 'content-type: application/json' 
-H 'token:4ac37cb2e9c740dba4b75a34d5358802' -d '{"ticketid":"acb290d666814d65834c70073aed65f2","reply_content":"坐席回复工单"}''

返回示例：

 {
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.9、回复工单（坐席）

接口说明：

1)客户：客户可回复所有人
2)坐席：坐席回复分为仅回复坐席和回复所有人。

请求方式：

POST

请求地址：

/api/ws/5/ticket/save_ticket_reply

请求参数：

参数	类型	必填	名称	备注
ticket_title	String	是	工单标题
ticket_content	String	是	工单问题描述
ticketid	String	是	工单ID
get_ticket_datetime	String	是	获取工单信息时间	2019-09-19 13:00:00 (当前时间)
reply_content	String	否	工单回复内容
reply_type	String	是	工单回复类型	0 所有人可见，1 仅坐席可见
deal_groupid	String	否	受理技能组ID
deal_group_name	String	否	受理技能组名称
deal_agentid	String	否	受理坐席ID
deal_agent_name	String	否	受理坐席名称
reply_agentid	String	是	回复坐席ID	指当前处理回复的坐席
reply_agent_name	String	是	回复坐席名称
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
reply_file_str	String	否	回复附件路径	多个附件，附件之间采用英文分号";"隔开
copy_agent	List	否	抄送坐席
extend_fields	List	否	工单自定义字段信息

copy_agent集合：

参数	类型	必填	名称	备注
agent_name	String	是	坐席名称
agent_mail	String	是	坐席邮箱

extend_fields集合：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_value	String	是	自定义字段值

返回参数：

参数	类型	必填	名称	备注
ret_code	String	是	返回编码
ret_msg	String	是	返回信息

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/save_ticket_reply -X POST 
-H 'content-type: application/json' 
-H 'token:4ac37cb2e9c740dba4b75a34d5358802' -d '{"ticketid":"acb290d666814d65834c70073aed65f2","ticket_title":"测试工单","reply_content":"坐席回复工单","ticket_content":"测试工单","reply_type":"0","ticket_status":"1","ticket_level":"0",
"get_ticket_datetime":"2019-09-19 13:00:00","reply_agentid":"0a37c8156d094311890e48fbc06501c4","reply_agent_name":"ming","copy_agent":[{"agent_name":"工单坐席","agent_mail":"3443355456@qq.com"}],"reply_agentid":"0a37c8156d094311890e48fbc06501c4","reply_agent_name":"ming","extend_fields":[{"fieldid":"5ba3741d772c47d9a3066db1d3900b4e","field_value":"123"},{"fieldid":"3ceef648f3d6412abdf8fd6aac5db9f3","field_value":"539325753445693"}]}'

返回示例：

 {
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.10、附件上传（客户）

接口说明：

客户创建工单或回复工单时，上传一个或多个附件。先上传附件，再调用“创建工单（客户）”或者“回复工单（客户）”。

备注：

1、在请求中注明Content-Type: multipart/form-data;boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

请求方式：

POST

请求地址：

/api/ws/5/ticket/user_upload_file

请求参数：

参数	类型	必填	名称	备注
file	IO流	否	文件流	选择要上传的文件
file_num_key	String	否	上传文件标识	随机生成的值，用于判断上传文件数量

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	否	返回对象

item对象：

参数	类型	必填	名称	备注
file_url	String	是	文件路径

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/user_upload_file -X POST-H 'content-type:multipart/form-data;boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' -H 'token: 4ac37cb2e9c740dba4b75a34d5358802' -F 'file=@/ C:/Users/Pictures/微信图片_20190528114613.jpg ' -F 'file_num_key=16dfc20e-f3de-46tf-8088-844cfde704d3'

返回示例：

{
   "item": {   
"file_url":"https://sobot.oss-cn-beijing.aliyuncs.com/console/acb290d666814d65834c70073aed65f2/ticket/微信图片_20190528114613.jpg"
   },
   "ret_code": "000000",
   "ret_msg": "操作成功"
}

# 2.11、附件上传（坐席）

接口说明：

坐席创建工单或回复工单时，上传一个或多个附件先上传附件，再调用“创建工单（坐席）”或者“回复工单（坐席）”

备注：

1、在请求中注明Content-Type: multipart/form-data;boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

请求方式：

POST

请求地址：

/api/ws/5/ticket/upload_file

请求参数：

参数	类型	必填	名称	备注
file	IO流	否	文件流	选择要上传的文件
file_num_key	String	否	上传文件标识	随机生成的值，用于判断上传文件数量

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	否	返回对象

item对象：

参数	类型	必填	名称	备注
file_url	String	是	文件路径

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/upload_file -X POST -H 'content-type:multipart/form-data;boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' -H 'token: 4ac37cb2e9c740dba4b75a34d5358802' -F 'file=@/ C:/Users/Pictures/微信图片_20190528114613.jpg' -F 'file_num_key=16dfc20e-f3de-46tf-8088-844cfde704d3'

返回示例：

{
   "item": {   
        "file_url":"https://sobot.oss-cn-beijing.aliyuncs.com/console/acb290d666814d65834c70073aed65f2/ticket/微信图片_20190528114613.jpg"
   },
   "ret_code": "000000",
   "ret_msg": "操作成功"
}

# 2.12、添加工单满意度评价

接口说明：

对工单满意度进行评价，返回操作结果

请求方式：

POST

请求地址：

/api/ws/5/ticket/add_ticket_evaluation

请求参数：

参数	类型	必填	名称	备注
ticketId	String	是	工单ID
companyId	String	是	公司ID
score	Integer	是	评分	1 1星，2 2星，3 3星，4 4星，5 5星
remark	String	否	评语

返回参数：

字段	类型	必填	名称	描述
ret_code	String	是	返回编码
ret_msg	String	是	返回信息

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/ add_ticket_evaluation?ticketId=2831ceace38c45649840374a08d321bd&companyId=45649840374a08d321bd&score=5&remark=我对本次服务表示满意

返回示例：

{
   "ret_code": "000000",
   "ret_msg": "操作成功"
}

# 2.13、根据创建时间查询工单列表

接口说明：

按照工单创建时间段查询工单列表信息

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_tickets

请求参数：

参数	类型	必填	名称	备注
create_start_datetime	String	是	工单创建开始时间	2018-09-18 00:00:00
create_end_datetime	String	是	工单创建结束时间	2018-09-18 23:59:59（查询创建时间段不能大于一个月）
ticket_status	String	否	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_from	String	否	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
ticket_typeid	String	否	工单分类ID
userid	String	否	客户ID
deal_agentid	String	否	受理坐席ID
deal_agent_groupid	String	否	受理坐席组ID
page_no	Integer	是	当前页数	默认第一页
page_size	Integer	是	当前页显示条数	默认每页显示15条，最大每页显示50条

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	否	返回集合
page_no	Integer	是	当前页数
page_size	Integer	是	当前页显示条数
page_count	Integer	是	总页数
total_count	Integer	是	总条数

items集合：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID
ticket_title	String	是	工单标题
ticket_type_name	String	是	工单分类	显示格式：一级/二级/三级
ticket_content	String	是	问题描述
ticket_code	String	是	工单编号
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
start_type	String	是	工单发起人类型	0坐席，1客户
start_name	String	是	工单发起人名称
ticket_type_name	String	是	工单分类名称	显示格式：一级/二级/三级
deal_agent_name	String	否	受理坐席名称
deal_group_name	String	否	受理技能组名称
create_datetime	String	是	工单创建时间	2018-09-18 12:00:00
update_datetime	String	是	工单更新时间	2018-09-18 13:00:00
user_nick	String	是	客户昵称
user_name	String	否	客户名称
user_tels	String	否	客户电话	多个电话号码，号码之间采用英文逗号","隔开
user_emails	String	否	客户邮箱	多个邮箱，邮箱之间采用英文逗号","隔开
evaluation_datetime	String	否	工单评价时间	2018-09-18 13:00:00
score	Integer	否	评分	1 1星，2 2星，3 3星，4 4星，5 5星
remark	String	否	评语

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_tickets?create_start_datetime=2018-09-18 00:00:00&create_end_datetime=2018-09-18 23:59:59

返回示例：

 {
    "items": [
        {
            "create_datetime": "2018-09-18 09:10:05",
            "deal_group_name": "",
            "deal_agent_name": "",
            "start_name": "测试标签",
            "start_type": "1",
            "ticket_code": "20190912000007",
            "ticket_content": "测试工单",
            "ticket_from": "1",
            "ticket_level": "0",
            "ticket_status": "1",
            "ticket_title": "测试工单",
            "ticket_type_name": "售后",
            "ticketid": "b6dacd72a5cf4e2999e78a18a9126c72",
            "update_datetime":"2018-09-18 09:15:55",
            "user_nick": "测试标签",
			  "evaluation_datetime":"2018-09-18 09:15:55",
			  "score":1,
			  "remark":"问题解决地非常快，果断好评"
        },
        {
            "create_datetime":"2018-09-18 08:14:05",
            "deal_group_name": "",
            "deal_agent_name": "",
            "start_name": "测试标签",
            "start_type": "1",
            "ticket_code": "20190912000006",
            "ticket_content": "测试工单",
            "ticket_from": "1",
            "ticket_level": "0",
            "ticket_status": "1",
            "ticket_title": "测试工单",
            "ticket_type_name": "咨询/咨询1/咨询2",
            "ticketid": "266a341702ef40d595915a3c19676745",
            "update_datetime":""2018-09-18 08:20:05"",
            "user_nick": "测试标签"
        },
        {
            "create_datetime":"2018-09-18 07:34:25",
            "deal_group_name": "123",
            "deal_agent_name": "ming",
            "start_name": "智齿测试12",
            "start_type": "0",
            "ticket_code": "20190912000003",
            "ticket_content": "<p>34433434</p>",
            "ticket_from": "0",
            "ticket_level": "0",
            "ticket_status": "0",
            "ticket_title": "4343",
            "ticket_type_name": "其他",
            "ticketid": "f294176887284c5597794c636d5a1bfe",
            "update_datetime":"2018-09-18 07:54:35",
            "user_emails": "wangxun0104@hotmail.com",
            "user_name": "王迅",
            "user_nick": "王迅",
            "user_tels": "18280240680"
        }
    ],
    "page_count": 1,
    "page_no": 1,
    "page_size": 15,
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "total_count": 3
}

# 2.14、根据更新时间查询工单列表

接口说明：

按照工单更新时间段查询工单列表信息

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_tickets_by_update_time

请求参数：

参数	类型	必填	名称	备注
update_start_datetime	String	是	工单更新开始时间	2018-09-18 00:00:00
update_end_datetime	String	是	工单更新结束时间	2018-09-18 23:59:59（查询创建时间段不能大于一个月）
ticket_status	String	否	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_from	String	否	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
ticket_typeid	String	否	工单分类ID
userid	String	否	客户ID
deal_agentid	String	否	受理坐席ID
deal_agent_groupid	String	否	受理坐席组ID
page_no	Integer	是	当前页数	默认第一页
page_size	Integer	是	当前页显示条数	默认每页显示15条，最大每页显示50条

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	否	返回集合
page_no	Integer	是	当前页数
page_size	Integer	是	当前页显示条数
page_count	Integer	是	总页数
total_count	Integer	是	总条数

items集合：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID
ticket_title	String	是	工单标题
titicket_type_name	String	是	工单分类	显示格式：一级/二级/三级
ticket_content	String	是	问题描述
ticket_code	String	是	工单编号
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
start_type	String	是	工单发起人类型	0坐席，1客户
start_name	String	是	工单发起人名称
ticket_type_name	String	是	工单分类名称	显示格式：一级/二级/三级
deal_agent_name	String	否	受理坐席名称
deal_group_name	String	否	受理技能组名称
create_datetime	String	是	工单创建时间	2018-09-18 12:00:00
update_datetime	String	是	工单更新时间	2018-09-18 13:00:00
user_nick	String	是	客户昵称
user_name	String	否	客户名称
user_tels	String	否	客户电话	多个电话号码，号码之间采用英文逗号","隔开
user_emails	String	否	客户邮箱	多个邮箱，邮箱之间采用英文逗号","隔开
evaluation_datetime	String	否	工单评价时间	2018-09-18 13:00:00
score	Integer	否	评分	1 1星，2 2星，3 3星，4 4星，5 5星
remark	String	否	评语

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_tickets_by_update_time?update_start_datetime=2018-09-18 00:00:00&update_end_datetime=2018-09-18 23:59:59

返回示例：

 {
    "items": [
        {
            "create_datetime": "2018-09-18 09:10:05",
            "deal_group_name": "",
            "deal_agent_name": "",
            "start_name": "测试标签",
            "start_type": "1",
            "ticket_code": "20190912000007",
            "ticket_content": "测试工单",
            "ticket_from": "1",
            "ticket_level": "0",
            "ticket_status": "1",
            "ticket_title": "测试工单",
            "ticket_type_name": "售后",
            "ticketid": "b6dacd72a5cf4e2999e78a18a9126c72",
            "update_datetime":"2018-09-18 09:15:55",
            "user_nick": "测试标签",
			  "evaluation_datetime":"2018-09-18 09:15:55",
			  "score":1,
			  "remark":"问题解决地非常快，果断好评"

        },
        {
            "create_datetime":"2018-09-18 08:14:05",
            "deal_group_name": "",
            "deal_agent_name": "",
            "start_name": "测试标签",
            "start_type": "1",
            "ticket_code": "20190912000006",
            "ticket_content": "测试工单",
            "ticket_from": "1",
            "ticket_level": "0",
            "ticket_status": "1",
            "ticket_title": "测试工单",
            "ticket_type_name": "咨询/咨询1/咨询2",
            "ticketid": "266a341702ef40d595915a3c19676745",
            "update_datetime":""2018-09-18 08:20:05"",
            "user_nick": "测试标签"
        },
        {
            "create_datetime":"2018-09-18 07:34:25",
            "deal_group_name": "123",
            "deal_agent_name": "ming",
            "start_name": "智齿测试12",
            "start_type": "0",
            "ticket_code": "20190912000003",
            "ticket_content": "<p>34433434</p>",
            "ticket_from": "0",
            "ticket_level": "0",
            "ticket_status": "0",
            "ticket_title": "4343",
            "ticket_type_name": "其他",
            "ticketid": "f294176887284c5597794c636d5a1bfe",
            "update_datetime":"2018-09-18 07:54:35",
            "user_emails": "wangxun0104@hotmail.com",
            "user_name": "王迅",
            "user_nick": "王迅",
            "user_tels": "18280240680"
        }
    ],
    "page_count": 1,
    "page_no": 1,
    "page_size": 15,
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "total_count": 3
}

# 2.15、查询工单详情页

接口说明：

返回该条工单的详细信息（包括工单回复、操作历史）。

请求方式：

GET

请求地址：

/api/ws/5/ticket/get_ticket_by_id

请求参数：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	否	返回对象

item对象：

参数	类型	必填	名称	备注
companyid	String	是	公司ID
ticketid	String	是	工单ID
ticket_code	String	是	工单编号
ticket_title	String	是	工单标题
ticket_content	String	是	工单问题描述
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_typeid	String	是	工单分类ID
ticket_type_name	String	是	工单分类名称
start_type	String	是	工单发起人类型	0坐席，1客户
start_name	String	是	工单发起人名称
deal_group_name	String	否	工单受理技能组名称
deal_agentid	String	否	工单受理坐席ID
deal_agent_name	String	否	工单受理坐席名称
recordid	String	否	关联记录ID	会话或呼叫ID（工单来源是PC-在线工作台则表示会话ID，若来源是呼叫中心则表示呼叫ID）
userid	String	是	工单关联客户ID
user_nick	String	是	客户昵称
user_name	String	否	客户名称
user_tels	String	否	客户电话	多个电话号码，号码之间采用英文逗号","隔开
user_emails	String	否	客户邮箱	多个邮箱，邮箱之间采用英文逗号","隔开
update_agent_name	String	是	工单更新人名称
create_datetime	String	是	工单创建时间	2018-09-18 10:14:05
update_datetime	String	是	工单更新时间	2018-09-18 10:34:45
file_list	List	否	附件
extend_fields_list	List	否	工单自定义字段
deal_list	List	否	工单全部回复
update_log_list	List	是	工单操作记录
evaluation_datetime	String	否	工单评价时间	2018-09-18 13:00:00
score	Integer	否	评分	1 1星，2 2星，3 3星，4 4星，5 5星
remark	String	否	评语
params_extends_list	List	否	对接字段
create_group_names	String	否	创建客服组
closed_time	Long	否	关闭工单时间
first_accept_time	Long	否	首次响应时间

extend_fields_list集合：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_name	String	是	自定义字段名称
field_type	String	是	自定义字段类型	1单行文本，2多行文本，3日期，4时间，5 数值，6下拉列表，7复选框，8单选框
field_text	String	否	选择型字段选项文本值
field_value	String	是	自定义字段值
field_sortno	Integer	是	排序字段	数值越小，排的越靠前

params_extends_list集合：

参数	类型	必填	名称
fieldid	String	是	对接字段ID
field_name	String	是	对接字段名称
field_value	String	是	对接字段值

deal_list集合：

参数	类型	必填	名称	备注
replyid	String	是	回复ID
reply_title	String	是	回复标题
reply_content	String	否	回复内容
reply_type	String	是	回复类型	0 所有人可见 1 仅坐席所见
reply_datetime	String	是	回复时间	2018-09-18 10:34:45
start_type	String	是	回复人类型	0 坐席 1 客户
update_user_name	String	是	回复人名称
face_img	String	是	回复人头像
file_list	List	否	回复附件

update_log_list集合：

参数	类型	必填	名称	备注
update_title	String	是	操作记录标题
update_content	String	否	操作记录内容
log_from	String	是	操作记录来源	1 页面操作，2 流转触发器，3 定时触发器
update_datetime	String	是	操作记录时间	2018-09-18 10:34:45
start_type	String	是	操作人类型	0 坐席 1 客户
update_agent_name	String	是	操作人名称
face_img	String	是	操作人头像

file_list集合：

参数	类型	必填	名称
file_name	String	是	附件名称
file_url	String	是	附件路径
file_type	String	是	附件类型

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' -dhttps://www.sobot.com/api/ws/5/ticket/get_ticket_by_id?ticketid=ebe6a8b6bcf840418b8e58d123262945

返回示例：

{
    "item": {
        "companyid": "acb290d666814d65834c70073aed65f2",
        "create_datetime": "2018-09-18 10:14:05",
        "deal_group_name": "",
        "deal_list": [
            {
                "face_img": "https://sobot.oss-cn-beijing.aliyuncs.com/console/acb290d666814d65834c70073aed65f2/userImage/201801151617381.PNG",
                "file_list": [
                    {
                        "file_name": "微信图片_20190528114613.jpg",
                        "file_type": "jpg",
                        "file_url": "https://sobot.oss-cn-beijing.aliyuncs.com/console/acb290d666814d65834c70073aed65f2/ticket/微信图片_20190528114613_1568614560169.jpg"
                    }
                ],
                "reply_content": "<p>343</p>",
                "reply_datetime":"2018-09-18 10:34:45",
                "reply_title": "回复 北京客户 ",
                "reply_type": "0",
                "start_type": "0",
                "update_user_name": "智齿测试12",
                "replyid": "c11897076adc4dd98f7a64f026fc2632"
            }
        ],
        "deal_agent_name": "智齿测试12",
        "extend_fields_list": [
            {
                "field_name": "下拉列表",
                "fieldid": "3ceef648f3d6412abdf8fd6aac5db9f3",
                "field_type": "6",
                "field_text": "999",
                "field_value": "540264609760473"
            },
            {
                "field_name": "时间",
                "fieldid": "4e1e6b21b433461d9bac2cee6d3297d1",
                "field_type": "4",
                "field_text": "",
                "field_value": "00:00"
            },
            {
                "field_name": "测试234",
                "fieldid": "d1dc7e1e13794cf1a936d74b76c4ecc0",
                "field_type": "1",
                "field_text": "",
                "field_value": "455445"
            }
        ],
        "file_list": [],
        "start_name": "北京客户",
        "start_type": "1",
        "ticket_code": "1534758910",
        "ticket_content": "<p>测试用</p>",
        "ticket_from": "1",
        "ticket_level": "0",
        "ticket_status": "2",
        "ticket_title": "客户留言-北京客户",
        "ticket_typeid": "c6aef17dca6b4ee5b9dc4206d8162abt",
        "ticket_type_name": "咨询/咨询1/咨询2",
        "ticketid": "d6aef19dca6b4ee5b9dc4206d8162105",
        "update_log_list": [
            {
                "face_img": "https://sobot.oss-cn-beijing.aliyuncs.com/console/acb290d666814d65834c70073aed65f2/userImage/201801151617381.PNG",
                "log_from": "1",
                "start_type": "0",
                "update_content": "{\"回复\":\"343\",\"回复附件\":\"微信图片_20190528114613.jpg\"}",
                "update_agent_name": "智齿测试12",
                "update_datetime":"2018-09-18 10:34:45",
                "update_title": "工单更新"
            },
            {
                "face_img": "https://img.sobot.com/console/common/face/user.png",
                "log_from": "1",
                "start_type": "1",
                "update_content": "{\"工单分类\":\"咨询/咨询1/咨询2\",\"工单标题\":\"客户留言-北京客户\",\"问题描述\":\"测试用\",\"自定义字段\":\"下拉列表：;复选：;测试2：;单选：;测试1：\",\"优先级\":\"低\",\"工单状态\":\"尚未受理\"}",
                "update_datetime": "2018-09-18 10:14:05",
                "update_title": "工单创建"
            }
        ],
        "update_datetime": "2018-09-18 10:34:45",
        "user_nick": "北京客户",
        "userid": "fdd41fb55c4f41e4afa4906064deced3",
		"evaluation_datetime":"2018-09-18 09:15:55",
	    "score":1,
		"remark":"问题解决地非常快，果断好评"

        "update_datetime": "2018-09-18 10:34:45",
        "user_nick": "北京客户",
        "userid": "fdd41fb55c4f41e4afa4906064deced3"
    },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.16、查询工单统计概览

接口说明：

获取某个时间段工单对应的数量。

请求方式：

GET

请求地址：

/api/ws/5/ticket/get_ticket_data

请求参数：

参数	类型	必填	名称	备注
start_datetime	String	是	开始时间	2019-09-18 00:00:00
end_datetime	String	是	结束时间	2019-09-18 23:59:59

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
item	Object	是	返回对象

item对象：

参数	类型	必填	名称	备注
unassigned_ticket_num	String	是	未分配工单数量
unsolved_ticket_num	String	是	未解决工单数量

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/get_ticket_data?start_datetime= 2019-09-18 00:00:00&end_datetime=2019-09-18 23:59:59

返回示例：

 {
    "item": {
        "unassigned_ticket_num": "2",
        "unsolved_ticket_num": "3"
    },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.17、查询工单坐席工作量

接口说明：

获取某个时间段工单坐席工作量。

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_agent_jobs

请求参数：

参数	类型	必填	名称	备注
start_datetime	String	是	开始时间	2019-09-18 00:00:00
end_datetime	String	是	结束时间	2019-09-18 23:59:59

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	是	返回集合

Items集合：

参数	类型	必填	名称
agentid	String	是	坐席ID
agent_name	String	是	坐席名称
deal_ticket_num	String	是	处理工单数量
ticket_end_rate	String	是	工单完结率

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_agent_jobs?start_datetime= 2019-09-18 00:00:00&end_datetime=2019-09-18 23:59:59

返回示例：

 {
    "items": [
        {
            "deal_ticket_num": "1",
            "agent_name": "智齿测试12",
            "agentid": "efcfda336b5d4caeb4fd71392c54b5c9",
            "ticket_end_rate": "0.0"
        },
        {
            "deal_ticket_num": 0,
            "agent_name": "ming",
            "agentid": "0a37c8156d094311890e48fbc06501c4",
            "ticket_end_rate": "0.0"
        }
    ],
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

# 2.18、查询工单消息推送异常数据

接口说明：

返回工单消息推送失败的数据

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_ticket_push_fail_infos

请求参数：

参数	类型	必填	名称	备注
start_datetime	String	是	开始时间	2020-04-08 00:00:00
end_datetime	String	是	结束时间	2020-04-08 23:59:59
page_no	Integer	是	当前页数	默认第一页
page_size	Integer	是	当前页显示条数	默认每页显示15条，最大每页显示50条

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	是	返回集合
page_no	Integer	是	当前页数
page_size	Integer	是	当前页显示条数
page_count	Integer	是	总页数
total_count	Integer	是	总条数

items对象：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID
companyid	String	是	公司ID
ticket_title	String	是	工单标题
ticket_content	String	是	问题描述
ticket_code	String	是	工单编号
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_type_name	String	是	工单分类名称	显示格式：一级/二级/三级
deal_agentid	String	否	受理坐席ID
deal_agent_name	String	否	受理坐席名称
deal_groupid	String	否	受理技能组ID
deal_group_name	String	否	受理技能组名称
reply_content	String	否	工单回复内容
update_datetime	String	是	工单更新时间	2020-04-08 13:00:00
update_agent_name	String	是	操作坐席名称
userid	String	是	工单关联客户ID
user_nick	String	是	客户昵称
user_name	String	否	客户名称
user_tels	String	否	客户电话	多个电话号码，号码之间采用英文逗号,隔开
user_emails	String	否	客户邮箱	多个邮箱，邮箱之间采用英文逗号,隔开
recordid	String	否	工单关联记录ID	工单来源是呼叫中心这个是呼叫记录ID，来源是在线工作台-PC客服提交这个是会话记录ID
file_str	String	否	附件路径
voice_url	String	否	录音文件
hope_accept_time	String	否	SLA规定的首次响应时间	2020-04-08 13:00:00
hope_complete_time	String	否	SLA规定的首次解决时间	2020-04-08 13:00:00
is_reminder	String	是	催单信息标识	是否催单信息 0 否 1 是
reminder_agentid	String	否	催单坐席id
reminder_agent_name	String	否	催单坐席名称
reminder_remark	String	否	催单备注
reminder_time	String	否	催单时间	具体的时间点，例如2020-04-20 12:35:30
partnerid	String	否	关联客户对接id
extend_fields_list	List	否	工单自定义字段

extend_fields_list集合：

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_name	String	是	自定义字段名称
field_type	String	是	自定义字段类型	1单行文本，2多行文本，3日期，4时间，5 数值，6下拉列表，7复选框，8单选框
field_text	String	否	选择型字段选项文本值
field_value	String	是	自定义字段值

请求示例：

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_ticket_push_fail_infos
?start_datetime= 2020-04-08 00:00:00&end_datetime=2020-04-08 23:59:59

返回示例：


{
 "items": [
      {
        "companyid": "40d8940f1e854642b41f7c21f790b8e3",
        "deal_agent_name": "",
        "deal_agentid": "",
        "deal_group_name": "",
        "deal_groupid": "",
        "extend_fields_list": [],
        "file_str": "",
        "hope_accept_time": "",
        "hope_complete_time": "",
        "partnerid": "test_lily",
         "recordid": "",
        "ticket_code": "20200326000002",
        "ticket_content": "<p>lily的工单中心</p>",
        "ticket_from": "0",
        "ticket_level": "0",
        "ticket_status": "0",
        "ticket_title": "停服务后创建工单",
        "ticketid": "4c38229b83bd4101a09612b9ac26baf7",
        "update_agent_name": "小丽",
        "user_name": "VIP客户",
        "userid": "11a1e8a4a8e9480a8f409dc2a130431f",
        "is_reminder": "0",
        "voice_url": ""
      },
      {
        "companyid": "40d8940f1e854642b41f7c21f790b8e3",
        "deal_agent_name": "在线203",
        "deal_agentid": "587d3293ff794d7785a33d9a0695ea32",
        "deal_group_name": "",
        "deal_groupid": "",
        "extend_fields_list": [
          {
            "field_name": "RIO--下拉列表",
            "field_text": "77",
            "field_type": "6",
            "field_value": "121",
            "fieldid": "6cb4450292d34720877f6083514ca6fb"
          },
            {
            "field_name": "时间",
            "field_type": "4",
            "field_value": "09:00",
            "fieldid": "22696682739c4fd7a68094eeed34a8a9"
          }
         ],
         "file_str": "",
         "hope_accept_time": "",
         "hope_complete_time": "",
         "partnerid": "sdk284",
         "recordid": "",
         "ticket_code": "20200326000001",
         "ticket_content": "三个好感动",
         "ticket_from": "4",
         "ticket_level": "0",
         "ticket_status": "1",
         "ticket_title": "重复点击回复",
         "ticketid": "2831ceace38c45649840374a08d321bd",
         "update_agent_name": "小丽",
         "userid": "9a4da303f00b4f5295459070edb6b34a",
         "voice_url": ""
        },
        {
           "ticketid":"23ddfbcd7de8472c93e4385d6195dfd5",
           "companyid":"40d8940f1e854642b41f7c21f790b8e3",
           "ticket_code": "202004200000001",
           "is_reminder": "1",
           "reminder_agentid":"587d3293ff794d7785a33d9a0695ea32",
           "reminder_agent_name": "在线203",
           "reminder_remark": "催单信息",
           "reminder_time": "2020-04-20 12:35:30",
           "update_datetime": "2020-04-20 12:35:30"
        }
    ],
    "page_count": 1,
    "page_no": 1,
    "page_size": 15,
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "total_count": 2
}

# 2.19、离线数据文件下载接口

接口说明：

接口类型：主动调用接口。

接口作用：可通过调用该接口来获取工单业务模块的原始数据，可用于企业对数据归档或做数据分析等。

注意：若需要使用该接口下载离线数据，需提前通知智齿进行数据整理安排，否则无法下载到数据。

请求方式：

POST

请求地址：

https://www.sobot.com/api/wb/5/data/export_data

请求参数：

参数	类型	必填	名称	备注
task_type	String	是	任务类型	此处获取工单模块的数据需要传固定值:6
date	String	是	日期	日期（yyyy-MM-dd）

返回参数：

字段	数据类型	描述
updateTime	Long	工单更新时间
startType	Integer	工单发起人类型，0 坐席；1客户
startName	String	工单发起人姓名
companyId	String	工单所属公司ID
ticketId	String	工单ID
ticketCode	String	工单编号
ticketTitle	String	工单标题
ticketContent	String	问题描述
ticketStatus	Integer	工单状态，0未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticketLevel	Integer	工单级别，0低，1中，2高，3紧急
ticketFrom	Integer	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
createTime	Long	工单创建时间
dealGroupId	String	受理客服组ID
dealGroupName	String	受理客服组名称
dealUserId	String	受理客服ID
dealUserName	String	受理客服名称
hopeAcceptTime	String	SLA规定的首次响应时间,例如2019-11-11 13:01:30
hopeCompleteTime	String	SLA规定的首次解决时间,例如2019-11-11 13:05:00
customerId	String	关联客户ID
nick	String	关联客户昵称
uname	String	关联客户真实姓名
tel	String	关联客户电话,多个电话之间以分号分隔
email	String	关联客户邮箱,多个邮箱之间以分号分隔
ticketTypeName	String	工单分类
recordId	String	记录ID
copyUser	String	抄送客服 ID
resultList	List	工单自定义字段
dealList	List	工单全部回复
fileStr	String	所有附件路径，以英文分号隔开
updateLogList	List	工单操作记录

resultList：工单自定义字段

字段	数据类型	描述
fieldId	String	自定义字段ID
fieldType	Integer	自定义字段类型；1单行文本 2多行文本 3日期 4时间 5数值 6下拉列表 7复选框 8 单选框
fieldVariable	String	自定义字段的参数名
title	String	自定义字段名称
value	String	自定义字段值
text	String	选择型字段选项文本值

dealList：工单全部回复

字段	数据类型	描述
replyTitle	String	回复标题
replyContent	String	回复内容
replyType	String	回复类型，“0” 所有人可见； “1” 仅坐席可见
replyTime	Long	回复时间
startType	Integer	回复人类型；0 坐席；1 客户
updateUserName	String	回复人名称
updateUserId	String	回复人ID
fileList	List	回复附件列表

fileList：回复附件列表

字段	数据类型	描述
fileName	String	附件名称
fileUrl	String	附件路径
fileType	String	附件类型

updateLogList：工单操作记录

字段	数据类型	描述
updateTitle	String	操作记录标题
updateContent	String	操作记录内容
updateTime	Long	操作记录时间
startType	Integer	操作人类型；0 坐席，1 客户
updateServiceName	String	操作人名称

请求示例：

curl https://www.sobot.com/api/wb/5/data/export_data 
-X POST 
-H 'content-type: application/json' 
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{
        "task_type":  "6",
        "date": "2019-11-05",
    }'

返回示例：

{
    "ticketTitle": "测试工单",
    "dealUserId": "27a3f720bdd8446ea243017f1d2b626f",
    "ticketLevel": 0,
    "dealUserName": "张三",
    "startType": 0,
    "updateLogList": [
        {
            "startType": 0,
            "updateTime": 1591847016,
            "updateServiceName": "张三",
            "updateContent": "{"工单分类":"1","工单标题":"测试工单","问题描述":"测试附件存储日志","问题描述附件":"夜晚.jpg","自定义字段":"callid：驱蚊器二群;公司id：驱蚊器翁;问题发生频次：单个坐席偶发;在线会话id 附截图：驱蚊器;app&sdk 版本号，反馈机型；：驱蚊器;是否为软电话：否;问题类型：智齿app","优先级":"低","工单状态":"尚未受理"}",
            "updateTitle": "工单创建"
        },
        {
            "startType": 0,
            "updateTime": 1591847020,
            "updateServiceName": "张三",
            "updateContent": "{"受理客服":"张三"}",
            "updateTitle": "工单更新"
        },
        {
            "startType": 0,
            "updateTime": 1591847020,
            "updateServiceName": "张三",
            "updateContent": "{"受理客服":"张三"}",
            "updateTitle": "工单更新"
        },
        {
            "startType": 0,
            "updateTime": 1591847352,
            "updateServiceName": "张三",
            "updateContent": "{"回复附件":"沙漠绿洲.jpg,云.jpg"}",
            "updateTitle": "工单更新"
        },
        {
            "startType": 0,
            "updateTime": 1591850735,
            "updateServiceName": "张三",
            "updateContent": "{"工单状态":"已关闭"}",
            "updateTitle": "工单更新"
        }
    ],
    "updateTime": 1591850735,
    "dealGroupName": "",
    "dealList": [
        {
            "replyTime": 1591847016,
            "replyType": "0",
            "updateUserId": "27a3f720bdd8446ea243017f1d2b626f",
            "updateUserName": "张三",
            "startType": 0,
            "replyContent": "<p>测试附件存储日志</p>",
            "fileList": [
                {
                    "fileName": "夜晚.jpg",
                    "fileUrl": "https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/夜晚_1591846971492.jpg",
                    "fileType": "jpg"
                }
            ]
        },
        {
            "replyTime": 1591850735,
            "replyType": "1",
            "updateUserId": "27a3f720bdd8446ea243017f1d2b626f",
            "updateUserName": "张三",
            "startType": 0,
            "replyTitle": "回复 张三 zhangjc@sobot.com",
            "fileList": []
        },
        {
            "replyTime": 1591847352,
            "replyType": "1",
            "updateUserId": "27a3f720bdd8446ea243017f1d2b626f",
            "updateUserName": "张三",
            "startType": 0,
            "replyTitle": "回复 张三 zhangjc@sobot.com",
            "fileList": [
                {
                    "fileName": "云.jpg",
                    "fileUrl": "https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/云_1591847350898.jpg",
                    "fileType": "jpg"
                },
                {
                    "fileName": "沙漠绿洲.jpg",
                    "fileUrl": "https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/沙漠绿洲_1591847347206.jpg",
                    "fileType": "jpg"
                }
            ]
        }
    ],
    "nick": "啊",
    "companyId": "651b00ce4b5a43969b63ac934e4f0ba2",
    "ticketFrom": 0,
    "createTime": 1591847016,
    "ticketStatus": 99,
    "customerId": "570f8e431f9843239ed083f748015412",
    "ticketContent": "<p>测试附件存储日志</p>",
    "dealGroupId": "",
    "fileStr": ";https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/夜晚_1591846971492.jpg;https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/夜晚_1591846971492.jpg;https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/云_1591847350898.jpg;https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/夜晚_1591846971492.jpg;https://img.sobot.com/console/651b00ce4b5a43969b63ac934e4f0ba2/ticket/沙漠绿洲_1591847347206.jpg",
    "ticketCode": 20200611000021,
    "resultList": [
        {
            "fieldId": "271c5b23bd914d81950e68755b7c43b4",
            "fieldType": 1,
            "fieldVariable": "customField15",
            "title": "公司id",
            "value": "驱蚊器翁"
        },
        {
            "fieldId": "411c7ec298de4084aeb1f7cce70c836e",
            "fieldType": 6,
            "fieldVariable": "customField85",
            "text": "单个坐席偶发",
            "title": "问题发生频次",
            "value": "579514320725440"
        },
        {
            "fieldId": "8ed8518cabc641739958d9ec64f069f5",
            "fieldType": 8,
            "fieldVariable": "customField80",
            "text": "否",
            "title": "是否为软电话",
            "value": "575543181142367"
        },
        {
            "fieldId": "63f0aab22a2b4760a2d9d4a58f2ff938",
            "fieldType": 1,
            "fieldVariable": "customField20",
            "title": "callid",
            "value": "驱蚊器二群"
        },
        {
            "fieldId": "f8b00f7f1df948b7b4233ac23bd419bd",
            "fieldType": 6,
            "fieldVariable": "customField97",
            "text": "智齿app",
            "title": "问题类型",
            "value": "587347957556856"
        },
        {
            "fieldId": "6da2c7ee7bd040faa9328fcbf06efd17",
            "fieldType": 1,
            "fieldVariable": "customField99",
            "title": "app&sdk 版本号，反馈机型；",
            "value": "驱蚊器"
        },
        {
            "fieldId": "5fe20ad11906453f8db291d834e3d130",
            "fieldType": 1,
            "fieldVariable": "customField102",
            "title": "在线会话id 附截图",
            "value": "驱蚊器"
        },
        {
            "fieldId": "01c370c4eac64be7a7b784208e9d15ae",
            "fieldType": 10,
            "fieldVariable": "customField120",
            "title": "333",
            "value": "[[{"id":"9521446615114883a8a091f41a6b576d","text":"","value":""}]]"
        }
    ],
    "ticketId": "c3f25978eb5d4d4e95f02f1db570a1b7",
    "startName": "张三"
}

# 2.20、查询工单列表

接口说明：

接口说明：按照工单创建时间段查询工单列表信息。

请求方式：

GET

请求地址：

/api/ws/5/ticket/query_tickets

请求参数：

参数	类型	必填	名称	备注
create_start_datetime	String	是	工单创建开始时间	2018-09-18 00:00:00
create_end_datetime	String	是	工单创建结束时间	2018-09-18 23:59:59（查询创建时间段不能大于一年）
ticket_status	String	否	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除多个状态间用英文逗号隔开
ticket_from	String	否	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
ticket_typeid	String	否	工单分类ID
userid	String	否	客户ID
deal_agentid	String	否	受理坐席ID
page_no	Integer	是	当前页数	默认第一页
page_size	Integer	是	当前页显示条数	默认每页显示15条，最大每页显示50条

返回参数：

参数	类型	必填	名称
ret_code	String	是	返回编码
ret_msg	String	是	返回信息
items	List	否	返回集合
page_no	Integer	是	当前页数
page_size	Integer	是	当前页显示条数
page_count	Integer	是	总页数
total_count	Integer	是	总条数

items集合：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID
ticket_title	String	是	工单标题
ticket_content	String	是	问题描述
ticket_code	String	是	工单编号
ticket_from	String	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言
ticket_level	String	是	工单优先级	0低，1中，2高，3紧急
ticket_status	String	是	工单状态	0尚未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
start_type	String	是	工单发起人类型	0坐席，1客户
start_name	String	是	工单发起人名称
ticket_type_name	String	是	工单分类名称	显示格式：一级/二级/三级
deal_agent_name	String	否	受理坐席名称
deal_group_name	String	否	受理技能组名称
create_datetime	String	是	工单创建时间	2018-09-18 12:00:00
update_datetime	String	是	工单更新时间	2018-09-18 13:00:00
user_nick	String	是	客户昵称
user_name	String	否	客户名称
user_tels	String	否	客户电话	多个电话号码，号码之间采用英文逗号","隔开
user_emails	String	否	客户邮箱	多个邮箱，邮箱之间采用英文逗号","隔开
evaluation_datetime	String	否	工单评价时间	2018-09-18 13:00:00
score	Integer	否	评分	1 1星，2 2星，3 3星，4 4星，5 5星
remark	String	否	评语

请求示例

curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' https://www.sobot.com/api/ws/5/ticket/query_tickets? create_start_datetime=2018-09-18 00:00:00&create_end_datetime=2018-09-18 23:59:59

返回示例：
 {
    "items": [
        {
            "create_datetime": "2018-09-18 09:10:05",
            "deal_group_name": "",
            "deal_agent_name": "",
            "start_name": "测试标签",
            "start_type": "1",
            "ticket_code": "20190912000007",
            "ticket_content": "测试工单",
            "ticket_from": "1",
            "ticket_level": "0",
            "ticket_status": "1",
            "ticket_title": "测试工单",
            "ticket_type_name": "售后",
            "ticketid": "b6dacd72a5cf4e2999e78a18a9126c72",
            "update_datetime":"2018-09-18 09:15:55",
            "user_nick": "测试标签",
			  "evaluation_datetime":"2018-09-18 09:15:55",
			  "score":1,
			  "remark":"问题解决地非常快，果断好评"
        },
        {
            "create_datetime":"2018-09-18 08:14:05",
            "deal_group_name": "",
            "deal_agent_name": "",
            "start_name": "测试标签",
            "start_type": "1",
            "ticket_code": "20190912000006",
            "ticket_content": "测试工单",
            "ticket_from": "1",
            "ticket_level": "0",
            "ticket_status": "1",
            "ticket_title": "测试工单",
            "ticket_type_name": "咨询/咨询1/咨询2",
            "ticketid": "266a341702ef40d595915a3c19676745",
            "update_datetime":""2018-09-18 08:20:05"",
            "user_nick": "测试标签"
        },
        {
            "create_datetime":"2018-09-18 07:34:25",
            "deal_group_name": "123",
            "deal_agent_name": "ming",
            "start_name": "智齿测试12",
            "start_type": "0",
            "ticket_code": "20190912000003",
            "ticket_content": "<p>34433434</p>",
            "ticket_from": "0",
            "ticket_level": "0",
            "ticket_status": "0",
            "ticket_title": "4343",
            "ticket_type_name": "其他",
            "ticketid": "f294176887284c5597794c636d5a1bfe",
            "update_datetime":"2018-09-18 07:54:35",
            "user_emails": "wangxun0104@hotmail.com",
            "user_name": "王迅",
            "user_nick": "王迅",
            "user_tels": "18280240680"
        }
    ],
    "page_count": 1,
    "page_no": 1,
    "page_size": 15,
    "ret_code": "000000",
    "ret_msg": "操作成功",
    "total_count": 3
}

# 2.21、工单回复信息删除

接口说明：

接口说明：删除工单的回复信息。

请求方式：

POST

请求地址：

/api/ws/5/ticket/del_reply_infos

请求参数：

参数	类型	必填	名称	备注
ticketid	String	是	工单ID
replyid	String	是	工单回复ID	删除工单回复信息对应的回复记录ID
agentid	String	否	操作坐席ID

返回参数：

参数	类型	必填	名称	备注
ret_code	String	是	返回编码
ret_msg	String	是	返回信息

请求示例：

curl https://www.sobot.com/api/ws/5/ticket/del_reply_infos -X POST -H 'content-type: application/json' 
-H 'token:4ac37cb2e9c740dba4b75a34d5358802' 
-d '{
        "ticketid":" e1ccfd1725074f868d9e14dde5853d3d",
        "agentid":"0a37c8156d094311890e48fbc06501c4",
        "replyid":"c11897076adc4dd98f7a64f026fc2632"
    }'

返回示例：

{
   "ret_code": "000000",
   "ret_msg": "操作成功"
}

# 3、工单消息转发

接口说明：

推送工单信息

访问方式：

详见回调消息参数说明，点击此处跳转

# 3.1、工单信息

# 3.1.1content对象

参数	类型	必填	名称	备注
companyid	String	是	企业ID	适用一个公司多个超管帐号或者多个分公司需要分别统计的情况
ticketid	String	是	工单ID
ticket_code	String	是	工单编号
ticket_title	String	是	工单标题	最大长度为100
ticket_content	String	是	问题描述	最大长度为5000
ticket_type_name	String	是	工单分类名称	多级分类之间用/分隔
ticket_status	Integer	是	工单状态	0未受理，1受理中，2等待回复，3已解决，99已关闭，98已删除
ticket_level	Integer	是	工单级别	0低，1中，2高，3紧急
ticket_from	Integer	是	工单来源	0工单中心，1 PC客户留言，2 H5客户留言，3 微信公众号客户留言，4 APP客户留言，6 PC-在线工作台，7客户中心，8呼叫中心，9微信公众号-在线工作台，10 H5-在线工作台，11 APP-在线工作台，12 邮件留言，13语音留言，14微信小程序-在线工作台，15企业微信-在线工作台，16微信小程序客户留言，17企业微信客户留言，18批量导入，19微信客服，20企业微信-智客
file_str	String	否	附件路径	多个附件之间用分号分隔
deal_groupid	String	否	受理客服组ID
deal_group_name	String	否	受理客服组名称
deal_agentid	String	否	受理客服ID
deal_agent_name	String	否	受理客服名称
copy_agent	String	否	抄送客服
hope_accept_time	String	否	SLA规定的首次响应时间	具体的时间点，例如2019-11-11 13:01:30
hope_complete_time	String	否	SLA规定的首次解决时间	具体的时间点，例如2019-11-11 13:05:00
userid	String	是	关联客户ID
user_nick	String	是	关联客户昵称
user_name	String	否	关联客户真实姓名
user_tels	String	否	关联客户电话	多个电话之间以分号分隔
user_emails	String	否	关联客户邮箱	多个邮箱之间以分号分隔
partnerid	String	否	关联客户对接ID
recordid	String	否	记录ID	工单来源是呼叫中心这个是呼叫记录ID，来源是在线工作台-PC客服提交这个是会话记录ID
update_name	String	是	更新人名称	当前编辑工单或回复工单的操作人姓名
update_time	String	是	更新时间	当前编辑工单保存或回复工单提交的时间具体的时间点，例如2019-11-11 12:00:30
create_time	String	是	创建时间	工单的创建时间，例如2019-11-11 12:00:30
reply_content	String	否	回复内容	回复工单的内容
is_reminder	String	是	催单信息标识	是否催单信息 0 否 1 是
reminder_agentid	String	否	催单坐席id
reminder_agent_name	String	否	催单坐席名称
reminder_remark	String	否	催单备注
reminder_time	String	否	催单时间	具体的时间点，例如2020-04-20 12:35:30
extend_fields_list	List	否	工单自定义字段集合
partner_fields_list	List	否	工单对接型字段集合
reply_type	String	否	0所有人可见 1 仅坐席可见
start_type	String	否	0 坐席 1客户
del_reply	String	是	删除回复标识	0 否 1 是
del_reply_agentid	String	是	删除回复的坐席id
del_reply_agent_name	String	是	删除回复的坐席名称
del_reply_time	String	是	删除回复的时间
replyid	String	是	被删除回复的回复ID
reply_time	String	是	被删除回复的回复时间
reply_name	String	是	被删除回复的回复人名称
reply_obj	String	是	被删除回复的回复对象

extend_fields_list集合

参数	类型	必填	名称	备注
fieldid	String	是	自定义字段ID
field_type	String	是	自定义字段类型	1单行文本 2多行文本 3日期 4时间 5数值 6下拉列表 7复选框 8 单选框
field_name	String	是	自定义字段名称
field_value	String	是	自定义字段值
field_text	String	是	选择型字段选项文本值

partner_fields_list集合

参数	类型	必填	名称
fieldid	String	是	字段ID
field_name	String	是	字段名称
fidle_value	String	是	字段值

# 3.1.2返回内容

参数	类型	必填	名称	备注
sys_code	String	是	产品编码	4
type	String	是	消息类型	ticket
content	List	是	消息内容

# 3.1.3返回示例

非催单信息

{
    "sys_code": "4",
    "type": "ticket",
    "content": [
        {
            "companyid": "5cc2c708202d4defaf72d4bcac362a55",
            "ticketid": "56b7954e8ff1428ea39cd5a8136de9e1",
            "ticket_code": "20191111000001",
            "ticket_title": "测试工单",
            "ticket_content": "测试工单",
            "ticket_type_name": "咨询",
            "ticket_status": "0",
            "ticket_level":"0",
            "ticket_from":"0",
            "file_str": "",
            "deal_groupid": "5436dc5288b645188aedc2a21f66a4ba",
            "deal_group_name": "咨询客服组",
            "deal_agentid": "0a37c8156d094311890e48fbc06501c4",
            "deal_agent_name": "ming",
            "copy_agent": "",
            "hope_accept_time": "2019-11-11 13:01:30",
            "hope_complete_time": "2019-11-11 13:05:00",
            "userid": "3dff300e008f4c4a8c399751ddb7b8cc",
            "user_nick": "北京客户",
            "partnerid": "",
            "recordid": "",
            "reply_content": "回复工单",
            "update_name": "客服一",
            "update_time": "2019-11-11 12:00:30",
            "create_time": "2019-11-11 12:00:30",
            "is_reminder": "0",
            "reply_type": "0",
            "start_type": "0",
            "extend_fields_list": [ 
                {
                    "fieldid": "1",
                    "field_type": 1,
                    "field_text": "",
                    "field_name": "微信",
                    "field_value": "21332112"
                },
                {
                    "fieldid": "4",
                    "field_type": 6,
                    "field_text": "下拉一",
                    "field_name": "下拉列表",
                    "field_value": "500862697708553"  
                }
            ],
            "partner_fields_list": [ 
                {
                    "fieldid": " a974d9ac9cbc43388f80e6e8c968ddc9 ",
                    "field_value ": " http://www.sobot.com",
                    "field_name": "商品链接"
                },
                {
                    "fieldid": " 1b17bbfa1e48447ebfce11a66ff5d802 ",
                    "field_name": "商品备注",
                    "field_value": " 1500元"          
                }
            ]
        }
    ]
}

催单信息

{
    "sys_code": "4",
    "type": "ticket",
    "content": [
        {
            "companyid": "5cc2c708202d4defaf72d4bcac362a55",
            "ticketid": "56b7954e8ff1428ea39cd5a8136de9e1",
            "ticket_code": "20191111000001",
            "is_reminder": "1",
            "reminder_remark": "回复工单",
            "reminder_agentid": "0a37c8156d094311890e48fbc06501c4",
            "reminder_agent_name": "客服一",
            "reminder_time": "2020-04-20 12:00:30",
            "update_time": "2020-04-20 12:00:30"
        }
    ]
}

删除回复信息

{
    "sys_code": "4",
    "type": "ticket",
    "content": [
        {
            "companyid": "5cc2c708202d4defaf72d4bcac362a55",
            "ticketid": "48156b2a93154bd19edeb45245018d6e",
            "ticket_code": "20201221000001",
            "del_reply": "1",
            "del_reply_agentid": "0a37c8156d094311890e48fbc06501c4",
            "del_reply_agent_name": "客服一",
            "del_reply_time": "2020-12-21 12:00:30",
            "replyid": "0a37c8156d094311890e48fbc07891a4",
            "reply_type": "0",
            "reply_name": "工单客服",
            "reply_time": "2020-12-21 10:00:30",
            "reply_obj": "工单客服二",
            "reply_content": "测试"
        }
    ]
}

# 请求响应示例

按此响应示例对接可进行消息确认，便于双方统计到的数据进行对比

 { 
     "data":{ 
        "receiveTime":"20191209115658" 
     }, 
     "retCode":"000000", 
     "retMsg":"数据接收成功" 
}
//retCode返回000000时，表示数据接收成功 retMsg 和 data 为可选字段，备用，可以为空，例如: { "data":{}, "retCode":"000000", "retMsg":"" }

# 4、错误编码

# 4.1、操作成功

业务操作成功。

错误编码	错误说明
000000	操作成功（除此编码以外的编码为错误编码）

# 4.2、系统异常

系统服务异常。

错误编码	错误说明
900001	token为空
900002	token已失效，请重新获取
900003	signature错误
900004	没有找到公司的api配置信息
999999	系统未知异常

# 4.3、业务异常

业务异常。

错误编码	错误说明
400001	创建时间不能为空
400002	创建结束时间不能小于创建开始时间
400003	查询创建时间段不能超过一个月
400004	请求参数不能为空
400005	时间格式不正确
400006	操作坐席ID不能为空
400007	操作坐席ID不正确
400008	工单分类ID不能为空
400009	工单状态不能为空
400010	工单来源不能为空
400011	工单级别不能为空
400012	技能组ID不能为空
400013	受理客服组与受理客服不匹配
400014	请求失败
400015	开始时间不能为空
400016	结束时间不能小于开始时间
400017	更新时间不能为空
400018	更新结束时间不能小于更新开始时间
400019	查询更新时间段不能超过一个月
400020	工单信息不存在
400021	工单回复信息不存在

← 电商平台客户中心 →