<small id="aimcq"></small>
  • # 呼叫中心

    # 1、接口聲明

    如果您希望在自己的CRM系統嵌入呼叫中心能力,需要對接智齒呼叫中心能力,在對接前請您閱讀如下對接流程,以便您更好的完成對接。如果只對接基本呼叫能力,預計對接及調試過程1周左右即可完成。

    第一步:獲取第三方用戶接口調用唯一憑證
    請聯系您的售后經理,獲取您企業的如下信息:
    1、companyid(企業id)
    2、appid(第三方用戶接口調用唯一憑證id)
    3、app_key(第三方用戶接口調用唯一憑證密鑰)

    第二步:管理客服賬號、技能組和分機賬號
    在使用呼叫中心能力前,需要完成客服創建、技能組創建、分配客服到技能組以及為客服綁定對應的分機賬號。
    1、名詞解釋
    客服賬號:通過該賬號可以使用呼叫中心。
    技能組:對客服進行分組,可以將不同客服分配到不同技能組;設置技能組是為了更好的進行客服分組管理。如果您在自己的CRM中進行客服管理,可以只設置一個技能組。
    分機賬號:使用呼叫中心時,如果使用SIP話機,則必須為每個客服對應一個固定的SIP話機,請將對應分機賬號與客服進行綁定。分機賬號類似于分機號。注意:同時需要用該分機賬號與分機賬號密碼對SIP話機進行設置,并注冊到智齒呼叫中心平臺。SIP話機我們推薦使用潮流和億聯SIP話機,請與您的售后經理獲取《配置手冊》,如果您使用其他類型的SIP話機,請與售后經理提前溝通。

    2、如何管理?
    第一種,您可以通過超管賬號,登錄智齒客服系統進行管理 1)在設置-客服列表功能中,創建呼叫中心客服賬號; 2)在設置-呼叫中心技能組設置功能中,創建呼叫相關的技能組,并將客服分配到技能組; 3)在設置-話機賬號設置中,實現分機賬號與客服賬號的綁定; 4)通過查詢坐席列表接口、查詢坐席綁定的分機賬號接口,在您的CRM系統中實現賬號的關聯綁定。
    第二種,通過接口創建客服、創建技能組、分配客服到技能組,以及為客服綁定SIP賬號。參見客服管理相關接口、技能組管理接口和分機賬號綁定接口,可以在您的CRM中實現客服賬號創建、技能組創建和分機賬號綁定。

    第三步:使用呼叫中心JS組件對接
    JS組件對接主要提供客服端的對接能力,基于websocket方式進行通信,前端頁面可以直接調用接口實現基礎的客服通話、保持、咨詢、轉接,以及班長監聽等呼叫能力?;贘S組件,您可以實現SIP話機、手機兩種坐席登錄方式,其中在Web端可以實現兩種登錄方式,在APP端可以實現SIP話機(SIP軟話機)和手機兩種登錄方式。
    詳細對接說明,請參見如下:《呼叫中心JS組件開發指南》。

    第四步:如何獲取通話記錄?
    通話記錄的獲取有2種方式:主動查詢和消息推送。獲取原始的通話記錄后,您可以在CRM中進行數據統計和分析,同時通話記錄中包含了錄音地址。具體參見:同時,為減少您對于統計報表的開發工作量,您也可以使用超管賬號登錄智齒客服系統,在呼叫報表模塊查看統計數據,我們已確保了數據的一致。

    第五步:如何管理和監控客服?
    為便于您對客服進行管理和監控,智齒呼叫中心接口包含了客服消息推送接口,基于這些接口數據,您可以實時掌握客服當前的狀態。具體參見:同時,為減少您對于客服監控的開發工作量,您也可以使用呼叫管理員賬號登錄智齒客服系統,使用呼叫和客服監控模塊,我們已確保了狀態的一致。

    # 2、獲取訪問token編碼

    接口說明:

    在調用接口時必須在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。

    獲取API開放接口token,此token僅適用于智齒開放平臺 5.0版本全部API接口 。API接口中的參數 appid, app_key 請聯系智齒售后人員獲取。

    請求方式:

    GET

    請求地址:

    http://www.gene-tech.cn/api/get_token

    請求參數:

    參數 類型 必填 名稱 備注
    appid String 接口憑證Id 第三方用戶接口調用唯一憑證id,僅獲取token時使用
    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": "操作成功"
    }
    

    # 3、技能組管理

    詳見客服管理模塊,點擊此處跳轉

    # 4、坐席管理

    詳見客服管理模塊,點擊此處跳轉

    # 5、分機賬號管理

    # 5.1、查詢分機賬號

    接口說明:

    查詢綁定或未綁定的分機賬號列表
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/ext/query

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    bind_state 是否綁定 string bind綁定,nobind未綁定,空查詢所有分機數據
    region 區域 string 空查詢所有的區域

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 Object 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    companyid 公司id string 公司id
    appid 應用id string 應用id
    voip_account VoIP號碼 string 由9位數字組成
    voip_pwd VoIP密碼 string 由8位數字和字母組成,例如1nhccaj8
    create_time 創建時間 long Voip的創建時間,13位時間戳
    agentid 坐席id string
    agent_name 坐席名稱 string
    region 區域 string

    請求示例:

    {
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
        "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
        "bind_state": "bind",
        "region": "北京"
    }
    

    返回示例:

    {
        "items": [
            {
                "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
                "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
                "create_time": 1576670289049,
                "region": "北京",
                "voip_account": "901250029",
                "voip_pwd": "7LQv80K1",
                "agentid": "23452345xs6v76d76v67",
                "agent_name": "小明"
            }
        ],
        "ret_code": "000000",
        "ret_msg": "成功"
    }
    
    

    # 5.2、查詢坐席是否綁定分機賬號

    接口說明:

    用于判斷坐席是否已經綁定分機賬號,如已綁定分機賬號則會返回對應的分機賬號信息
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/ext/agent_bind_ext

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    agentid 坐席id string

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    item 返回對象 Object 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    voip_account VoIP號碼 string 由9位數字組成
    voip_pwd VoIP密碼 string
    create_time 創建時間 long Voip的創建時間,13位時間戳
    agentid 坐席id string

    請求示例:

    {
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
        "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
        "agentid":"279c06647f814a2ebae0212e4c5faaf2"
    }
    
    

    返回示例:

    {   
        "ret_code": "000000",
        "ret_msg": "請求成功",
        "item": {
            "voip_account": "900540000",
            "voip_pwd": "test1234",
            "companyid": "626632d761be4da2a33c7f26f6e50b41",
            "create_time": 1575428296,
            "appid": "80ecc892384b4f03b62176d6654ef2e9",
            "agentid": "093c2jL5"
        }
    }
    

    # 5.3、綁定分機賬號

    接口說明:

    用于為坐席綁定分機賬號
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/ext/bind

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    voip_account Voip賬號 string
    agentid 坐席id string

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求示例:

    {
        "companyid": "626632d761be4da2a33c7f26f6e50b41",
        "appid": "80ecc892384b4f03b62176d6654ef2e9",
        "agentid": "12ecc892384b4f03b62176d6654ef2e9",
        "voip_account": "900730006"
    }
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "請求成功"
    }
    

    # 5.4、解除分機賬號綁定關系

    接口說明:

    用于為坐席解除綁定分機賬號
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/ext/unbind

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    voip_account Voip賬號 string 如果不傳該參數則查詢該app下所有的voip賬號
    agentid 坐席id string

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求示例:

    {
        "companyid": "626632d761be4da2a33c7f26f6e50b41",
        "appid": "80ecc892384b4f03b62176d6654ef2e9",
        "agentid": "80ecc892384b4f03b62176d6654ef2e9",
        "voip_account": "900730006"
    }
    

    返回示例:

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

    # 5.5、解除分機賬號的注冊狀態

    接口說明:

    將當前已經注冊狀態的分機賬號變為未注冊狀態,并返回修改后的分機賬號密碼;再次注冊的時候需使用新密碼
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/ext/unregister

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    voip_account 分機賬號 string

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    item 返回對象 Object 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    voip_account VoIP號碼 string 由9位數字組成
    voip_pwd VoIP新密碼 string 由8位數字和字母組成,例如1nhccaj8

    請求示例:

    { 
        "companyid": "7db203d2e7004a85bdd78fae4362830c",
        "appid": "90f644715d174d53a7573e678aa42efa",
        "voip_account": "900730006"
    }
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功",
        "item": {
            "voip_account": "900540000",
            "voip_pwd": "626632d761be4da2a33c7f26f6e50b41"
        }
    }
    

    # 5.6、查詢在線分機賬號

    接口說明:

    查詢當前所有在線的話機信息
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/ext/online

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    exts 分機列表 string 分機列表,如果不傳則返回該應用下的所有在線話機

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 Object[] 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    voip_account 分機號碼 string VoIP號碼。由9位數字組成
    create_time long VoIP的創建時間
    region 分機所在區域 string 分機所在區域,null為默認區域(可忽略)

    請求示例:

    {
        "companyid": "efb1f96181b9487ca17f7d60cfe12741",
        "appid": "8db714ad04414be48916c526b9a01015",
        "exts": [
            "900540000,900540001"
        ]
    }
    
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功",
        "items": [{
            "voip_account": "900540000",
            "companyid": "626632d761be4da2a33c7f26f6e50b41",
            "create_time": 1575428296,
            "appid": "80ecc892384b4f03b62176d6654ef2e9",
            "region": "北京",
            "voip_pwd": "093c2jL5"
        },
        {
            "voip_account": "900540001",
            "companyid": "626632d761be4da2a33c7f26f6e50b41",
            "create_time": 1575428296,
            "appid": "80ecc892384b4f03b62176d6654ef2e9",
            "region": "北京",
            "voip_pwd": "l545y2Xp"
        }]
    }
    

    # 6、外顯號碼管理

    # 6.1、查詢外顯號碼

    接口說明:

    坐席上班或者外呼時可以動態指定以某一個外顯號碼,這樣在手機登錄時接聽電話或者外呼時顯示的外顯號碼即為調用接口時傳入的號碼,這些號碼需要智齒在后臺支撐系統配置,您可以通過此接口查詢您當前的所有可使用的號碼。

    請求及響應報文格式采用JSON格式

    訪問方式:

    GET http://www.gene-tech.cn/comm-open/api/call/5/number/{companyid}/{appid}

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 Object[] 可用號碼json數組,詳見下表
    字段編碼 字段名稱 字段類型 備注說明
    call_number 號碼 string -
    attribution 歸屬地 string 例如:北京、上海
    concurrency 并發數 string 并發數
    allocate_time 分配到應用的時間 string 13位時間戳

    請求示例:

    http://www.gene-tech.cn//comm-open/api/call/5/number/626632d761be4da2a33c7f26f6e50b41/80ecc892384b4f03b62176d6654ef2e9
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功",
        "items": [
                {
                    "call_number": "075536654676",
                    "attribution": "深圳",
                    "concurrency": "1",
                    "allocate_time": "1562580389"
                },
                {
                    "call_number": "057128854207",
                    "attribution": "",
                    "concurrency": "2",
                    "allocate_time": "1562580389"
                }
        ]
    }
    

    # 6.2、通過公司id查詢外顯號碼

    接口說明:

    坐席上班或者外呼時可以動態指定以某一個外顯號碼,這樣在手機登錄時接聽電話或者外呼時顯示的外顯號碼即為調用接口時傳入的號碼,這些號碼需要智齒在后臺支撐系統配置,您可以通過此接口查詢您當前的所有可使用的號碼。

    請求及響應報文格式采用JSON格式

    {soft_version}是當前使用的REST API版本,不同版本會有差異,當前版本為:5

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/{soft_version}/numbers/query

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 Object[] 可用號碼json數組,詳見下表
    字段編碼 字段名稱 字段類型 備注說明
    call_number 號碼 string -
    attribution 歸屬地 string 例如:北京、上海
    concurrency 并發數 string 并發數
    allocate_time 分配到應用的時間 string 13位時間戳
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid

    請求示例:

    http://www.gene-tech.cn/comm-open/api/call/{soft_version}/numbers/query
    
    {
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7"
    }
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功",
        "items": [
            {
                "call_number": "075536654676",
                "attribution": "深圳",
                "concurrency": "1",
                "allocate_time": "1562580389"
            },
            {
                "call_number": "057128854207",
                "attribution": "",
                "concurrency": "2",
                "allocate_time": "1562580389"
            }
        ]
    }
    

    # 6.3、查詢公司外顯號碼及其配置規則

    接口說明:

    按照技能組id查找外顯號碼;按照被叫號碼查找外顯號碼

    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/numbers/queryByRuleType

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    groupid 技能組id string 系統設置-呼叫中心-號碼管理中,外顯規則的分配方式是按技能組分配的話,此參數必填
    callee 被叫號碼 string 系統設置-呼叫中心-號碼管理中,外顯規則的分配方式是歸屬地優先分配的話,此參數必填
    agentid 坐席id string 系統設置-呼叫中心-號碼管理中,外顯規則的分配方式是按坐席分配的話,此參數必填
    ret_more 是否允許返回多個外顯號碼 boolean 默認false,只返回一個

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    item 返回對象 Object 外顯號碼對象,詳見下表
    字段編碼 字段名稱 字段類型 備注說明
    call_number 可用外顯號碼數組 string[] 可用外顯號碼數組
    rule_type 分配方式 int 0隨機1輪流2歸屬地優先301按客服分配302按技能組分配303按地理位置分配4指定號碼,默認返回0

    請求示例:

    http://www.gene-tech.cn/comm-open/api/call/5/numbers/queryByRuleType
    
    // 按技能組分配
    {
        "companyid":"6fa94a074b8646b38f6f5decc7580fe7",
        "appid":"3186d4c82ab7421ea36d36fcac9cdbbe",
        "groupid":"49fcb97d2f9a4b69a9aa9a344dc3bc83_1"
    }
    // 歸屬地優先分配
    {
        "companyid":"6fa94a074b8646b38f6f5decc7580fe7",
        "appid":"3186d4c82ab7421ea36d36fcac9cdbbe",
        "callee":"13800138000"
    }
    

    返回示例:

    {
        "item":{
            "call_number":["01021755241"],
            "rule_type":302
        },
        "ret_code":"000000",
        "ret_msg":"操作成功"
    }
    

    # 6.4、刪除外顯號碼

    接口說明:

    刪除某個應用下分配的號碼,如果號碼不填寫,刪除該應用下全部號碼。如果號碼不在某個應用下,自動跳過

    請求及響應報文格式采用JSON格式

    訪問方式:

    DELETE http://www.gene-tech.cn/comm-open/api/call/5/number/{companyid}/{appid}

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string 公司id
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    call_number string 需要刪除的號碼,多個號碼逗號(",")隔開,最大支持500個號

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求示例:

    {
        "call_number": "057128854207,057128854208,057128854210"
    }
    

    返回示例:

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

    # 7、通話記錄

    # 7.1、查詢通話記錄

    接口說明:

    用于查詢通話記錄的詳細信息,返回結果集是按照開始時間倒敘排列。

    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/record

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    service_email 郵箱 string 在智齒的賬號
    start_time 開始時間 string 查詢通話記錄的開始時間(yyyy-MM-dd HH:mm:ss)
    end_time 結束時間 string 查詢通話記錄結束時間點(yyyy-MM-dd HH:mm:ss)
    call_direction 呼叫方向 int 1.呼出0.呼入、11(咨詢客服),12(咨詢第三方),21(轉接咨詢)、22(轉接客服)、23(轉接第三方),3(監聽)、4(強插通話)、5(強拆通話)
    page int 第幾頁
    size int 每頁顯示的條數,建議每頁15條

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 List 詳看下表

    Item參數詳解:

    字段編碼 字段名稱 類型 可空 備注說明
    agentid 呼叫坐席id string
    companyid 公司id string -
    departmentid 組織權限id string -
    callid 通話記錄id string -
    parent_call_recordid 主通話id string 對于主話單:parent_call_recordid = id
    agent_ring_time 振鈴時長 long 坐席振鈴時間,如果空表示用戶來點還沒轉到坐席就掛掉了,時間戳格式
    agent_ring_time_str 振鈴時長 string 同上,只是時間格式是字符串類型
    agent_hungup_time 坐席掛機時間 long -
    agent_hungup_time_str 坐席掛機時間 string -
    agent_answer_time 坐席接聽時間 long -
    agent_start_time_str 坐席接聽時間 string -
    ring_time_duration 振鈴時長 long 單位秒
    businessid 服務總結所屬業務id string -
    business_name 業務名稱 string 服務總結所屬業務名稱
    business_typeid 業務類型id string 服務總結所屬業務類型id
    business_type_name 業務類型名稱 string 服務總結所屬業務類型名稱
    bussiness_type_pathid 業務類型路徑id string 服務總結所屬業務類型路徑id
    bussiness_type_path_name 業務類型路徑名稱 string 服務總結所屬業務類型路徑名稱
    call_duration 錄音時長 int 錄音時長,單位:秒
    call_flag 接聽標示 int 0未接聽,1已接聽
    call_result 通話結果 int 10. 坐席接聽11.振鈴未接聽12.ivr放棄13.排隊放棄14.非服務時間來電15.呼入話機異常16.呼入網絡異常17.排隊超時18.客戶速掛20.客戶接聽21.客戶未接聽25.呼出話機異常26.呼出網絡異常781.客戶拒接774.號碼空號770.客戶關機771.客戶停機772.暫時無法接通773.客戶正在通話 30第三方接聽、31第三方無法接通(所有其他的因素)、32第三方振鈴未接聽(包括長時間無應答、第三方拒接)
    call_succ 通話結果 boolean 通話結果使用
    call_way 接聽方式 int 1網頁電話,2sip話機,3手機
    callee 被叫號碼 string -
    calleeid 被叫人id string 可能是坐席或已知用戶id
    callee_name 被叫人姓名 string -
    caller 主叫號碼 string -
    callerid 主叫人id string 可能是坐席或已知用戶id
    caller_name 主叫人名稱 string -
    call_type 呼叫類型 int 0(呼入),1(呼出)、11(咨詢客服),12(咨詢第三方),21(轉接咨詢)、22(轉接客服)、23(轉接第三方),3(監聽)、4(強插通話)、5(強拆通話)
    call_direction 呼叫方向 int 0(呼入),1(呼出)
    duration 通話時長 long -
    end_time 結束時間 long 整個呼叫服務通話結束時間
    end_time_str 結束時間 string 整個呼叫服務通話結束時間
    ender 掛斷方 int 0 系統超時掛斷,1客服掛斷,2客戶掛斷
    enter_group_flag 是否進入隊列 Int 0 否 1 是
    exist_flag 是否已知用戶 int 0:未知用戶,1:已知用戶
    fee 費用 double 通話產生的費用
    fee_duration 計費時長 long 計費時長, 單位:分鐘
    groupid 技能組id string 呼叫時使用的技能組
    --- --- --- --- ---
    group_name 技能組名稱 string -
    group_type 否為電銷組 int 2.普通3.電銷
    handle_status 服務總結 int -1 未處理 0 未解決 1 已解決
    hidden_flag 否隱藏號碼 int 0.不隱藏 1.中間隱藏2.末尾隱藏
    hold 保持 int 1.有保持0.沒保持
    hold_count 保持次數 int -
    hold_time 保持持續時間 long -
    in_queue_time 排隊入隊時間 long -
    in_queue_time_str 排隊入隊時間 string -
    out_call_in_task_flag 電銷任務外呼 int 是否是外呼任務 0否1是
    queue_flag 是否有排隊 int 0沒有排隊;1有排隊
    nick 昵稱 string 客戶昵稱
    number_city 電話歸屬地城市 string -
    number_provice 電話歸屬地省份 string -
    out_queue_time 排隊出隊時間 long -
    out_queue_time_str 排隊出隊時間 string -
    quality_status 是否質檢 int 0為之間1質檢過
    queue_duration 排隊時長 long -
    queue_state 排隊狀態 int 1.未排隊 2.排隊成功 3.排隊超時 4.排隊離開 (排隊放棄=3+4)
    receive_staffids 接待客服id string 按時間先后排,逗號隔開,有轉接的
    receive_staff_names 接待客服名字 string 按時間先后排,逗號隔開
    remarks 備注 string -
    satisfy_level 滿意度級別 int 0:未開啟滿意度,2:二級滿意度,3:三級滿意度,5:五級滿意度,10:自定義滿意度
    satisfy_value 滿意度名稱 string 未評價,非常不滿意,不滿意,一般,滿意,非常滿意,自定義滿意度1,自定義滿意度2,自定義滿意度3,自定義滿意度4,自定義滿意度5,自定義滿意度6
    satisfy_key 滿意度按鍵 int 0:未評價 1,2,3,4,5,6
    service_email 坐席賬號 string -
    staffid 坐席id string -
    staff_name 坐席名稱 string -
    start_time 開始時間 long 呼叫開始時間
    start_time_str 開始時間 string 呼叫開始時間
    summary_staff_name 坐席名稱 string 記錄服務總結的坐席名稱
    summary_update_time 更新時間 long 更新服務總結的時間
    summary_update_time_str 更新時間 string 更新服務總結的時間
    taskid 任務id string 通過電銷任務外呼的任務id
    transfer_count 轉接次數 int -
    transfer_flag 是否轉接 int 0=未轉接 1= 轉接咨詢 2= 轉接
    unhold 保持 int 1.正常取消 0.沒有取消
    user_ring_time 振鈴時間 long 坐席呼出用戶 的振鈴時間
    user_ring_time_str 振鈴時間 string 坐席呼出用戶 的振鈴時間
    user_answer_time 應答時間 long 外呼時用戶應答時間
    user_answer_time_str 應答時間 string 外呼時用戶應答時間
    user_companyid 客戶公司id string 已知用戶所在公司id
    user_company_name 客戶公司名稱 string 已知用戶所在公司名稱
    userid 客戶id string 已知用戶id
    user_name 客戶名稱 string 已知用戶名稱
    voice_aliyun_url 錄音地址 string 接通的有值
    page_count 頁數 int -
    page_no 當前頁數 int -
    page_size 每頁條數 int 建議不要大于15
    total_count 總條數 int -
    consult_flag 是否咨詢 Int 0-未咨詢、1-咨詢(默認0,只有咨詢成功)
    consult_count 咨詢次數 Int -
    leave_msg_flag 留言標識 Int - 0-未留言,1-留言
    leave_msg_url 留言地址 string - -
    params 客戶自定義字段 string - -

    請求示例:

    {
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
        "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
        "service_email": "11q@sobot.com",
        "start_time": "2019-12-20 00:00:00",
        "end_time": "2019-12-29 23:59:00",
        "call_direction": 1,
        "page": 1,
        "size": 15
    }
    
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功",
        "items": [
            {
                "abandon_flag": "0",
                "agent_answer_time": 1596783668211,
                "agent_answer_time_str": "20200807150108211",
                "agent_hungup_time": 1596783741745,
                "agent_hungup_time_str": "20200807150221745",
                "agent_ring_time": 1596783665798,
                "agent_ring_time_str": "20200807150105798",
                "agent_wait_duration": "7",
                "agentid": "85e9b4396ba44fb8ae195bb445a38f8d",
                "appid": "0292d288caea49f882aa773aefced7a1",
                "break_down_succ_time": "0",
                "break_in_succ_time": "0",
                "business_name": "",
                "business_type_name": "",
                "business_typeid": "",
                "businessid": "",
                "bussiness_type_path_name": "",
                "bussiness_type_pathid": "",
                "call_direction": 1,
                "call_duration": 76,
                "call_flag": 1,
                "call_result": 20,
                "call_succ": true,
                "call_type": 1,
                "call_way": 1,
                "callee": "15076689607",
                "callee_name": "15076689607",
                "calleeid": "1180e0525fbb4918abbdda85ab01ea52",
                "caller": "051568028142",
                "caller_name": "wufan",
                "callerid": "85e9b4396ba44fb8ae195bb445a38f8d",
                "callid": "f3a1bdf2-359e-45f7-92ea-adf055e10ed8",
                "companyid": "8e030968b3f4426b974aa06a3e63f7c9",
                "consult_count": 0,
                "consult_flag": 0,
                "departmentid": "8e030968b3f4426b974aa06a3e63f7c9|0446cd6c57cd4be395e42d64d74898f0|e3201a673fda4a818964232a55a8c30e",
                "duration": 66,
                "end_time": 1596783741772,
                "end_time_str": "20200807150221772",
                "ender": 1,
                "enter_group_flag": 1,
                "exist_flag": 1,
                "fee": 0.2,
                "fee_duration": 2,
                "group_name": "wufan",
                "group_type": 2,
                "groupid": "8e030968b3f4426b974aa06a3e63f7c9_3",
                "handle_status": -1,
                "hidden_flag": 0,
                "hold": 0,
                "hold_count": 0,
                "hold_time": 0,
                "in_queue_time": 0,
                "in_queue_time_str": "",
                "leave_msg_flag": 0,
                "leave_msg_url": "",
                "nick": "15076689607",
                "number_city": "廊坊",
                "number_provice": "河北",
                "out_call_in_task_flag": 0,
                "out_queue_time": 0,
                "out_queue_time_str": "",
                "page_count": 0,
                "page_no": 0,
                "page_size": 0,
                "params": "",
                "parent_call_recordid": "f3a1bdf2-359e-45f7-92ea-adf055e10ed8",
                "quality_status": 0,
                "queue_duration": 0,
                "queue_flag": 0,
                "queue_state": 1,
                "receive_staff_names": "wufan,wufan,wufan",
                "receive_staffids": "85e9b4396ba44fb8ae195bb445a38f8d,85e9b4396ba44fb8ae195bb445a38f8d,85e9b4396ba44fb8ae195bb445a38f8d",
                "remarks": "",
                "ring_time_duration": 10,
                "satisfy_level": 5,
                "satisfy_value": "未評價",
                "satisfy_key":0,
                "service_email": "wufan@test.com",
                "staff_name": "wufan",
                "staffid": "85e9b4396ba44fb8ae195bb445a38f8d",
                "start_time": 1596783665727,
                "start_time_str": "20200807150105727",
                "summary_staff_name": "",
                "summary_update_time": 0,
                "summary_update_time_str": "",
                "taskid": "",
                "total_count": 0,
                "transfer_count": 0,
                "transfer_flag": 0,
                "unhold": 0,
                "user_answer_time": 1596783675933,
                "user_answer_time_str": "20200807150115933",
                "user_company_name": "",
                "user_companyid": "",
                "user_name": "",
                "user_ring_time": 1596783668257,
                "user_ring_time_str": "20200807150108257",
                "userid": "1180e0525fbb4918abbdda85ab01ea52",
                "voice_aliyun_url": "https://img.sobot.com/pass/record/8e030968b3f4426b974aa06a3e63f7c9/0292d288caea49f882aa773aefced7a1/20200807/f3a1bdf2-359e-45f7-92ea-adf055e10ed8.wav"
            },
        ]
    }
    

    # 7.2、推送主話單信息

    接口說明:

    推送主話單信息

    訪問方式:

    詳見回調消息參數說明,點擊此處跳轉

    content對象:

    字段編碼 字段名稱 類型 可空 備注說明
    start_time 開始時間 String unixtime毫秒通話開始時間
    companyid String 適用一個公司多個超管帳號或者多個分公司需要分別統計的情況
    departmentid 組織架構ID String
    groupid 技能組ID String
    group_name 技能組名稱 String
    agentid 坐席ID String
    staff_emails 客服郵箱 String
    staff_name 客服姓名 String
    customer_phone 客戶手機號 String
    customer_name 客戶姓名 String
    direction String 呼叫類型,0(呼入),1(呼出) 11咨詢客服,12咨詢第三方,21轉接咨詢、22轉接客服、23轉接第三方,3監聽、4強插通話、5強拆通話
    call_direction 呼叫方向 String 0呼入 1呼出 描述初始的呼叫方向是呼入還是呼出。一個完整通話的主子話單均一樣
    end_time 通話結束時間 String 子話單沒有通話結束時間
    call_way 外呼方式 String 1 網頁電話 2 sip話機 3 手機
    caller 主叫號碼 String
    caller_name 主叫姓名 String
    callee 被叫號碼 String
    record_url 錄音地址 String
    callid 通話ID String 一組完整的通話的唯一標識
    parent_callid 主通話記錄ID String 當主通話記錄id不為空,并且與callId不同時,表示子話單,否則表示主話單
    fee 費用 String
    fee_duration 計費時長 String 單位:分鐘
    queue_duration 排隊時長 String 單位:秒
    agent_number 坐席NO String VOIP賬號
    call_flag 接聽標識 String 0 未接聽 1接聽
    --- --- --- --- ---
    ender 掛斷方 String 掛斷方 系統超時掛斷,1客服掛斷,2客戶掛斷 增加 3-轉接掛斷、4-強拆掛斷、5-第三方掛斷
    call_result 通話結果 String 10.呼入已接聽 11.振鈴未接聽 12.ivr放棄 13.排隊放棄 14.非服務時間來電 15.呼入話機異常 16.呼入網絡異常 17.排隊超時 18.客戶速掛 20.客戶接聽 21.客戶未接聽 25.呼出話機異常 26.呼出網絡異常 30第三方接聽、31第三方無法接通(所有其他的因素)、32第三方振鈴未接聽(包括長時間無應答、第三方拒接)769.沒振鈴就已摘機 770.客戶關機 771.客戶停機 772.暫時無法接通 773.客戶正在通話 774.號碼空號 781.客戶拒接 789.振鈴40秒超時未摘機
    line_type 線路類型 String
    agent_start_time 坐席接聽時間 String unixtime毫秒
    agent_end_time 坐席掛機時間 String unixtime毫秒
    agent_alerting_time 坐席振鈴時間 String unixtime毫秒
    user_alerting_time 坐席呼出的用戶占振鈴時間 String unixtime毫秒
    in_queue_time 排隊入隊列的時間 String unixtime毫秒
    out_queue_time 排隊出隊列的時間 String unixtime毫秒
    interval_end_time 子話單通話結束的時間 String unixtime毫秒
    user_answer_time 用戶接聽時間 String unixtime毫秒
    queue_state 排隊狀態 String 1 未排隊,2 排隊成功,3 排隊超時,4 排隊離開
    queue_flag 是否有排隊 String 0 沒有排隊;1 有排隊
    consult_flag 是否有咨詢 String 0 未咨詢;1 咨詢(默認未咨詢)
    transfer_flag 是否有轉接 String 0未轉接;1 轉接咨詢;2 轉接
    listen_flag 是否有監聽 String 0 無監聽;1 被監聽(默認0)
    hold_flag 是否有保持 String 0 無保持;1有保持
    abandon_flag 是否存在ivr放棄 String 0 無;1 是
    hold_down 取消保持 String 0 沒有取消;1 正常取消
    hold_count 保持次數 String
    consult_count 咨詢次數 String
    transfer_count 轉接次數 String
    leavemsg_flag 留言標識 String 0 未留言;1留言
    leavemsg_url 留言地址 String
    type 業務類型 String "hangup"(結束)
    msg_type String "cdr"
    number_province 電話歸屬地省份 String
    number_city 電話歸屬地城市 String
    callerid String 主叫ID,呼出時取staffid,呼入為空
    call_duration 呼叫總時長 String 呼叫最后一條消息減第一條消息的時間差,單位秒
    hold_duration 保持持續時間 String 單位:秒
    alerting_duration 振鈴時長 String 單位:秒
    interval_duration 區間通話時長 String 最早掛機時間減去摘機時間,單位秒
    parent_flag 是否是主話單 String 1 是;0 否
    hanup_time 用戶掛斷時間 String unixtime毫秒
    receive_staffids 接待的所有客服ID String 以逗號分割,按時間順序排列
    receive_staff_names 接待的所有的客服姓名 String 以逗號分割,按時間順序排列
    abandon_flag 是否存在ivr放棄 String 0 無;1 是;2 振鈴未接聽;3 排隊放棄
    agent_answer_time_str 坐席接聽時間 String 時間格式是字符串類
    agent_wait_duration 客服等待時長: String 客服話機振鈴接起到分配了客戶電話接通的等待時長
    appid 應用id String
    break_down_succ_time 強插后強拆成功的時間 String 沒有強插強拆則為0
    break_in_succ_time 強插時間 String 監聽后強插成功的時間,只有呼叫類型為強插通話時記錄,沒有強插強拆則為0
    params 客戶自定義字段 String
    satisfyNumber 滿意度字段 int 0(未評價);1;2;3;4;5。 * 1 非常不滿意,2不滿意,3一般,4滿意,5非常滿意
    satisfy_level 滿意度類型 int 0:未開啟滿意度,2:二級滿意度,3:三級滿意度,5:五級滿意度,10:自定義滿意度
    satisfy_str 滿意度名稱 string 未評價,非常不滿意,不滿意,一般,滿意,非常滿意,自定義滿意度1,自定義滿意度2,自定義滿意度3,自定義滿意度4,自定義滿意度5,自定義滿意度6
    satisfy_key 滿意度按鍵 int 0:未評價 1,2,3,4,5,6

    請求參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求參數示例:

    {
        "sys_code":"30",
        "type":"calllog",
        "content":[
            {
                "number_province":"北京",
                "number_city":"北京",
                "appid":"3e77faa8cefd405ab57604984293063e",
                "agentid":"3d47faa8cefd405ab57604984293063e",
                "call_way":"2",
                "callee":"01052786225",
                "departmentid":"efd6f48a6a534f5f9f3c336b797c6f16|774a2e77dff84e8b95b263824ab5db4f",
                "fee":"0",
                "groupid":"efd6f48a6a534f5f9f3c336b797c6f16_3",
                "staff_emails":"wangtn1@kungeek.com",
                "interval_end_time":"0",
                "hold_count":"0",
                "consult_count":"0",
                "ender":"2",
                "parent_callid":"8f6c1135-0374-4b8f-9b28-b61882eaa858",
                "transfer_count":"0",
                "type":"hangup",
                "fee_duration":"0",
                "caller_name":"汪潭",
                "hold_flag":"0",
                "customer_phone":"01052786225",
                "customer_name":"張大仙",
                "line_type":"27",
                "consult_flag":"0",
                "agent_start_time":"1555988119875",
                "leavemsg_url":"",
                "agent_end_time":"1555988179966",
                "leavemsg_flag":"0",
                "agent_number":"",
                "customer_name":"",
                "hold_down":"0",
                "companyid":"efd6f48a6a534f5f9f3c336b797c6f16",
                "group_name":"北京朝陽分部",
                "queue_duration":"0",
                "callerid":"ed3a2e4400db4c42bd8419ebf4fa9fa5",
                "call_result":"21",
                "queue_flag":"0",
                "call_duration":"65",
                "transfer_flag":"0",
                "leavemsg_flag":"0",
                "user_alerting_time":"1555988119985",
                "listen_flag":"0",
                "msg_type":"cdr",
                "call_direction":"1",
                "call_flag":"0",
                "in_queue_time":"0",
                "receive_staff_names":"汪潭,汪潭,汪潭",
                "out_queue_time":"0",
                "agent_alerting_time":"1555988114243",
                "duration":"0",
                "hanup_time":"1555988179918",
                "staff_name":"汪潭",
                "satisfy_str":"滿意",
                "alerting_duration":"65",
                "start_time":"1555988114057",
                "interval_duration":"0",
                "direction":"1",
                "parent_flag":"1",
                "callid":"8f6c1135-0374-4b8f-9b28-b61882eaa858",
                "queue_state":"1",
                "record_url":"",
                "hold_duration":"0",
                "caller":"10100168",
                "end_time":"1555988179966",
                "abandon_flag":"0",
                "receiveStaffIds":"ed3a2e4400db4c42bd8419ebf4fa9fa5,ed3a2e4400db4c42bd8419ebf4fa9fa5",
                "staffid":"ed3a2e4400db4c42bd8419ebf4fa9fa5",
                "params":"",
                "user_answer_time":"0",
                "satisfy_level":10,
                "satisfy_lumber":0,
                "satisfy_key":1,
                "satisfy_str":"自定義滿意度1"
            }
        ]
    }
    

    # 7.3、推送通話詳細信息

    接口說明:

    推送全部話詳細信息

    訪問方式:

    詳見回調消息參數說明,點擊此處跳轉

    content對象:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司ID String 適用一個公司多個超管帳號或者多個分公司需要分別統計的情況
    departmentid 組織權限id String
    groupid 技能組id String
    group_name 技能組名稱 String
    agentid 坐席id String 一個坐席對應一個agentid
    staff_emails 客服Email String
    staff_name 客服姓名 String
    customer_phone 客戶手機號 String
    customer_name 客戶姓名 String
    direction 呼叫類型 String
    call_direction 呼叫方向 String 呼叫類型,0(呼入),1(呼出) 11咨詢客服,12咨詢第三方,21轉接咨詢、22轉接客服、23轉接第三方,3監聽、4強插通話、5強拆通話
    start_time 通話開始時間 String
    end_time 通話結束時間 String 子話單沒有該字段
    call_way 外呼方式 String 1網頁電話,2sip話機,3手機
    caller 主叫號碼 String
    callee 被叫號碼 String
    record_url 通話記錄錄音地址 String
    callid 通話id String 一組完整通話的唯一標識
    parent_callid 主通話記錄id String 當主通話記錄id不為空,并且與callId不同時,表示子話單,否則表示主話單
    fee 費用 String
    fee_duration 計費時長 String 單位:分鐘
    duration 錄音時長 String
    queue_duration 排隊時長 String
    agent_number 坐席No String Voip賬號
    call_flag 接聽標識 String 0未接聽,1已接聽
    ender 掛斷方 String 掛斷方 系統超時掛斷,1客服掛斷,2客戶掛斷 增加 3-轉接掛斷、4-強拆掛斷、5-第三方掛斷
    call_result 通話結果 String 10. 坐席接聽11.振鈴未接聽12.ivr放棄13.排隊放棄14.非服務時間來電15.呼入話機異常16.呼入網絡異常17.排隊超時18.客戶速掛20.客戶接聽21.客戶未接聽25.呼出話機異常26.呼出網絡異常781.客戶拒接774.號碼空號770.客戶關機771.客戶停機772.暫時無法接通773.客戶正在通話 30第三方接聽、31第三方無法接通(所有其他的因素)、32第三方振鈴未接聽(包括長時間無應答、第三方拒接)
    line_type 線路類型 String
    agent_start_time 坐席接聽時間 String
    agent_end_time 坐席掛機時間 String
    agent_alerting_time 坐席振鈴時間 String
    user_alerting_time 坐席呼出用戶 的振鈴時間 String
    in_queue_time 排隊入隊時間 String
    out_queue_time 排隊出隊時間 String
    interval_end_time 子話單的通話結束時間 String
    user_answer_time 用戶接聽時間 String
    queue_flag 是否有排隊 String 0沒有排隊;1有排隊
    consult_flag 是否有咨詢 String 0-未咨詢、1-咨詢(默認0,只有咨詢成功)
    transfer_flag 是否有轉接 String 0未轉接; 1 轉接咨詢; 2 轉接
    listen_flag 是否有監聽 String 是否監聽 0-無、1-被監聽(默認0,只有成功被監聽才算)
    hold_flag 是否有保持 String 1.有保持0.沒保持
    hold_down 取消保持 String
    hold_count 保持次數 String
    consult_count 咨詢次數 String
    transfer_count 轉接次數 String
    leavemsg_flag 留言標識 String 0-未留言,1-留言
    leavemsg_url 留言地址 String
    type 結束 String "hangup"
    number_province 電話歸屬地省份 String
    number_city 電話歸屬地城市 String
    call_duration 通話時長 String
    hold_duration 保持時長 String
    alerting_duration 振鈴時長 String
    interval_duration 子話單通話時長 String 從摘機開始算
    params 客戶自定義字段 String
    satisfyNumber 滿意度字段 int 0(未評價);1;2;3;4;5。 * 1 非常不滿意,2不滿意,3一般,4滿意,5非常滿意
    satisfy_level 滿意度類型 int 0:未開啟滿意度,2:二級滿意度,3:三級滿意度,5:五級滿意度,10:自定義滿意度
    satisfy_str 滿意度名稱 string 未評價,非常不滿意,不滿意,一般,滿意,非常滿意,自定義滿意度1,自定義滿意度2,自定義滿意度3,自定義滿意度4,自定義滿意度5,自定義滿意度6
    satisfy_key 滿意度按鍵 int 0:未評價 1,2,3,4,5,6

    請求參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求參數示例:

    {
        "sys_code":"30",
        "type":"subcalllog",
        "content":[
            {
                "staff_name":"谷岳zhen",
                "callid":"f4326768-1070-44bf-8bb3-c07a018c3c85",
                "interval_duration":"0",
                "hold_duration":"0",
                "queue_duration":"0",
                "callee":"18810365733",
                "fee":"0.0",
                "fee_duration":"0",
                "interval_end_time":"0",
                "agent_end_time":"1576047630724",
                "ender":"2",
                "type":"hangup",
                "call_flag":"0",
                "number_province":"北京",
                "companyid":"457ad899bfde432d9fe480ec6f010e5a",
                "agent_alerting_time":"0",
                "agentid":"58755c771d294871a78a0c8dec2d1c5e",
                "staff_emails":"1_test@sobot.com",
                "satisfy_str":"滿意",
                "group_name":"14",
                "groupid":"626632d761be4da2a33c7f26f6e50b41_15",
                "customer_phone":"18810365733",
                "consult_count":"0",
                "transfer_flag":"0",
                "start_time":"1576047630624",
                "listen_flag":"0",
                "call_way":"3",
                "out_queue_time":"0",
                "hold_count":"0",
                "hold_down":"0",
                "call_duration":"0",
                "consult_flag":"0",
                "duration":"0",
                "number_city":"北京",
                "record_url":"",
                "user_answer_time":"0",
                "line_type":"68",
                "direction":"1",
                "queue_flag":"0",
                "alerting_duration":"0",
                "user_alerting_time":"0",
                "parent_callid":"f4326768-1070-44bf-8bb3-c07a018c3c85",
                "leavemsg_url":"0",
                "call_direction":"1",
                "departmentid":"457ad899bfde432d9fe480ec6f010e5a",
                "end_time":"1576047630873",
                "in_queue_time":"0",
                "caller":"15011296067",
                "hold_flag":"0",
                "transfer_count":"0",
                "agent_start_time":"0",
                "leavemsg_flag":"0",
                "params":"",
                "call_result":"26",
                "satisfy_level":10,
                "satisfy_number":0,
                "satisfy_key":1,
                "satisfy_str":"自定義滿意度1"
            }
        ]
    }
    

    # 7.4、批量查詢通話記錄

    接口說明:通過批量通話id查詢通話記錄

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/{soft_version}/record/callid_list

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string
    appid 應用id string 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid
    callid_list 通話id list 通話id集合,最多1000個
    start_time 開始時間 string 查詢通話記錄的開始時間(yyyy-MM-dd HH:mm:ss) 不填默認最近24小時
    end_time 結束時間 string 查詢通話記錄結束時間點(yyyy-MM-dd HH:mm:ss) 不填默認最近24小時

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 List 詳看下表
    total_count 返回數量 int 查詢結果數量

    Item參數詳解:

    字段編碼 字段名稱 類型 可空 備注說明
    agentid 呼叫坐席id string
    companyid 公司id string -
    departmentid 組織權限id string -
    id 通話記錄id string -
    parent_call_recordid 主通話id string 對于主話單:parent_call_recordid = id
    agent_ring_time 振鈴時長 long 坐席振鈴時間,如果空表示用戶來點還沒轉到坐席就掛掉了,時間戳格式
    agent_ring_time_str 振鈴時長 string 同上,只是時間格式是字符串類型
    agent_hungup_time 坐席掛機時間 long -
    agent_hungup_time_str 坐席掛機時間 string -
    agent_answer_time 坐席接聽時間 long -
    agent_start_time_str 坐席接聽時間 string -
    ring_time_duration 振鈴時長 long 單位秒
    businessid 服務總結所屬業務id string -
    business_name 業務名稱 string 服務總結所屬業務名稱
    business_typeid 業務類型id string 服務總結所屬業務類型id
    business_type_name 業務類型名稱 string 服務總結所屬業務類型名稱
    bussiness_type_pathid 業務類型路徑id string 服務總結所屬業務類型路徑id
    bussiness_type_path_name 業務類型路徑名稱 string 服務總結所屬業務類型路徑名稱
    call_duration 錄音時長 int 錄音時長,單位:秒
    call_flag 接聽標示 int 0未接聽,1已接聽
    call_recordid 通話id string -
    call_result 通話結果 int 10. 坐席接聽11.振鈴未接聽12.ivr放棄13.排隊放棄14.非服務時間來電15.呼入話機異常16.呼入網絡異常17.排隊超時18.客戶速掛20.客戶接聽21.客戶未接聽25.呼出話機異常26.呼出網絡異常781.客戶拒接774.號碼空號770.客戶關機771.客戶停機772.暫時無法接通773.客戶正在通話 30第三方接聽、31第三方無法接通(所有其他的因素)、32第三方振鈴未接聽(包括長時間無應答、第三方拒接)
    call_succ 通話結果 boolean 通話結果使用
    call_way 接聽方式 int 1網頁電話,2sip話機,3手機
    callee 被叫號碼 string -
    calleeid 被叫人id string 可能是坐席或已知用戶id
    callee_name 被叫人姓名 string -
    caller 主叫號碼 string -
    callerid 主叫人id string 可能是坐席或已知用戶id
    caller_name 主叫人名稱 string -
    call_type 呼叫類型 int 0(呼入),1(呼出)、11(咨詢客服),12(咨詢第三方),21(轉接咨詢)、22(轉接客服)、23(轉接第三方),3(監聽)、4(強插通話)、5(強拆通話)
    call_direction 呼叫方向 int 0(呼入),1(呼出)
    duration 通話時長 long -
    end_time 結束時間 long 整個呼叫服務通話結束時間
    end_time_str 結束時間 string 整個呼叫服務通話結束時間
    ender 掛斷方 int 0 系統超時掛斷,1客服掛斷,2客戶掛斷
    enter_group_flag 是否進入隊列 Int 0 否 1 是
    exist_flag 是否已知用戶 int 0:未知用戶,1:已知用戶
    fee 費用 double 通話產生的費用
    fee_duration 計費時長 long 計費時長, 單位:分鐘
    groupid 技能組id string 呼叫時使用的技能組
    group_name 技能組名稱 string -
    group_type 否為電銷組 int 2.普通3.電銷
    handle_status 服務總結 int -1 未處理 0 未解決 1 已解決
    hidden_flag 否隱藏號碼 int 0.不隱藏 1.中間隱藏2.末尾隱藏
    hold 保持 int 1.有保持0.沒保持
    hold_count 保持次數 int -
    hold_time 保持持續時間 long -
    in_queue_time 排隊入隊時間 long -
    in_queue_time_str 排隊入隊時間 string -
    out_call_in_task_flag 電銷任務外呼 int 是否是外呼任務 0否1是
    queue_flag 是否有排隊 int 0沒有排隊;1有排隊
    nick 昵稱 string 客戶昵稱
    number_city 電話歸屬地城市 string -
    number_provice 電話歸屬地省份 string -
    out_queue_time 排隊出隊時間 long -
    out_queue_time_str 排隊出隊時間 string -
    quality_status 是否質檢 int 0為之間1質檢過
    queue_duration 排隊時長 long -
    queue_state 排隊狀態 int 1.未排隊 2.排隊成功 3.排隊超時 4.排隊離開 (排隊放棄=3+4)
    receive_staffids 接待客服id string 按時間先后排,逗號隔開,有轉接的
    receive_staff_names 接待客服名字 string 按時間先后排,逗號隔開
    remarks 備注 string -
    satisfy_level 滿意度級別 int 0:未開啟滿意度,2:二級滿意度,3:三級滿意度,5:五級滿意度,10:自定義滿意度度
    satisfy_value 滿意度名稱 string 未評價,非常不滿意,不滿意,一般,滿意,非常滿意,自定義滿意度1,自定義滿意度2,自定義滿意度3,自定義滿意度4,自定義滿意度5,自定義滿意度6
    satisfy_key 滿意度按鍵 int 0:未評價 1,2,3,4,5,6
    service_email 坐席賬號 string -
    staffid 坐席id string -
    staff_name 坐席名稱 string -
    start_time 開始時間 long 呼叫開始時間
    start_time_str 開始時間 string 呼叫開始時間
    summary_staff_name 坐席名稱 string 記錄服務總結的坐席名稱
    summary_update_time 更新時間 long 更新服務總結的時間
    summary_update_time_str 更新時間 string 更新服務總結的時間
    taskid 任務id string 通過電銷任務外呼的任務id
    transfer_count 轉接次數 int -
    transfer_flag 是否轉接 int 0=未轉接 1= 轉接咨詢 2= 轉接
    unhold 保持 int 1.正常取消 0.沒有取消
    user_ring_time 振鈴時間 long 坐席呼出用戶 的振鈴時間
    user_ring_time_str 振鈴時間 string 坐席呼出用戶 的振鈴時間
    user_answer_time 應答時間 long 外呼時用戶應答時間
    user_answer_time_str 應答時間 string 外呼時用戶應答時間
    user_companyid 客戶公司id string 已知用戶所在公司id
    user_company_name 客戶公司名稱 string 已知用戶所在公司名稱
    userid 客戶id string 已知用戶id
    user_name 客戶名稱 string 已知用戶名稱
    voice_aliyun_url 錄音地址 string 接通的有值
    page_count 頁數 int -
    page_no 當前頁數 int -
    page_size 每頁條數 int 建議不要大于15
    total_count 總條數 int -
    consult_flag 是否咨詢 Int 0-未咨詢、1-咨詢(默認0,只有咨詢成功)
    consult_count 咨詢次數 Int -
    leave_msg_flag 留言標識 Int - 0-未留言,1-留言
    leave_msg_url 留言地址 string - -
    params 客戶自定義字段 string - -

    請求示例:

    {
        "companyid":"aa8ce5f7c37244a0a241827e26e34653",
        "appid":"0aa8128b56ea499196e5caaadbb1744f",
        "callid_list":["0bcd784c-8f5f-11ea-9f2f-f52f48e3b0b1"],
        "start_time":"2020-04-07 00:00:00",	
        "end_time":"2020-05-06 23:59:59"
    }
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "查詢成功",
        "items": [
            {
                "call_way": 2,
                "callee": "18515239792",
                "departmentid": "99136776306c4d16b54273b39cb35a83|9943ca02504b4afeabbcf3f80373022b",
                "fee": 0.1,
                "groupid": "99136776306c4d16b54273b39cb35a83_2",
                "staff_email": "tangyupro@sobot.com",
                "platform_type": 0,
                "hold_count": 0,
                "ender": 2,
                "transfer_count": 0,
                "type": "hangup",
                "fee_duration": 1,
                "caller_name": "唐瑜",
                "hold": 0,
                "customer_phone_number": "18515239792",
                "line_type": 5,
                "out_callIn_task": 0,
                "id": "425a9069-7a89-45be-a48d-683b5c925492",
                "agent_start_time": 1538118314558,
                "agentid": "45fd00d4c4b54deea5a5f98ddd7e9aee",
                "agent_end_time": 1538118327744,
                "agent_number":"空",
                "customer_name":"空",
                "task_detailid": "",
                "un_hold": 0,
                "companyid": "99136776306c4d16b54273b39cb35a83",
                "group_name": "paas呼入測試改名",
                "queue_duration": 0,
                "agent_ring_time_str": "20180928150511096",
                "agent_end_time_str": "20180928150527744",
                "callerid": "45fd00d4c4b54deea5a5f98ddd7e9aee",
                "call_result": 20,
                "call_duration": 16,
                "transfer_flag": 0,
                "group_type": 2,
                "isOut_callIn_task": 0,
                "user_ring_time": 1538118315282,
                "msg_type": "cdr",
                "call_flag": 1,
                "receive_staff_names": "唐瑜,唐瑜",
                "agent_start_time_str": "20180928150514558",
                "start_time_str": "20180928150510896",
                "agent_ring_time": 1538118311096,
                "needTo_recover_data": false,
                "number_city": "北京",
                "duration": 5,
                "enter_group_flag": 1,
                "ext_satisfy_type": 1,
                "endtype": 3,
                "staff_name": "唐瑜",
                "ring_time_duration": 11,
                "start_time": 1538118310896,
                "call_type": 1,
                "user_answer_time_str": "20180928150522419",
                "callid": "425a9069-7a89-45be-a48d-683b5c925492",
                "queueState": 1,
                "hidden_flag": 0,
                "voice_aliyun_url": "http://sobot.oss-cn-beijing.aliyuncs.com/pass/record/99136776306c4d16b54273b39cb35a83/360b677aa4e64b83be0701be2854064e/20180928/425a9069-7a89-45be-a48d-683b5c925492.wav",
                "satisfy_level": 2,
                "satisfy_value":"未評價",
                "satisfy_key":0,
                "hold_time": 0,
                "user_ring_time_str": "20180928150515282",
                "caller": "02759760085",
                "end_time_str": "20180928150527744",
                "number_provice": "北京",
                "end_time": 1538118327744,
                "abandon_flag": 0,
                "satisfy_number": 0,
                "staffid": "45fd00d4c4b54deea5a5f98ddd7e9aee",
                "params": "",
                "user_answer_time": 1538118322419
            }
        ],
        "total_count": 1
    }
    

    # 7.5 查詢最終推送失敗的通話詳細信息

    接口說明 :

    查詢請求《推送通話詳細信息》API,多次推送都失敗的通話詳細信息(包含主話單或子話單最終失敗記錄都會被查詢到)。用于查詢推送失敗消息記錄詳細信息,其中dataType默認為subcalllog類型,返回結果集是按照消息發送時間倒敘排序。請求及響應報文格式采用JSON格式

    調用方式

    POST http://www.gene-tech.cn/comm-open/api/call/5/record/getDataPushResult
    

    請求參數:

    字段編碼 字段名稱 字段類型 長度 可空 備注說明
    company_id 公司id string 公司id
    start_time 通話開始時間 string 格式示例:1603814400000
    end_time 通話結束時間 string 格式示例:1606752000000
    page 頁數 Integer 當前頁數
    size 條數 Integer 每頁顯示條數,默認為12
    app_id 應用id string
    token token令牌 string 用戶在智齒平臺獲取的令牌

    返回參數:

    字段編碼 字段名稱 字段類型 長度 可空 備注說明
    ret_code 返回編碼 string 10 000000成功,其他失敗
    ret_msg 返回提示信息 string 成功與錯誤提示
    items 推送失敗消息集合 string 詳解參照下表
    page_count 總頁數 int 總頁數
    page_no 當前頁 int 當前是總頁數中的第幾頁
    page_size 條數 int 每頁顯示條數,默認是12
    total_count 總條數 int 顯示的是所有數據的總條數,而非當前頁的總條數

    items參數詳解

    字段編碼 字段名稱 字段類型 可空 備注說明
    company_id 公司id string
    data_content 推送的每條消息 string 對應推送時報文中的content字段
    data_type 推送的類型 string 對應推送時報文中的type字段,如subcalllog
    date_time 通話開始時間 long 格式示例:1603814400000
    resp_code 回復編碼 string 目前用不到
    resp_content 客戶的響應報文內容 string
    send_content 推送內容總匯 string 是一個數組,以字符串形式展示,匯聚了所有信息,包括content,type等
    send_time 消息推送時間 long 格式示例:1603814400000
    status_code 響應碼 int http響應碼,如404
    unique_id 對應通話id string 通話記錄推送,對應的是通話id
    app_id 應用id String

    send_content參數詳情請參照7.3

    返回示例:

    {
    "items": [
        {
            "company_id": "XXXX",
            "data_content": "XXXX",
            "data_type": "XXXX",
            "date_time": XXXX,
            "resp_code": "XXXX",
            "resp_content": "...",
            "send_content": "......",
            "send_time": XXXX,
            "status_code": XXXX,
            "unique_id": "XXXX"
            "app_id": "XXXX"
    
        }
        ]
    "page_count": 3,
    "page_no": 1,
    "page_size": 12,
    "ret_code": "000000",
    "ret_msg": "查詢成功",
    "total_count": 35
    }
    

    # 8、監控管理

    # 8.1、批量坐席狀態查詢

    接口說明:

    按appId查詢坐席當前的登錄、通話中等狀態,主要用于自定義監控坐席狀態功能
    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/call/query_all_agent_state

    請求參數:

    字段編碼 字段名稱 類型 可空
    companyid 公司id string
    appid 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid string
    agents 要查詢的坐席id數組,不傳默認查詢appid下所有的坐席狀態,數組中坐席id不能超過1000個 String[]

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    items 返回對象 Object[] 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    companyid 公司id string
    agentid 坐席id string
    agent_state 坐席狀態 string -1為離線,0為忙碌(忙碌時根據basyCause判定具體是屬于什么類型,115代表后處理狀態),1為空閑,3為通話接通中,99為異常
    appid 應用id string
    call_way 登錄方式 string 登錄方式:2SIP話機;3手機方式
    agent_name 坐席名稱 string
    busy_cause 置忙原因 string

    請求示例:

    {
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
        "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
        // agents字段選填,不傳默認查詢appid下所有坐席的狀態
        "agents": ["49fcb97d2f9a4b69a9aa9a344dc3bc83","279c06647f814a2ebae0212e4c5faaf2","51a68c2376aa4f4e81deb20f9f5b9f9f","51a68c2376aa4f4e81deb"]
    }
    

    返回示例:

    {
        "items": [
            {
                "agent_name": "9q",
                "agent_state": "1",
                "agentid": "279c06647f814a2ebae0212e4c5faaf2",
                "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
                "busy_cause": "",
                "call_way": "2",
                "companyid": "6fa94a074b8646b38f6f5decc7580fe7"
            },
            {
                "agent_name": "2q",
                "agent_state": "1",
                "agentid": "49fcb97d2f9a4b69a9aa9a344dc3bc83",
                "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
                "busy_cause": "",
                "call_way": "2",
                "companyid": "6fa94a074b8646b38f6f5decc7580fe7"
            },
            {
                "agent_name": "3q",
                "agent_state": "-1",
                "agent_type": "2",
                "agentid": "51a68c2376aa4f4e81deb20f9f5b9f9f",
                "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
                "busy_cause": "",
                "companyid": "6fa94a074b8646b38f6f5decc7580fe7"
            }
        ],
        "ret_code": "000000",
        "ret_msg": "success"
    }
    

    # 9、呼叫質檢管理

    詳見質檢模塊,點擊此處跳轉

    # 10、聯系計劃

    # 10.1、新建聯系計劃

    接口說明:

    接口類型:主動調用接口

    接口作用:可通過調用該接口來新建聯系計劃。

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/plan/add_plan

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string
    appid 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid string
    task_name 聯系計劃名稱 string
    service_email 賬號 string
    plan_time 聯系計劃時間 string 平臺中的聯系計劃預約時間,格式:yyyy-MM-dd HH:mm:ss
    remind_time 提醒時間 string 距離預約時間是提醒(分鐘)
    remarks 備注 string 聯系計劃備注
    customer_phone_number 客戶號碼 string 需要提醒的用戶號碼

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    item 返回對象 Object 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    customer_phone_number 用戶號碼 string 需要提醒的用戶號碼
    hidden_flag 號碼隱藏 string 0.不隱藏 1.中間隱藏2.末尾隱藏
    plan_time 聯系計劃時間 long 聯系計劃時間(時間戳)
    remarks 備注 string 聯系計劃的備注
    remind_time 提醒時間 string 距離預約時間是提醒(分鐘)
    task_name 計劃名稱 string -

    請求示例:

    {
    	"companyid": "e59a230a84ba4cee8c40e6e0b00b256a",
        "appid": "14665833144b4bb28f605d6021475fd7",
        "service_email": "9q@sobot.com",
        "task_name": "123123",
        "plan_time": "2019-12-12 00:00:00",
        "remind_time": "100",
        "remarks": "test",
        "customer_phone_number": "13800138000"
    }
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "添加成功",
        "item": {
            "customer_phone_number": "13800138000",
            "hidden_flag": 0,
            "plan_time": 1576080000,
            "remarks": "test",
            "remind_time": "100",
            "task_tame": "123123",
        }
    }
    

    # 11、電銷業務

    # 11.1、添加電銷任務

    接口說明:

    請求及響應報文格式采用JSON格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/tms/add_task

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string
    appid 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid string
    agentid 坐席id string
    task_name 任務名稱 string
    task_desc 任務描述 string
    task_time_type 任務類型 int 1.永久2.自定義
    task_start_time 開始時間 string 任務開始時間(自定義時必填格式為13位時間戳)
    task_end_time 結束時間 string 任務結束時間(自定義時必填格式為13位時間戳)
    hidden_flag 號碼隱藏 int 任務中號碼是否隱藏0.不隱藏 1.中間隱藏2.末尾隱藏

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息
    item 返回對象 Object 詳看下表
    字段編碼 字段名稱 字段類型 備注說明
    companyid 公司id string
    create_time 創建時間 long 時間戳
    createrid 坐席id string 創建電銷任務坐席id
    creater_name 坐席名稱 string 創建電銷任務坐席名稱
    departmentid 組織權限id string 此值暫無使用
    hidden_flag 號碼隱藏 int 任務中號碼是否隱藏0.不隱藏 1.中間隱藏2.末尾隱藏
    task_desc 描述 string 電銷任務描述
    task_end_time 到期時間 long 電銷任務結束時間(時間戳)
    taskid 任務id string 電銷任務id
    task_name 任務名稱 string 電銷任務名稱
    task_start_time 任務開始時間 long 電銷任務開始時間(時間戳)
    task_time_type 任務類型 int 1.永久2.自定義
    update_time 任務跟新時間 long

    請求示例:

     
    {
        "agentid": "8406faf259b94a3e8a753f82715ab671",
        "appid": "3186d4c82ab7421ea36d36fcac9cdbbe",
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
        "hidden_flag": 0,
        "task_desc": "測試任務",
        "task_end_time": "1576139200000",
        "task_name": "test",
        "task_start_time": "1576133200000",
        "task_time_type": 1
    }
    
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功",
        "item": [{
            "companyid": "626632d761be4da2a33c7f26f6e50b41",
            "create_time": 1575428296,
            "createrid": "80ecc892384b4f03b62176d6654ef2e9",
            "creater_name": "name1",
            "departmentid": "80ecc892384b4f03b62176d6654ef2e9",
            "display_type": 0,
            "hidden_flag": 0,
            "task_create_time": 1575464573374,
            "task_desc": "123",
            "task_end_time": 1578067199999,
            "taskid": "80ecc892384b4f03b62176d6654ef2e9",
            "task_name": "test",
            "task_start_time": 1575388800000,
            "task_status": 2,
            "task_time_type": 1
        }]
    }
    

    # 11.2、外呼任務導入數據

    接口說明:

    請求及響應報文格式采用Content-Type: multipart/form-data格式

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/tms/import_data

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string
    appid 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid string
    agentid 坐席id string
    task_name 任務名稱 string 任務名稱
    taskid 任務id string 電銷任務id
    hidden_flag 號碼隱藏 int 任務中號碼是否隱藏0.不隱藏 1.中間隱藏2.末尾隱藏
    file 文件 file 上傳excel文件

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求Headers:

    token: 91f1aa728d75445793abf5b82325f657

    請求示例:

    請求Headers:
    token: 91f1aa728d75445793abf5b82325f657
    
    請求示例:
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="taskid"
     3bd55a4d30714db28b3db2f0f9b2ba21 
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="task_name" test
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="file"; filename="模板副本.xls" Content-Type: application/vnd.ms-excel
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="hidden_flag" 0
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="companyid" 
    6fa94a074b8646b38f6f5decc7580fe7
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="appid" 
    3186d4c82ab7421ea36d36fcac9cdbbe
    ------WebKitFormBoundarykm1L3TCmOvV4grO0 Content-Disposition: form-data; name="agentid" 
    8406faf259b94a3e8a753f82715ab671
    ------WebKitFormBoundarykm1L3TCmOvV4grO0--
    
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "后臺處理中,請到任務隊列查看處理結果!"
    }
    

    # 11.3、外呼任務添加數據

    接口說明:

    請求及響應報文格式采用JSON格式。通過接口創建外呼任務后,延遲幾秒后再調用此接口

    訪問方式:

    POST http://www.gene-tech.cn/comm-open/api/call/5/tms/add_data

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    companyid 公司id string
    appid 呼叫中心的應用id,需要售后查看業務支撐,不同于獲取token的appid string
    agentid 坐席id string
    taskid 任務id string
    titles 列名稱 string 自定義每一列的標題名稱
    hidden_flag 號碼隱藏 int 任務中號碼是否隱藏0.不隱藏 1.中間隱藏2.末尾隱藏,不填默認為0
    details 外呼任務數據列表 Array 數組字段見下表

    details參數

    字段編碼 字段名稱 類型 可空 備注說明
    service_email 客戶名稱 string 智齒賬號,此帳號一定要是正確的智齒賬號且與token實在同一個公司,如果有值將會分配到此帳號下的任務中
    call_number 電話號碼 string 導入的號碼
    cus_field 列名 string 自定義列中的內容,每列以逗號隔開,此處個數要與自定義標題列個數相對應

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功 其余均失敗
    ret_msg 返回信息 string 返回信息

    請求示例:

    
    {
        "agentid": "279c06647f814a2ebae0212e4c5faaf2",
        "companyid": "6fa94a074b8646b38f6f5decc7580fe7",
        "taskid": "ffc92f8df5434f83b59f3f75683125d5",
        "titles": "測試字段1,測試字段2",
        "hidden_flag": 0,
        "details": [
            {
                "call_number": "13800138000",
                "cus_field": "測試1,測試2",
                "service_email": "9q@sobot.com"
            },
            {
                "call_number": "13100000000",
                "cus_field": "測試3,測試4",
                "service_email": "9q@sobot.com"
            }
        ]
    }
    
    

    返回示例:

    {
        "ret_code": "000000",
        "ret_msg": "成功導入2條數據"
    }
    

    # 12、第三方接口調用說明

    # 12.1、IVR信息交互驗證接口

    接口說明:

    智齒呼叫中心IVR將采集到用戶輸入的交互數據上報給企業客戶

    訪問方式:

    智齒以POST請求方式,向客戶配置的數據接收地址上發送數據

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    secretKey 秘鑰 string 客戶在智齒ivr流程頁面配置的秘鑰
    phoneNo 來電號碼 string 來電號碼
    content 輸入內容 string 用戶輸入內容

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    retCode 返回編碼 string 000000成功;999999 失敗
    retMsg 返回信息 string 返回信息

    請求示例:

    http://www.xxxxx.com/data-service/sobotData?secretKey=f31a81e91afdcf0b84dfee82ec2fb196&phoneNo=186123467890&content=3112123
    

    返回示例:

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

    # 12.2、智能路由-調用第三方CRM指定坐席接口

    接口說明:

    在智能路由中設置指定坐席優先接聽時,可通過調用第三方CRM接口,獲取客戶與坐席的指定關系

    訪問方式:

    智齒以 POST請求方式,調用客戶CRM系統

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    secretKey 秘鑰 string 客戶在智齒ivr流程頁面配置的秘鑰
    phoneNo 來電號碼 string 來電號碼

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    retCode 返回編碼 string 000000成功;999999 失敗
    retMsg 返回信息 string
    phoneNo 來電號碼 string
    serviceEmail 客服郵箱賬號 string 客服郵箱賬號(可以登錄智齒呼叫中心的客服郵箱賬號,可聯系售后人員獲取)

    請求示例:

    http://www.xxxxx.com/crm-service/sobotData?secretKey=f31a81e91afdcf084dfee82ec2fb196&phoneNo=186123467890
    

    返回示例:

    {
        "retCode":"000000",
        "phoneNo":"186123467890",
        "serviceEmail":"zhangsan@sobot.com",
        "retMsg":"成功!"
    }
    

    # 12.3、智能路由-調用第三方CRM判斷VIP接口

    接口說明:

    通過接口判斷來電號碼是否是VIP以便實現VIP優先排隊

    訪問方式:

    智齒以 POST請求方式,調用客戶CRM系統

    請求參數:

    字段編碼 字段名稱 類型 可空 備注說明
    secret_key 秘鑰 string 客戶在智齒ivr流程頁面配置的秘鑰
    user_tel 號碼 string 來電號碼
    ivr_node 按鍵名稱 string 轉人工節點的名稱

    返回參數:

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功;999999 失敗
    ret_msg 返回信息 string
    user_tel 號碼 string
    user_level 客戶級別 int 0:普通;1:VIP

    請求示例:

    http://www.xxxxx.com/crm-service/sobotData?secret_key=f31a81e91afdcf084dfee82ec2fb196&user_tel=186123467890
    

    返回示例:

    {
        "ret_code":"000000",
        "ret_msg":"成功!",
        "user_tel":"186123467890",
        "user_level":1
    }
    

    # 12.4、 智能路由-調用第三方指定路由接口

    接口說明: 所有轉人工節點通過接口確定路由 訪問方式: 智齒以 POST請求方式,調用客戶系統

    請求參數:

    字段編碼 字段名稱 字段類型 可空 備注說明
    secret_key 秘鑰 string 客戶在智齒ivr流程頁面配置的秘鑰
    caller 來電號碼 string 來電號碼
    called 被叫號碼 string 被叫號碼
    direction 呼叫方向 String 呼叫方向,現在只有“in”
    ivrPath Ivr軌跡 Array
    ivrPath. ivrName Ivr節點名稱 String
    ivrPath. key 用戶進入節點的按鍵 String

    返回參數

    字段編碼 字段名稱 字段類型 備注說明
    ret_code 返回編碼 string 000000成功;999999 失敗
    ret_msg 返回信息 string
    groupIds 返回的技能組id列表 Array of string 返回的技能組id列表,最多三個。
    請求示例
    {
      "secret_key": "aaadddccceeefffggg",
      "caller": "13800138000",
      "called": "010888888",
      "direction": "in",
      "ivrPath": [
        {
          "ivrName": "歡迎語",
          "key": null
    },
    {
          "ivrName": "轉產品部門",
          "key": “1”
        }
      ]
    }
    
    返回示例:
    {
      "ret_code": "000000",
      "ret_msg": "成功!",
      "groupIds": [
    "aa8ce5f7c37244a0a241827e26e34653_4","aa8ce5f7c37244a0a241827e26e34653_4"
      ]
    }
    

    # 12.5、 智能路由-調用第三方CRM呼轉外線號碼接口

    接口說明:

    此接口使用formdata方式訪問。

    訪問方式:

     POST:xxx.xxx.xx/   此處為客戶接口
    

    請求參數

    字段編碼 字段名稱 字段類型 可空 備注說明
    secret_key 秘鑰 string 企業在智齒系統中配置的秘鑰,生成方式:companyId+caller 進行MD5加密操作,作為交互的安全驗證
    caller 客戶號碼 string 呼入場景為主叫號碼。呼出場景為被叫號碼
    called 外顯號碼 string 企業在智齒系統中配置的外顯號碼,包含呼入和呼出場景
    call_direction 呼叫方向 string 呼入為in、呼出為out。目前只支持“in”
    ivr_trajectory Ivr軌跡數組 數組<Ivr軌跡> 數組的元素可能0-n個

    Ivr軌跡

    字段編碼 字段名稱 字段類型 可空 備注說明
    ivr_name ivr節點名稱 string
    key 用戶進入節點的按鍵 string

    返回字段

    字段編碼 字段名稱 字段類型 可空 備注說明
    retCode 返回編碼 string 000000成功
    retMsg 返回信息 string 錯誤提示、成功詳解參照下表
    item 第三方號碼 string IVR中呼叫轉移的第三方號碼。支持普通固話號碼和手機號碼,其中固話號碼不支持總機的分機號碼、短號、95等。固話號碼格式示例01087654321,手機號碼示例13511112222
    請求示例:
    {
    	"secret_key": "xxxx",
    	"caller": "xxxxx",
    	"called": "xxxx",
    	"call_direction": "xxxxx",
        "ivr_trajectory": [{
           "ivr_name":"xxxxx",
           "key":"xxxxx"
        }]
    }
    
    返回示例:
    {?  "retMsg":"成功返回",
    ??  "retCode":"000000",
        "item":"xxxxxxxx",
    }
    
    
    

    # 13、錯誤碼

    # 13.1、系統錯誤碼

    代碼 含義
    000000 請求成功
    900001 token為空
    900002 token已失效或不存在,請重新獲取
    900003 signature錯誤
    900004 沒有找到公司的api配置信息
    900005 被限制訪問
    900006 沒有找到公司信息
    900007 token信息為空,請重新獲取
    900008 沒有找到公司超級管理員信息
    910000 JSON數據格式錯誤
    910001 參數錯誤
    910002 接口調用失敗
    910003 請求參數為空
    910004 服務返回空值
    910010 公司id為空
    910011 坐席id為空
    910012 APPid為空
    999999 系統錯誤

    # 13.2、應用錯誤

    代碼 含義
    300001 坐席不存在或未登錄
    300002 密碼錯誤
    300003 用戶已經登錄
    300004 分機已經被使用
    300005 轉接號碼沒有設置
    300006 坐席已注銷
    300007 被叫號碼不正確
    300008 當前坐席已經在呼叫中
    300009 撥打號碼為登錄號碼
    300010 轉接類型沒有設置
    300011 轉接組id沒有設置
    300012 appid未設置
    300013 超時時間未設置
    300014 未查詢到呼叫信息
    300015 非本機ip
    300016 當前坐席不在通話中
    300017 非離線狀態不能登錄
    300018 當前狀態外呼存在異常,請電話條離線后重新登錄恢復正常狀態
    300019 當前坐席正在通話中,無法注銷
    300020 坐席當前處于離線狀態,無法外呼
    300021 三方咨詢類型未設置
    300022 被咨詢坐席不在空閑狀態
    300023 取消方標識未設置
    300024 狀態非忙碌或鎖定
    300025 通話id未設置
    300026 正在為您分配來電電話,無法切換狀態,請稍后
    300027 正在為您分配來電電話,請稍后再進行外呼
    300028 外顯號碼為空
    300029 當前為離線狀態,無法切換狀態
    300030 登錄呼叫中心失敗,已達到您購買呼叫中心的最大登錄上限
    300031 當前客戶已掛斷
    300032 呼出失敗,請稍后再試
    300033 VOIP話機未注冊
    300034 未查詢到坐席對應賬號信息
    300035 未查詢到坐席信息
    300036 未查詢到線路信息
    300037 無FS可用資源
    300038 APP信息校驗錯誤
    300039 APP信息校驗錯誤
    300040 坐席已登出
    300041 該分機號已被占用!
    300042 當前話機已綁定該坐席!
    300043 該人員不在組織結構中
    300044 客服賬號未綁定SIP分機賬號
    300045 客服ID已經綁定過SIP話機賬號
    300046 客服ID已經綁定過SIP話機賬號
    300047 僅適用SIP分機一對一綁定到客服的模式
    300048 SIP分機賬號并沒有綁定任何客服ID
    300049 已綁定的客服ID未離線簽出呼叫中心
    300050 未查詢到當前任務信息

    # 13.3、賬號錯誤

    代碼 含義
    300100 公司不存在
    300102 非正式版本無法創建應用。
    300103 不是第三方企業。

    # 13.4、分機錯誤

    代碼 含義
    300200 無FS可用資源
    200201 APP信息校驗錯誤
    200202 坐席不存在或已被禁用!
    200203 分機不存在或已被禁用!
    300204 分機號碼為空
    300205 創建分機失敗,已達到最大分機許可
    300206 count數為空
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>