零、注意事项:
0.1 格式说明
所有API,若未特殊注明,Content-Type
全部使用 application/json
。
0.2 出参约定格式
如无特殊说明,出参固定为以下格式:
参数 | 类型 | 说明 |
code | int | 状态码,0 - 成功, 其余为失败 |
message | string | 提示信息 |
data | mixed | 数据 |
data 具体格式见每个接口具体说明
0.3 域名
如果无特殊说明,以下 API 中,所有域名均为: https://autocall.icsoc.net
一、预测式外呼-项目监控列表
1.1 路由
GET/POST /api/v1/poc/monitor/lists
1.2 入参
参数 | 类型 | 说明 | 必填 | 默认值 |
projectName | int | 项目名称 | 否 | |
projectType | string | 任务类型:1-预测式外呼,2-预览式外呼,3-自动外呼,4-机器人外呼 | 否 | |
currentPage | int | 当前页 | 否 | 1 |
perPage | int | 每页数量 | 否 | 15 |
1.3 出参
参数 | 类型 | 说明 |
currentPage | integer | |
totalPage | integer | |
perPage | integer | 首次外呼开始时间 |
total | integer | 剩余数量/剩余重呼 |
empty | bool | 外呼通话量 |
results | Monitor[] | 近5分钟外呼速度 |
1.3.1 Monitor 格式为
参数 | 类型 | 说明 |
projectId | integer | |
projectName | string | |
startedAt | string | 首次外呼开始时间 |
remainNum | integer | 剩余数量/剩余重呼 |
calledNum | integer | 外呼通话量 |
calledRate | integer | 近5分钟外呼速度 |
calledTotal | integer | 外呼数据量(不包括重呼的) |
calledMiss | integer | 呼损量 |
freeAgentNum | integer | 空闲坐席数 |
onlineAgentNum | integer | 在线坐席数 |
clientAnswerRate | string | 客户接通率 |
agentAnswerRate | string | 坐席接通率 |
answerRate | string | 呼叫接通率 |
calledMissRate | string | 呼损率 |
timeAve | integer | 平均处理时长 |
timeFree | integer | 当日平均闲置时长 |
1.4 举例
1.4.1 入参
{
"name":"yansongda"
}
1.4.2 出参
{
"code":0,
"message":"操作成功",
"request_id":"06524040c96b9320c05256959754afd9",
"data":{
"currentPage":1,
"totalPage":1,
"perPage":20,
"total":7,
"empty":false,
"results":[
{
"projectId":10008,
"projectName":"yansongda",
"startedAt":"2021-03-22 18:08:00", // 首次外呼开始时间
"remainNum":"0/0", // 剩余数量/剩余重呼
"calledNum":5, // 外呼通话量
"calledRate":0, // 近5分钟外呼速度
"calledTotal":2, // 外呼数据量(不包括重呼的)
"calledMiss":0, // 呼损量
"freeAgentNum":0, // 空闲坐席数
"onlineAgentNum":0, // 在线坐席数
"clientAnswerRate":"50%", // 客户接通率
"agentAnswerRate":"50%", // 坐席接通率
"answerRate":"50%", // 呼叫接通率
"calledMissRate":"0%", // 呼损率
"timeAve":3, // 平均处理时长
"timeFree":1700 // 当日平均闲置时长
}
]
}
}
二、预测式外呼-坐席监控
2.1 路由
GET/POST /api/v1/poc/monitor/users
2.2 入参
参数 | 类型 | 说明 | 必填 |
projectId | int | 项目id | 是 |
2.3 出参
参数 | 类型 | 说明 |
agentId | int | 坐席id |
agentNum | string | 坐席工号 |
agentName | string | 坐席姓名 |
agentStatus | string | 坐席当前状态 |
statusTimes | int | 当前状态持续时间 |
2.4 举例
2.4.1 入参
{
"projectId": 1
}
2.4.2 出参
{
"code":0,
"message":"操作成功",
"request_id":"c584766bd49f2aa38575cf785466dc49",
"data":[
{
"agentId":419353,
"agentNum":"5470",
"agentName":"yansongda",
"agentStatus":"示闲",
"statusTimes":20
}
]
}