Skip to main content

录音管理

获取录音数据接口

接口地址

POST A: http://m.icsoc.net/v2/wintelapi/record/recordlist
POST B: http://m.icsoc.net/v3/api/record/recordlist(只适用老板满意度)

接口参数

字段类型是否必填示例值说明
vcc_codeString是123456企业代码
infoString是{ "filter":{ "start_time":"2015-12-01 00:00:00", "end_datetime":"2015-12-01 00:00:00", "ag_num_in":"1002", "call_type":1, "ag_phone":"8004", "cus_phone":"182****1112", "ssecs":20, "esecs":50, "que_id":1, "end_result":0, "evaluates":2, "group_id":0, "call_id":"0"} }筛选条件

filter参数说明

code说明
start_time开始时间
end_datetime结束时间
ag_num_in坐席工号（如果多个逗号分隔）
call_type呼叫类型(1呼出2呼入)
ag_phone坐席号码
cus_phone客户号码
ssecs通话时长（最小，单位：秒）
esecs通话时长（最大，单位：秒）
que_id技能组id
end_result呼叫结果（见下面附加说明）
evaluates满意度评价（见下面附加说明）
call_idcall_id（call_id仅POST B支持）

结果编码说明

code说明
402企业账号错误
403info格式非json
404权限内无任何数据
200ok

结果示例

{
    "total": 1,
    "page": 1,
    "page_size": 5000,
    "total_pages": 1,
    "has_more": false,
    "search_after": null,
    "data": [{
        "id": "149860",
        "server_num": "010****4346",
        "server_400": "400****999",
        "ag_id": 0,
        "agcdr_id": "6996719048427995137",
        "ag_phone": "ROBOT",
        "cus_phone": "132****6728",
        "que_name": "",
        "conn_secs": 5,
        "ag_num": "",
        "ag_name": "",
        "ag_nickname": "",
        "call_id": "6996719048427995136",
        "group_id": 0,
        "start_time": "2022-11-11 14:23:48",
        "end_time": "2022-11-11 14:23:53",
        "call_type": "呼入",
        "evaluate": "客户挂机",
        "endresult": "用户挂断",
        "que_id": 0,
        "vcc_id": 2001450,
        "record_file_url": "//records-test.icsoc.net/saas_test/call/40/20221111/2001450/51/20221111142348-6996719048427995136-55--.mp3",
        "dept_id": 0,
        "dept_name": ""
    }],
    "totalPage": 1,
    "code": 200,
    "message": "ok"
}

结果字段说明

字段说明
server_num服务号码
server_400400号码
ag_id坐席ID
agcdr_id呼叫通道唯一标识
vcc_id企业ID
id录音ID
ag_phone坐席分机号
cus_phone客户号码
que_id技能组ID
que_name技能组名称
record_file_url录音地址
conn_secs通话时长
ag_num坐席工号
ag_name坐席姓名
ag_nickname坐席昵称
call_id呼叫ID
group_id业务组ID
start_time开始时间
end_time结束时间
call_type呼叫类型
evaluate评价
endresult呼叫结果
dept_id部门ID
dept_name部门名称

evaluate(评价)说明

状态说明
-1客户挂机
-2超时未评价
-3评价失败
-4坐席挂机
00
11
22
33
44
55
66
77
88
99

endresult(呼叫结果)说明

状态说明
0接通
1振铃放弃
2未接

新版满意度录音数据接口

接口地址

post http://m.icsoc.net/v3/api/record/newRecordList(适用新老版满意度,2020-06-19开放)

接口参数

字段类型是否必填示例值说明
vcc_codeString是123456企业代码
infoString是{ "filter":{ "start_time":"2015-12-01 00:00:00", "end_datetime":"2015-12-01 12:00:00", "ag_num_in":"1002", "call_type":1, "ag_phone":"8004", "cus_phone":"182****1112", "ssecs":20,//时长大于 "esecs":50,//时长小于 "que_id":1, "endresult":0, "evaluates":2, "group_id":0, "call_id":"0"} }筛选条件

filter参数说明

code说明
start_time开始时间
end_datetime结束时间
ag_num_in坐席工号
call_type呼叫类型(1呼出2呼入)
ag_phone坐席号码
cus_phone客户号码
que_id技能组id
call_idcall_id
group_id业务组id
ssecs录音时长大于
esecs录音时长小于
endresult挂机原因（见下面endresult字段说明）
evaluates满意度(例: "evaluates":"-4" 或 "evaluates":"evaluate-782-1-1-2-0")

endresult(结果)说明

状态说明
1主叫放弃
2坐席未接
3排队超时
4排队溢出
5无坐席溢出
11用户挂机
12坐席挂断
21未转技能组

结果编码说明

code说明
402企业账号错误
403info格式非json
404权限内无任何数据
200ok

结果示例

自定义满意度返回

  {
      "total": 2,
      "page": 1,
      "page_size": 5000,
      "total_pages": 1,
      "has_more": false,
      "search_after": null,
      "data": [
          {
              "id": "6645530803184902145",
              "evaluate": "按键 1-按键 2|按键 3-按键 4",
              "evaluate_digits": "2|4",
              "endresult": "坐席挂断",
              "autoEvaluate": {
                  "evaluate-782-1": "按键 1-按键 2",
                  "evaluate-782-2": "按键 3-按键 4"
              },
              "server_num": "010****4343",
              "server_400": "400****56",
              "ag_id": 1013696,
              "agcdr_id": "6645530581520232449",
              "ag_phone": "1233",
              "cus_phone": "158****8865",
              "que_name": "CTIPlus",
              "conn_secs": 6,
              "ag_num": "1000",
              "ag_name": "哈哈***cvc",
              "call_id": "6645530581516038144",
              "group_id": 174,
              "start_time": "2020-03-17 12:05:59",
              "end_time": "2020-03-17 12:06:15",
              "call_type": "呼出"
          }
      ]
  }

挂机等场景满意度返回

  {
        "total": 1,
        "page": 1,
        "page_size": 5000,
        "total_pages": 1,
        "has_more": false,
        "search_after": null,
        "data": [
            {
                "id": "1531448336897310722",
                "evaluate_digits": "",
                "evaluate": "坐席挂机",
                "endresult": "坐席挂断",
                "autoEvaluate": {
                    "evaluate-2000791-1": "坐席挂机"
                },
                "server_num": "01058545433",
                "server_400": "",
                "ag_id": 438512,
                "agcdr_id": "7000383099833966592",
                "ag_phone": "1000",
                "cus_phone": "18630030646",
                "que_name": "",
                "conn_secs": 2,
                "ag_num": "10003",
                "ag_name": "tsx",
                "call_id": "7000383075691552768",
                "group_id": 0,
                "start_time": "2022-11-21 17:03:11",
                "end_time": "2022-11-21 17:03:16",
                "call_type": "呼入"
            }
      ]
  }

结果字段说明

字段说明
id录音ID
evaluate评价(当存在自定义满意度时, evaluate的值为自定义满意度评价时的最后一个按键id可忽略)
evaluate_digits客户实际按键顺序
endresult呼叫结果（见下方附加说明）
autoEvaluate自定义满意度(json格式, key由前缀'evaluate-',vccid 和链路id组成,value为自定义满意度链路)
server_num服务号码
server_400400号码
ag_id坐席ID
agcdr_id呼叫通道唯一标识
ag_phone坐席分机号
cus_phone客户号码
que_name技能组名称
conn_secs通话时长
ag_num坐席工号
ag_name坐席姓名
call_id呼叫ID
group_id业务组ID
start_time开始时间
end_time结束时间
call_type呼叫类型（1：外呼，2：呼入，3：呼出转接，4：呼入转接，5：呼出拦截，6：呼入拦截，7：被咨询，9：监听，11：呼叫客户，12：IVR转技能组，13：被咨询，14：监听，15：IVR转坐席，18：被多方，20：坐席转技能组，53：被转接（咨询转接），52：被内部直呼，51：内部直呼，54：强拆）

endresult(结果)说明

状态说明
1主叫放弃
2坐席未接
3排队超时
4排队溢出
5无坐席溢出
11用户挂机
12坐席挂断
21未转技能组

获取满意度配置接口

接口地址

POST http://m.icsoc.net/v3/api/agcdr/query/evaluate/tree

结果编码说明

code说明
401授权不通过,请检查token
500系统异常
200ok

结果示例

{
    "code": "200",
    "result": [
        {
            "id": "-4",
            "name": "坐席挂机"
        },
        {
            "id": "-1",
            "name": "客户挂机"
        },
        {
            "id": "-6",
            "name": "转接"
        },
        {
            "id": "-7",
            "name": "强拆"
        },
        {
            "id": "-8",
            "name": "坐席强退"
        },
        {
            "id": "-3",
            "name": "评价失败"
        },
        {
            "id": "evaluate-782-1-1-1",
            "name": "满意",
            "child": [
                {
                    "id": "evaluate-782-1-1-2-0",
                    "name": "态度不错"
                }
            ]
        },
        {
            "id": "evaluate-782-1-2-0",
            "name": "响应快"
        }
    ],
    "success": true
}

播放、下载录音接口

接口地址

GET http://m.icsoc.net/v2/wintelapi/record/playrecord

接口参数

参数说明备注
vcc_code企业代码必须
call_id呼叫ID必须
ag_id坐席ID可选
result_type是否返回语音地址的Json格式(1:返回,0:不返回)可选
record_type录音格式(mp3,wav)可选

结果编码说明

code说明
401企业账号为空
402企业账号错误
403call_id为空
406录音前缀不存在

结果示例

`录音文件` 20151208184307-35362-200500-18511400198-8005.mp3
result_type=1时, {"path":"http:\/\/records.icsoc.net\\saas_ali\\call\\2\/20150324\/20150324140402-1000522-16-59000300-8001.mp3"}

获取留言数据接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/voice/list

接口参数

字段类型是否必填示例值说明
infoString是{ "filter":{ "start_time":"2015-12-01 00:00:00", "end_time":"2015-12-03 12:00:00", "caller":"58*01", "called":"182**1112", "listen_mark":0, "down_mark":0, "ssecs":20, "esecs":50 } }筛选条件

info 参数说明

字段类型是否必填示例值说明
start_timeString否2015-12-01 00:00:00起始时间
end_timeString否2015-12-01 00:00:00起始时间
callerString否5829101主叫号码
calledString否182****0232被叫号码
listen_markInteger否0是否收听（0：否，1：是）
down_markInteger否0是否下载（0：否，1：是）
ssecsInteger否10起始留言时长
esecsInteger否50结束留言时长

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403info格式非json
200ok

结果示例

{
    "total": 1,
    "page": 1,
    "page_size": 5000,
    "total_pages": 1,
    "has_more": false,
    "search_after": null,
    "data": [
        {
            "vcc_id": "2001450",
            "call_id": 6967670514873696256,
            "caller": "186****0646",
            "called": "010****346",
            "rec_secs": 71,
            "start_time": "2022-08-23 10:35:03",
            "record_file_url": "//records-test.icsoc.net/saas_test/call/40/20220823/2001450/89/20220823103529-6967670514873696256-4958-18630030646-.mp3"
        }
    ],
    "code": 200,
    "message": "ok"
}

结果字段说明

字段说明
vcc_id企业ID
call_id通话ID
caller主叫号码
called被叫号码
rec_secs留言时长
start_time留言时间
record_file_url留言文件地址

播放、下载留言接口

接口地址

GET http://m.icsoc.net/v2/wintelapi/new/voice/playvoice

接口参数

参数说明备注
call_id呼叫ID必须

结果编码说明

code说明
403call_id为空
404录音文件不存在
200ok

结果示例

``录音文件`` 20151208184307-35362-200500-18511400198-8005.mp3