<small id="aimcq"></small>
  • # 工單中心

    # 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

    請求地址:

    http://www.gene-tech.cn/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 http://www.gene-tech.cn/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' http://www.gene-tech.cn/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' http://www.gene-tech.cn/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 http://www.gene-tech.cn/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' http://www.gene-tech.cn/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. 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 工單來源 1 PC客戶留言,2 H5客戶留言,3 微信公眾號客戶留言,4 APP客戶留言,12 郵件留言,13語音留言,16微信小程序客戶留言,17企業微信客戶留言
    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 http://www.gene-tech.cn/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工單中心,6 PC-在線工作臺,7客戶中心,8呼叫中心,9微信公眾號-在線工作臺,10 H5-在線工作臺,11 APP-在線工作臺 14微信小程序-在線工作臺,15企業微信-在線工作臺
    deal_groupid String 受理技能組ID
    deal_group_name String 受理技能組名稱
    deal_agentid String 受理坐席ID
    deal_agent_name String 受理坐席名稱
    create_agentid String 創建坐席ID
    create_agent_name String 創建坐席名稱
    recordid 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 http://www.gene-tech.cn/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. 1)客戶:客戶可回復所有人
    2. 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 http://www.gene-tech.cn/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. 1)客戶:客戶可回復所有人
    2. 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 http://www.gene-tech.cn/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 http://www.gene-tech.cn/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 http://www.gene-tech.cn/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' http://www.gene-tech.cn/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企業微信客戶留言
    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 工單標題
    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' http://www.gene-tech.cn/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企業微信客戶留言
    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 工單標題
    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' http://www.gene-tech.cn/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企業微信客戶留言
    ticket_level String 工單優先級 0低,1中,2高,3緊急
    ticket_status String 工單狀態 0尚未受理,1受理中,2等待回復,3已解決,99已關閉,98已刪除
    ticket_type_name String 工單分類名稱
    start_type String 工單發起人類型 0坐席,1客戶
    start_name String 工單發起人名稱
    deal_group_name String 工單受理技能組名稱
    deal_agent_name String 工單受理坐席名稱
    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 評語

    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 自定義字段值

    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' -dhttp://www.gene-tech.cn/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_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' http://www.gene-tech.cn/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' http://www.gene-tech.cn/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企業微信客戶留言
    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' http://www.gene-tech.cn/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

    請求地址:

    http://www.gene-tech.cn/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企業微信客戶留言
    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 http://www.gene-tech.cn/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企業微信客戶留言
    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' http://www.gene-tech.cn/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 http://www.gene-tech.cn/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 String 工單狀態 0未受理,1受理中,2等待回復,3已解決,99已關閉,98已刪除
    ticket_level String 工單級別 0低,1中,2高,3緊急
    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企業微信客戶留言
    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
    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客戶

    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",
                "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.gene-tech.cn",
                   "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"
            }
        ]
    }
    

    # 請求響應示例

    按此響應示例對接可進行消息確認,便于雙方統計到的數據進行對比

     { 
         "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 工單回復信息不存在
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>