其他相关接口
获取企业绑定的中继号码
接口地址
GET https://m.icsoc.net/v2/wintelapi/trunks/lists
入参
参数 | 类型 | 说明 | 必填 |
---|---|---|---|
code | string | 中继号区号 | 否 |
per_page | string | 每页数量,默认10 | 否 |
current_page | string | 当前页,默认1 | 否 |
出参
参数 | 类型 | 说明 |
---|---|---|
code | int | 0 为成功,其它均为失败,参考 message |
message | string | 提示 |
data | Data[] | 数据 |
Data 格式
参数 | 类型 | 说明 |
---|---|---|
current_page | int | 当前页 |
total_page | int | 总页数 |
per_page | int | 每页数量 |
total | int | 总数据量 |
empty | bool | 是否无数据 |
results | Result[] | 数据 |
Result 格式
字段 | 说明 |
---|---|
phone | 中继号 |
code | 号码归属地 code |
city | 号码归属地 |
type | 号码类型,1-95号;2-中继号;3-手机号 |
type_string | 号码类型 |
结果示例
{
"code": 0,
"message": "success",
"data": {
"current_page": 1,
"total_page": 1,
"per_page": 10,
"total": 4,
"empty": false,
"results": [
{
"phone": "02766660012",
"code": "027",
"city": "湖北 武汉",
"type": 2,
"type_string": "中继号"
}
]
}
}
获取企业所有绑定的中继号码
接口地址
GET https://m.icsoc.net/v2/wintelapi/trunks/all
入参
参数 | 类型 | 说明 | 必填 |
---|---|---|---|
code | string | 中继号区号 | 否 |
出参
参数 | 类型 | 说明 |
---|---|---|
code | int | 0 为成功,其它均为失败,参考 message |
message | string | 提示 |
data | Data[] | 数据 |
Data 格式
字段 | 说明 |
---|---|
phone | 中继号 |
code | 号码归属地 code |
city | 号码归属地 |
type | 号码类型 |
type_string | 号码类型 |
结果示例
{
"code": 0,
"message": "success",
"data": [
{
"phone": "01012345670",
"code": "010",
"city": "北京 北京",
"type": 2,
"type_string": "中继号"
},
{
"phone": "95187",
"code": "",
"city": "",
"type": 1,
"type_string": "95号码"
},
{
"phone": "18512345678",
"code": "027",
"city": "湖北 武汉",
"type": 3,
"type_string": "手机号码"
}
]
}
获取企业虚拟号绑定的中继号码接口
接口地址
GET https://m.icsoc.net/v2/wintelapi/virtual/bindings/lists
入参
字段 | 说明 | 必填 |
---|---|---|
virtual | 虚拟中继号 | 是 |
per_page | 每页数量,默认1000条 | 否 |
current_page | 当前页,默认1 | 否 |
出参
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
code | int | 返回代码。0 为成功,其它均为不成功 | 是 |
message | string | 提示 | 是 |
data | Data | 结果 |
Data 定义
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
per_page | int | 每页数量 | 是 |
current_page | int | 当前页 | 是 |
total | int | 总条数 | 是 |
total_page | int | 总页数 | 是 |
results | string[] | 结果 | 是 |
结果示例
{
"code":0,
"message":"success",
"data":{
"per_page":1000,
"current_page":1,
"total":1,
"total_page":1,
"results":[
"01012345678"
]
}
}
获取置忙原因数据接口
接口地址
GET http://m.icsoc.net/v2/wintelapi/busyreason/list
接口参数
参数 | 说明 | 备注 |
---|---|---|
jsonpcallback | 设置jsonp调用的回调的方法名 | 可选 |
结果编码说明
code | 说明 |
---|---|
401 | 企业代码为空 |
402 | 企业代码不存在 |
200 | ok |
结果示例
callback({"code":200,"message":"ok","data":[{"id":"58","vcc_id":"2","ag_stat":"1","stat_reason":"\u5c0f\u4f11"},{"id":"59","vcc_id":"2","ag_stat":"1","stat_reason":"\u5348\u4f11"},{"id":"73","vcc_id":"2","ag_stat":"1","stat_reason":"\u4f1a\u8bae"},{"id":"74","vcc_id":"2","ag_stat":"1","stat_reason":"\u5fd9\u788c\u4e2d"},{"id":"76","vcc_id":"2","ag_stat":"1","stat_reason":"\u5c31\u9910"}]})
结果字段说明
字段 | 说明 |
---|---|
id | 明细ID |
vcc_id | 企业ID |
ag_stat | 原因类型(1登录2置忙) |
stat_reason | 原因名称 |
获取中继话单接口
接口地址
Content-Type: application/json
POST https://m.icsoc.net/v2/wintelapi/cdr/trunk/lists
入参
字段 | 说明 | 必填 |
---|---|---|
call_id | 通话id。此参数和 timestart* 必选其一 | 特殊可选 |
time_start_begin | 通话开始起始时间。此参数和 call_id 必选其一,且时间范围不能超过1个月 | 特殊可选 |
time_start_end | 通话开始结束时间。此参数和 call_id 必选其一,且时间范围不能超过1个月 | 特殊可选 |
per_page | 每页数量,默认100条 | 否 |
current_page | 当前页,默认1 | 否 |
出参
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
code | int | 返回代码。0 为成功,其它均为不成功 | 是 |
message | string | 提示 | 是 |
data | Data | 结果 |
Data 定义
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
per_page | int | 每页数量 | 是 |
current_page | int | 当前页 | 是 |
total | int | 总条数 | 是 |
total_page | int | 总页数 | 是 |
results | Result[] | 结果 | 是 |
Result 定义
字段 | 类型 | 说明 |
---|---|---|
vcc_id | int | 企业id |
vcc_code | string | 企业code |
ag_id | int | 坐席id |
call_id | string | 呼叫id |
call_type | int | 呼叫类型 |
call_result | int | 呼叫结果 |
trunk_num | string | 中继号码 |
user_num | string | 用户号码 |
user_area_code | string | 用户归属地区号 |
time_start | string | 呼叫时间 |
time_ring | string | 振铃事件 |
time_answer | string | 应答时间 |
time_conn | string | 双方接通时间 |
time_hangup | string | 挂机时间 |
dur_ring | int | 用户振铃周期 |
dur_ring2 | int | 从呼叫开始到用户振铃结束周期 |
dur_answer | int | 用户应答周期 |
dur_conn | int | 用户与坐席接通周期 |
dur_all | int | 从呼叫开始到挂机周期 |
user_data | string | 用户数据 |
枚举
call_type 枚举
枚举 | 说明 |
---|---|
1 | 手动外呼外线 |
2 | 呼入 |
3 | 咨询外线 |
4 | 转电话 |
5 | 自动外呼 |
6 | 接口外呼 |
10 | 手动外呼主叫 |
11 | 外呼坐席 |
12 | 技能组转坐席 |
13 | 咨询坐席 |
14 | 监听坐席 |
15 | 转坐席 |
16 | 机器人 |
结果示例
{
"code":0,
"message":"success",
"data":{
"per_page":1000,
"current_page":1,
"total":1,
"total_page":1,
"results":[
{
"vcc_id": 782,
"vcc_code": "wuhan",
"ag_id": 1013658,
"call_id": "6800303306284609536",
"call_type": 1,
"call_type_name": "手动外呼",
"call_result": 1,
"call_result_name": "未接通",
"trunk_num": "01088881056",
"user_num": "0185xxxx2456",
"user_area_code": "0755",
"time_start": "2021-05-18 14:17:34",
"time_ring": "2021-05-18 14:17:36",
"time_answer": "0000-00-00 00:00:00",
"time_conn": "0000-00-00 00:00:00",
"time_hangup": "2021-05-18 14:17:44",
"dur_ring": 8,
"dur_ring2": 10,
"dur_answer": 0,
"dur_conn": 0,
"dur_all": 10,
"user_data": ""
}
]
}
}
更新通话记录业务标识
接口地址
POST https://m.icsoc.net/v2/wintelapi/call/updateUserData
入参
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
call_id | string | 通话id | 是 |
business_status | string | 0未成功,1成功 | 是 |
user_data | string | json 的 string 类型,例如: {\"name\": \"foo\"} | 否 |
注意:
如果 user_data 中也存在 business_status,则最终数据以 user_data 中为准
举例
curl -X POST \
https://m.icsoc.net/v2/wintelapi/call/updateUserData \
-H 'Content-Type: application/x-www-form-urlencoded' \
-H 'Authorization: Bearer 434233e4631417de4da122f4275bf76854004f68' \
-d 'call_id=123213432548097891&business_status=1'
结果示例
{
"code": 200,
"message": "更新成功"
}
结果字段说明
字段 | 说明 |
---|---|
code | 200更新成功 |
message | 提示信息 |
获取vos话单接口
接口地址
Content-Type: application/json
POST https://m.icsoc.net/v3/portal/api/vos/list
入参
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
call_id | string | 通话id | 可选 |
time_start_begin | datetime | 通话开始起始时间。默认当天 00:00:00 格式: 2023-06-12 00:00:00 时间范围不能超过1个月 | 可选 |
time_start_end | datetime | 通话开始结束时间。默认当天 23:59:59 格式: 2023-06-12 23:59:59 时间范围不能超过1个月 | datetime |
per_page | int | 每页数量,默认100条 最大每页 500条 | 否 |
current_page | int | 当前页,默认1 | 否 |
出参
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
code | int | 返回代码。0 为成功,其它均为不成功 | 是 |
message | string | 提示 | 是 |
data | Data | 结果 |
Data 定义
字段 | 类型 | 说明 | 必填 |
---|---|---|---|
per_page | int | 每页数量 | 是 |
current_page | int | 当前页 | 是 |
total | int | 总条数 | 是 |
total_page | int | 总页数 | 是 |
results | Result[] | 结果 | 是 |
Result 定义
字段 | 类型 | 说明 |
---|---|---|
id | string | 主键ID |
start_time | string | 开始时间 |
caller | int | 主叫 |
called | string | 被叫 |
sip_num | string | 虚拟号 |
vcc_code | string | 企业代码 |
call_id | string | 呼叫ID |
inout | string | 呼叫类型 |
call_result | string | 呼叫结果 |
end_time | string | 结束时间 |
talk_duration | string | 通话时长 |
end_reason | string | 挂机原因 |
枚举
inout 枚举
枚举 | 说明 |
---|---|
1 | 外呼 |
2 | 呼入 |
call_result 枚举
枚举 | 说明 |
---|---|
1 | 未接通 |
0 | 接通 |
结果示例
{
"code": 0,
"message": "success",
"data": {
"pre_page": 100,
"current_page": 1,
"total": 1,
"total_page": 1,
"results": [
{
"id": "1614908403956682752",
"start_time": "2023-06-11 10:07:20",
"caller": "2001574011",
"called": "17775825019",
"sip_num": "2001574001",
"vcc_code": "test",
"call_id": "7187031117341787017",
"inout": "1",
"call_result": "1",
"end_time": "2023-06-12 10:07:20",
"talk_duration": "0",
"end_reason": "主叫挂断"
}
]
}
}
获取企业中继号,号码组,X号
企业中继号,号码组,X号查询
接口地址
Content-Type: application/json
POST https://m.icsoc.net/ektv3/v3/wintelapi/other/getPhoneSelect
示例
请求
curl --location --request POST 'https://m.icsoc.net/ektv3/v3/wintelapi/other/getPhoneSelect' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YP6iqELNsyhXcVNJfl07ebDiOfDwqENcdlbD2vYP'
响应
{
"code": 0,
"message": "success",
"request_id": "TxP9DeXrViPbWno3hFmw35JOPxKXUTnB",
"data": {
"groups": [
{
"id": "236",
"name": "test22222"
},
{
"id": "254",
"name": "测试号码组"
}
],
"phones": [
{
"id": 0,
"name": "01088881705"
},
{
"id": 1,
"name": "0270000999999"
}
],
"xTels": [
{
"id": 8,
"name": "154878784"
}
],
"agentPhone": []
}
}
响应字段说明
字段 | 类型 | 说明 |
---|---|---|
groups | object[] | 号码组 |
phones | object[] | 中继号 |
xTels | object[] | x号 |
agentPhone | object[] | 废弃 |
获取企业配置ivr
企业配置的ivr
接口地址
Content-Type: application/json
POST https://m.icsoc.net/ektv3/v3/wintelapi/other/ivrs
示例
请求
curl --location --request POST 'https://m.icsoc.net/ektv3/v3/wintelapi/other/ivrs' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YP6iqELNsyhXcVNJfl07ebDiOfDwqENcdlbD2vYP'
响应
{
"code": 0,
"message": "success",
"request_id": "ittpK9sG0bbkVWT8v5MEnx0seiRM9wLJ",
"data": [
{
"ivrId": 1005,
"ivrName": "ly-IVR",
"ivrCode": "ivr782_1005"
},
{
"ivrId": 1007,
"ivrName": "lyb测试旧版云问IVR",
"ivrCode": "ivr782_1007"
}
]
}
响应字段说明
字段 | 类型 | 说明 |
---|---|---|
ivrId | int | ivr ID |
ivrName | string | ivr名称 |
ivrCode | string | ivr code |