获取录音数据接口
接口地址
POST A: http://m.icsoc.net/v2/wintelapi/record/recordlist
POST B: http://m.icsoc.net/v3/api/record/recordlist(只适用老板满意度)
接口参数
参数 | 说明 | 备注 |
vcc_code | 企业代码 | 必须 |
info | 筛选条件,示例:{ "filter":{ "start_time":"2015-12-01 00:00:00", "end_time":"2015-12-01 12:00:00", "ag_num":"1002", "call_type":1, "ag_phone":"8004", "cus_phone":"18292011112", "ssecs":20,//时长大于 "esecs":50,//时长小于 "que_id":1, "end_result":0, "evaluates":2,//满意度评价 "id":"12,2,10", "group_id":0, "call_id":"0"} } | 可选 |
filter参数说明
code | 说明 |
start_time | 开始时间 |
end_time | 结束时间 |
ag_num | 坐席工号 |
call_type | 呼叫类型(1呼出2呼入) |
cus_phone | 客户号码 |
que_id | 技能组id |
call_id | call_id(call_id仅POST B支持) |
结果编码说明
code | 说明 |
401 | 企业代码为空 |
402 | 企业代码不存在 |
403 | info格式非json |
404 | 权限内无任何数据 |
200 | ok |
结果示例
{
"code": 200,
"message": "ok",
"total": "1",
"data": [{
"server_num": "59222702",
"ag_id": "200500",
"id": "13260",
"ag_phone": "8005",
"cus_phone": "18511400198",
"que_name": "\u547c\u5165\u547c\u51fa\u6280\u80fd\u7ec4",
"conn_secs": "43",
"ag_num": "\u738b\u6210 1001",
"call_id": "35362",
"group_id": "0",
"start_time": "2015-12-08 18:43:07",
"end_time": "2015-12-08 18:43:57",
"call_type": "\u547c\u51fa",
"evaluate": "\u5ba2\u6237\u6302\u673a",
"endresult": "\u7528\u6237\u6302\u65ad"
}],
"totalPage": 1
}
结果字段说明
字段 | 说明 |
server_num | 服务号码 |
ag_id | 坐席ID |
id | 录音ID |
ag_phone | 坐席分机号 |
cus_phone | 客户号码 |
que_name | 技能组名称 |
record_file | 录音地址 |
conn_secs | 通话时长 |
ag_num | 坐席工号 |
call_id | 呼叫ID |
group_id | 业务组ID |
start_time | 开始时间 |
end_time | 结束时间 |
call_type | 呼叫类型 |
evaluate | 评价 |
endresult | 呼叫结果 |
evaluate(评价)说明
状态 | 说明 |
-1 | 客户挂机 |
-2 | 超时未评价 |
-3 | 评价失败 |
-4 | 坐席挂机 |
0 | 0 |
1 | 1 |
2 | 2 |
3 | 3 |
4 | 4 |
5 | 5 |
6 | 6 |
7 | 7 |
8 | 8 |
9 | 9 |
endresult(呼叫结果)说明
新版满意度录音数据接口
接口地址
post http://m.icsoc.net/v3/api/record/newRecordList(适用新老版满意度,2020-06-19开放)
接口参数
参数 | 说明 | 备注 |
vcc_code | 企业代码 | 必须 |
info | 筛选条件,示例:{ "filter":{ "start_time":"2015-12-01 00:00:00", "end_time":"2015-12-01 12:00:00", "ag_num":"1002", "call_type":1, "ag_phone":"8004", "cus_phone":"18292011112", "ssecs":20,//时长大于 "esecs":50,//时长小于 "que_id":1, "end_result":0, "evaluates":2, "group_id":0, "call_id":"0"} } | 可选 |
filter参数说明
code | 说明 |
start_time | 开始时间 |
end_time | 结束时间 |
ag_num | 坐席工号 |
call_type | 呼叫类型(1呼出2呼入) |
cus_phone | 客户号码 |
que_id | 技能组id |
call_id | call_id |
group_id | 业务组id |
ssecs | 录音时长大于 |
esecs | 录音时长小于 |
evaluates | 满意度(例: "evaluates":"-4" 或 "evaluates":"evaluate-782-1-1-2-0") |
结果编码说明
code | 说明 |
401 | 企业代码为空 |
402 | 企业代码不存在 |
403 | info格式非json |
404 | 权限内无任何数据 |
200 | ok |
结果示例
{
{
"code": "200",
"message": "ok",
"totalPage": 1,
"page": 1,
"total": 2,
"data": [
{
"id": "6645530803184902145",
"evaluate": "4",
"endresult": "坐席挂断",
"autoEvaluate": {
"evaluate-782-1": "按键 1-按键 2",
"evaluate-782-2": "按键 3-按键 4"
},
"server_num": "01057624343",
"server_400": "400123456",
"ag_id": 1013696,
"agcdr_id": "6645530581520232449",
"ag_phone": "1233",
"cus_phone": "15827598865",
"que_name": "CTIPlus",
"conn_secs": 6,
"ag_num": "1000",
"ag_name": "哈哈xvxcvc",
"call_id": "6645530581516038144",
"group_id": 174,
"start_time": "2020-03-17 12:05:59",
"end_time": "2020-03-17 12:06:15",
"call_type": "呼出"
}
]
}
{
"code": "200",
"message": "ok",
"totalPage": 1,
"page": 1,
"total": 1,
"data": [
{
"id": "6656384382997143553",
"evaluate": "坐席挂机",
"endresult": "坐席挂断",
"server_num": "01057624343",
"server_400": "400123456",
"ag_id": 1013658,
"agcdr_id": "6656384295504064512",
"ag_phone": "5470",
"cus_phone": "17786365832",
"que_name": "",
"conn_secs": 6,
"ag_num": "5470",
"ag_name": "yansongda",
"call_id": "6656384278399692800",
"group_id": 0,
"start_time": "2020-04-16 10:54:45",
"end_time": "2020-04-16 10:55:06",
"call_type": "呼入"
}
]
}
}
结果字段说明
字段 | 说明 |
server_num | 服务号码 |
ag_id | 坐席ID |
id | 录音ID |
ag_phone | 坐席分机号 |
cus_phone | 客户号码 |
que_name | 技能组名称 |
record_file | 录音地址 |
conn_secs | 通话时长 |
ag_num | 坐席工号 |
call_id | 呼叫ID |
group_id | 业务组ID |
start_time | 开始时间 |
end_time | 结束时间 |
call_type | 呼叫类型 |
evaluate | 评价(当存在自定义满意度时, evaluate的值为自定义满意度评价时的最后一个按键id可忽略) |
endresult | 呼叫结果 |
autoEvaluate | 自定义满意度(json格式, key由前缀'evaluate-',vccid 和链路id组成,value为自定义满意度链路) |
获取满意度配置接口
接口地址
GET http://m.icsoc.net/v3/api/agcdr/query/evaluate/tree
结果编码说明
code | 说明 |
401 | 授权不通过,请检查token |
500 | 系统异常 |
200 | ok |
结果示例
{
"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 | 企业代码不存在 |
403 | call_id为空 |
404 | call_id格式不对,要求为数字 |
405 200 | 录音文件不存在 |
结果示例
`录音文件` 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
接口参数
参数 | 说明 | 备注 |
vcc_code | 企业代码 | 必须 |
info | 筛选条件,示例: { "filter":{ "start_time":"2015-12-01 00:00:00", "end_time":"2015-12-01 12:00:00", "caller":"5829101",//主叫 "called":"18292011112",//被叫 "listen_mark":"18292011112",//是否已收听 "down_mark":"18292011112",//是否已下载 "ssecs":20,//时长大于 "esecs":50//时长小于 } } | 可选 |
结果编码说明
code | 说明 |
401 | 企业代码为空 |
402 | 企业代码不存在 |
403 200 | info格式非json |
结果示例
{"code":200,"message":"ok","total":"0","data":[],"totalPage":0}
播放、下载留言接口
接口地址
GET http:
接口参数
参数 | 说明 | 备注 |
vcc_code | 企业代码 | 必须 |
call_id | 呼叫ID | 必须 |
结果编码说明
code | 说明 |
401 | 企业代码为空 |
402 | 企业代码不存在 |
403 | call_id为空 |
404 | call_id格式不对,要求为数字 |
405 | 录音文件不存在 |
200 | |
结果示例
``录音文件`` 20151208184307-35362-200500-18511400198-8005.mp3