<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

    請求地址:

    http://www.gene-tech.cn/api/interceptor/5/quality/call_result

    請求參數:

    參數 類型 必填 名稱 備注
    start_datetime String 開始時間 示例:2018-07-10 00:00:00
    end_datetime String 結束時間 示例: 2018-07-10 00:00:00
    page_no Integer 起始頁
    page_size Integer 每頁顯示條數 默認每頁15條

    返回參數:

    參數 類型 必填 名稱 備注
    ret_code String 返回編碼
    ret_msg String 返回信息
    items List 對象列表
    page_count Integer 共幾頁
    page_no Integer 起始頁
    page_size Integer 每頁條數 每頁展示的條數
    total_count Integer 數據條數 總共的數據條數

    items對象

    參數 類型 必填 名稱 備注
    agentid String 坐席id
    agent_name String 坐席名稱
    agent_email String 坐席郵箱
    call_start_datetime String 通話開始時間
    call_log_jestid String 通話id
    quality_datetime String 質檢時間
    total_score_max String 質檢滿分
    standard_score_max String 質檢標準分滿分
    pulse_max String 質檢加分項滿分
    minus_max String 質檢減分項滿分
    total_score String 質檢得分
    standard_score String 質檢標準分得分
    pulse String 質檢加分項得分
    minus String 質檢減分項得分

    請求示例:

    curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' http://www.gene-tech.cn/api/interceptor/5/quality/call_result?start_datetime=2019-10-22 00:00:00&end_datetime=2019-11-10 00:00:00&page_no=1&page_size=15
    

    返回示例:

    {
        "items": [
            {
                "standard_score_max": "123.5",
                "pulse_max": "22.0",
                "minus": "0.0",
                "agent_email": "132@sobot.com",
                "qualify_time": "1554971786077",
                "call_start_datetime": "1553594283000",
                "agent_name": "testxx",
                "total_score": "132",
                "call_log_jestid": "b212d432-ea8f-4701-9637-d01c8a5d9945",
                "total_score_max": "11.0",
                "pulse": "122.0",
                "agentid": "2856580f156a4f9ea73dd4e9ac86896e",
                "standard_score": "10.0",
                "minus_max": "33.0"
            }],
        "page_count": 1,
        "page_no": 1,
        "page_size": 15,
        "ret_code": "000000",
        "ret_msg": "操作成功",
        "total_count": 1
    }
    

    # 2.3、獲取在線質檢結果

    接口說明

    接口類型:主動調用接口。

    接口作用:獲取在線質檢結果

    請求方式:

    GET

    請求地址:

    http://www.gene-tech.cn/api/interceptor/5/quality/chat_result

    請求參數:

    參數 類型 必填 名稱 備注
    start_datetime String 開始日期 示例:2018-07-10
    end_datetime String 結束日期 示例:2018-07-10
    page_no Integer 當前頁碼
    page_size Integer 每頁條數(默認100,最大可傳入10000)

    返回參數:

    參數 類型 必填 名稱 備注
    ret_code String 返回編碼
    ret_msg String 返回信息
    items List 返回對象

    items對象:

    參數 類型 名稱 備注
    chat_start_datetime String 會話開始時間(毫秒)
    update_datetime String 質檢時間
    schemeid String 質檢方案id
    total_score String 質檢方案滿分
    standard_total_score String 質檢標準分滿分
    add_total_score String 質檢加分項滿分
    minus_total_score String 質檢減分項滿分
    quality_score String 質檢得分
    standard_quality_score String 質檢標準分得分
    add_quality_score String 質檢加分項得分
    minus_quality_score String 質檢減分項得分
    agentid String 坐席id
    agent_name String 坐席姓名
    agent_email String 坐席郵箱
    cid String 會話id

    請求示例:

    curl -H 'token:4ac37cb2e9c740dba4b75a34d5358802' http://www.gene-tech.cn/api/interceptor/5/quality/chat_result?start_datetime=2019-10-22 00:00:00&end_datetime=2019-11-10 00:00:00&page_no=1&page_size=15
    

    返回示例:

    {
        "items": [
            {
                "add_quality_score": "20.0",
                "add_total_score": "20.0",
                "chat_start_datetime": "1572851882000",
                "cid": "eca23a4cb2ba45bbab32b6878775cfd2",
                "agent_email": "123456@123.com",
                "minus_quality_score": "-10.0",
                "minus_total_score": "-20.0",
                "quality_score": "210.0",
                "schemeid": "44aea7fd6f57414f98d190bac0ee2d42",
                "agent_name": "在線客服",
                "agentid": "61673ee8d98d4282a95cdad38ffd5f5b",
                "standard_quality_score": "200.0",
                "standard_total_score": "200.0",
                "total_score": "200.0",
                "update_datetime": "1572954558319"
            }
        ],
        "ret_code": "000000",
        "ret_msg": "查詢成功"
    }
    

    # 3、錯誤編碼

    # 3.1、操作成功

    業務操作成功。

    錯誤編碼 錯誤說明
    000000 操作成功(除此編碼以外的編碼為錯誤編碼)

    # 3.2、系統異常

    系統服務異常。

    錯誤編碼 錯誤說明
    900001 token為空
    900002 token已失效,請重新獲取
    900003 signature錯誤
    900004 沒有找到公司的api配置信息
    999999 系統未知異常

    # 3.3、業務異常

    業務異常。

    錯誤編碼 錯誤說明
    700001 公司id不允許為空
    700002 坐席id不允許為空
    700003 客服昵稱不允許為空
    700004 客服真實姓名不允許為空
    700005 客服角色id不允許為空
    700006 客服角色不允許為空
    700007 客服郵箱不允許為空
    700008 客服郵箱格式不正確
    700009 客服郵箱已存在
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>