中通天鸿开发者平台

中通天鸿开发者平台

  • 开发文档
  • API文档

›中间件wintelapi

中间件wintelapi

  • 如何认证
  • 角色管理
  • 黑名单管理
  • 白名单管理
  • 坐席管理
  • 坐席管理(新)
  • 分机管理
  • 技能组管理
  • 业务组管理
  • 语音管理
  • jsonp接口
  • 监控管理
  • 监控管理(新)
  • 录音管理
  • 报表管理管理
  • 报表管理(新)
  • 双向外呼(新)
  • 双向外呼(不推荐)
  • 其他相关接口
  • 话单推送

智能外呼

    快速入门

    • 功能介绍
    • 语音相关服务
    • 对接流程
    • 新手指引

    接口说明

    • 单条数据请求接口
    • 批量数据请求接口(新)
    • 回调数据下载、查询
    • 创建项目
    • 修改项目
    • 删除项目
    • 获取项目信息
    • 创建语音模板
    • 修改语音模板
    • 获取语音模板信息
    • 获取半小时接通率

短信

  • 短信接口

工单

  • 工单接口

CRM

  • 客户模块
  • 联系人模块
  • 跟进记录模块
  • 商机模块
  • 附录

隐私号 axb

  • 认证
  • axb 类型
  • ax 类型
  • axyb 类型
  • 附录

闪信

  • 认证
  • API

外呼管理

  • 认证
  • 预测式外呼-任务
  • 预测式外呼-数据
  • 预测式外呼-监控
  • 话单
  • 附录

监控管理(新)

坐席指标数据接口

  • 接口地址

http://m.icsoc.net/api/v1/getAgentData

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |
  • 接口参数
参数说明备注
agIds坐席ids数组 例如 ["232790", "232792"]可选 不传返回全部
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
  "code": 200,
  "data": [
    {
      "agId": "247691",
      "agName": "0035 邵毅",
      "agNum": "0035",
      "phoNum": "8058",
      "loginIp": "124.225.234.155:0",
      "totalAnsweredNum": 0,
      "totalCallInAnsweredNum": 0,
      "totalCallInEnterNum": 0,
      "totalCallOutAnsweredNum": 0,
      "totalCallOutEnterNum": 7,
      "totalCallInBusyTime": 0,
      "totalCallOutBusyTime": 0,
      "totalCallReasonNum_51": 0,
      "totalEnterNum": 5,
      "totalCallOutPostPTime": 31,
      "totalCallReasonTimes_51": 0,
      "totalSignTime": 0,
      "totalStatusNum_10": 12,
      "totalStatusNum_2": 11,
      "totalStatusNum_5": 12,
      "totalStatusTimes_10": 111,
      "totalStatusTimes_11": 426,
      "totalStatusTimes_2": 687,
      "totalStatusTimes_5": 54,
      "totalTransferNum": 0
    }
  ],
  "message": "success"
}
  • 结果字段说明
agId    坐席id
agName  坐席名称(坐席工号 + 坐席名称)
agNum   坐席工号
phoNum  分机号
loginIp 登录ip
totalAnsweredNum    接通量
totalCallInAnsweredNum  呼入接听量
totalCallInEnterNum 呼入量
totalCallOutAnsweredNum 外呼接通量
totalCallOutEnterNum    外呼量
totalCallInBusyTime 呼入通话时长
totalCallOutBusyTime    外呼通话时长
totalCallReasonNum_51   总保持次数
totalEnterNum   总进线量
totalCallOutPostPTime   外呼事后处理时长
totalCallReasonTimes_51 总保持时长
totalSignTime   登录时长
totalStatusNum_10   总振铃次数
totalStatusNum_2    总置忙次数
totalStatusNum_5    总事后次数
totalStatusTimes_10 总振铃时长
totalStatusTimes_11 总通话时长
totalStatusTimes_2  置忙时长
totalStatusTimes_5  总事后处理时长
totalTransferNum    转移数
    

获取指定状态坐席数据接口

  • 接口地址

http://m.icsoc.net/api/v1/getAgentByStatus

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |

  • 接口参数

参数说明备注
code状态码 2 置忙 3 置闲 5 事后 10 振铃 11 通话可选 不传返回全部
agName坐席名称 过滤条件可选
agId坐席id 过滤条件可选
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
    "code": 200,
    "data": [
        {
            "agId": "240195",
            "agNum": "8888",
            "agName": "8888 管理员(姓名)",
            "phoNum": "8002",
            "agSta": 3
        },
        {
            "agId": "248031",
            "agNum": "6000",
            "agName": "6000 6000",
            "phoNum": "6000",
            "agSta": 3
        },
        {
            "agId": "272169",
            "agNum": "6007",
            "agName": "6007 秦磊测试",
            "phoNum": "8311",
            "agSta": 3
        },
        {
            "agId": "284732",
            "agNum": "8889",
            "agName": "8889 test01",
            "phoNum": "8497",
            "agSta": 3
        }
    ],
    "message": "success"
}
  • 结果字段说明
agId    坐席id
agName  坐席名称(坐席工号 + 坐席名称)
agNum   坐席工号
phoNum  分机号 

坐席所在技能组排队数接口

  • 接口地址

http://m.icsoc.net/api/v1/getAgQueueDetailUp

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |

  • 接口参数

参数说明备注
agIds坐席ids数组 例如 ["232790", "232792"]必选
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果样例
{
    "code": 200,
    "data": [
        {
            "agId": "230076",
            "queueDetailUpInfo": [
                {
                    "queId": "208551",
                    "queueName": "使用咨询",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "213017",
                    "queueName": "保险报案",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "208553",
                    "queueName": "投诉建议",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "208552",
                    "queueName": "账户查询",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "212746",
                    "queueName": "智能语音组",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "210344",
                    "queueName": "白名单用户",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "208676",
                    "queueName": "支付宝-使用咨询",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "213018",
                    "queueName": "支付宝-保险报案",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "208662",
                    "queueName": "支付宝-投诉建议",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "208675",
                    "queueName": "支付宝-账户查询",
                    "totalQueueUpNum": 0
                },
                {
                    "queId": "213320",
                    "queueName": "智能语音组-其他问题",
                    "totalQueueUpNum": 1
                },
                {
                    "queId": "213337",
                    "queueName": "智能语音组-用车问题",
                    "totalQueueUpNum": 0
                }
            ]
        }
    ],
    "message": "success"
}
  • 结果字段说明
 {
        "queId": "213017",
        "queueName": "保险报案",
        "totalQueueUpNum": 0
 }

技能组指标接口

  • 接口地址

http://m.icsoc.net/api/v3/queueMonitorById

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |

  • 接口参数

参数说明备注
queIds技能组ids 例如 ["210204","216191"]可选 不传默认全部
kpiIds指标key 例如 ["ns20TotalAnsweredNum","queueId","queueName"]必选
  • kpiIds参数说明
kpiIds  可选的指标有指
        queueId                       //队列id
        queueName                   //队列名称
        totalQueueUpNum             //当前排队数:客户当前排队数
        totalReadyNum               //当前就绪人数
        totalEnterNum               //客户呼入,转人工的数量
        totalAnsweredNum            //呼入接通量:坐席接起该技能组客户来电量
        ns20TotalAnsweredNum        //20s呼入接通量:客户来电,从转技能组开始,在20秒内被接起的数量
        totalAbandonedNum           //坐席未接起的转队列的来电量
        totalOnlineNum              //在线人数:该技能组的在线人数
        totalNoRpAbandonedNum       //人工呼损量
        totalWaitTime               //接听中总等待时长
        totalStatusTimes_11         //总通话时长
        totalConnectNum_11          //客户呼入已接通量
        totalStatusTimes_5          //总事后处理时长
        totalConnectPostPTime       //总事后处理时长(接通)
        totalTransferNum            //转移数
        totalConnectNum_5           //从队列分配成功的电话,接通后已事后处理的数量
        totalNoRpEnterNum           //总人工进线量(在IVR中重新转人工算一次)
        totalNoReadyNum             //总示忙人数
        totalRingNum                //振铃人数
        totalBusyNum                //通话人数
        totalPostPNum               //事后处理人数
        totalNoRpValidEnterNum      //该技能组的客户呼入量(连续重复进同一技能组算一次),有效:溢出到其他技能组的不算
        totalNoRpValidAbandonedNum  //坐席未接起的转技能组的来电量(连续重复进同一技能组算一次),有效:溢出到其他技能组的不算
            totalAgNum                                  //技能组坐席总人数
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
    "code": 200,
    "data": [
        {
            "ns20TotalAnsweredNum": 0,
            "queueId": "210204",
            "queueName": "产品部",
            "totalAbandonedNum": 0,
            "totalOnlineNum": 2,
            "totalReadyNum": 2
        },
        {
            "ns20TotalAnsweredNum": 0,
            "queueId": "216191",
            "queueName": "智能IVR-落户",
            "totalAbandonedNum": 0,
            "totalOnlineNum": 1,
            "totalReadyNum": 1
        }
    ],
    "message": "success"
}
  • 结果字段说明
返回所选指标结果    
        {
            "ns20TotalAnsweredNum": 0,
            "queueId": "216191",
            "queueName": "智能IVR-落户",
            "totalAbandonedNum": 0,
            "totalOnlineNum": 1,
            "totalReadyNum": 1
            .....等
        }

呼叫中心总览接口

  • 接口地址

http://m.icsoc.net/api/v3/monitor/callCenterData

  • 请求方式

GET

  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
    "code": 200,
    "data": {
        "IVRAbandonedNum": 0,
        "IVREnterNum": 185,
        "ns20TotalAnsweredNum": 71,
        "smallOverviewFlag": 0,
        "totalAbandonedNum": 12,
        "totalAnsweredNum": 100,
        "totalCallInNum": 4,
        "totalCallInnerNum": 0,
        "totalCallOutAnsweredNum": 15,
        "totalCallOutEndEnterNum": 27,
        "totalCallOutEnterNum": 27,
        "totalCallOutNum": 0,
        "totalEnterNum": 113,
        "totalNoReadyNum": 6,
        "totalNoRpAbandonedNum": 11,
        "totalNoRpEndEnterNum": 111,
        "totalNoRpEnterNum": 112,
        "totalOnlineNum": 10,
        "totalPostPNum": 0,
        "totalQueueUpNum": 1,
        "totalReadyNum": 0,
        "totalRingNum": 0,
        "trunkEnterNum": 185,
        "vccId": "2000721"
    },
    "message": "success"
}
  • 结果字段说明
        "IVRAbandonedNum": IVR异常量   
        "IVREnterNum": IVR进线量   
        "ns20TotalAnsweredNum": 20秒接通量  
        "smallOverviewFlag": 忽略
        "totalAbandonedNum": 呼损量     坐席未接起的转队列的来电量  
        "totalAnsweredNum": 呼入接通量   坐席接起该队列客户来电量    
        "totalCallInNum": 呼入通话数 
        "totalCallInnerNum": 内部通话数  
        "totalCallOutAnsweredNum": 外呼接通量 坐席外呼同时客户接通的数量  
        "totalCallOutEndEnterNum": 挂机外呼量(=外呼接通量+外呼放弃量) 挂机时算外呼量  
        "totalCallOutEnterNum": 外呼量 坐席外呼总量  
        "totalCallOutNum": 外呼通话数    
        "totalEnterNum": 总呼入量   
        "totalNoReadyNum": 置忙坐席数    
        "totalNoRpAbandonedNum": 人工呼损量  坐席未接起的转队列的来电量,连续重复进同一队列算一次
        "totalNoRpEndEnterNum": 挂机人工呼入量(=接通量+人工呼损量) 挂机时算    
        "totalNoRpEnterNum": 总人工进线量 该队列的客户呼入量,连续重复进同一队列算一次  
        "totalOnlineNum": 在线人数  
        "totalPostPNum": 事后处理坐席数    
        "totalQueueUpNum": 当前排队数    
        "totalReadyNum": 置闲坐席数  
        "totalRingNum": 振铃坐席数   
        "trunkEnterNum": 总进线量   
        "vccId": "2000721" 企业id

坐席指标列表接口(全量指标)

  • 接口地址

http://m.icsoc.net/api/v3/monitor/agent/all

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |

  • 接口参数

参数说明备注
statusType1 在线 2 全部可选 不传默认全部
groupIds业务组id,逗号分隔可选
queIds技能组id,逗号分隔可选
agIds坐席id,逗号分隔可选
phoNum分机号可选
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
    "code": 200,
    "data": [
        {
            "index": 0,
            "agId": "302029",
            "agNum": "8001",
            "vccId": "2001032",
            "agName": "8001 yuhao",
            "agOriginalName": "yuhao",
            "groupId": "0",
            "groupName": "其它业务组",
            "queId": "219202,219302",
            "queName": "def,测试",
            "agSta": 3,
            "agStaStr": "置闲",
            "agStaTime": "1582560000",
            "agSignTime": "1582560000",
            "agStaReason": 0,
            "agStaReasonStr": "置闲",
            "agReasonTime": "1582560000",
            "totalEnterNum": 0,
            "totalStatusTimes_11": 0,
            "totalStatusTimes_2": 0,
            "totalAnsweredNum": 0,
            "totalSignTime": 0,
            "totalStaReasons": [
                {
                    "id": 927,
                    "stat_reason": "小休",
                    "number": 0
                },
                {
                    "id": 928,
                    "stat_reason": "午休",
                    "number": 0
                },
                {
                    "id": 929,
                    "stat_reason": "会议",
                    "number": 0
                }
            ],
            "callMtype": 2,
            "callType": "2_1",
            "callTypeDetail": "4121",
            "callQue": "",
            "callQueName": "",
            "totalCallInEnterNum": 0,
            "totalCallInAnsweredNum": 0,
            "totalCallInBusyTime": 0,
            "totalCallOutEnterNum": 0,
            "totalCallOutAnsweredNum": 0,
            "totalCallOutBusyTime": 0,
            "totalTransferNum": 0,
            "totalStatusTimes_5": 0,
            "totalStatusNum_5": 0,
            "totalStatusTimes_10": 0,
            "totalStatusNum_10": 0,
            "totalCallReasonTimes_51": 0,
            "totalCallReasonNum_51": 0,
            "totalCallInPostPTime": 0,
            "totalCallOutPostPTime": 0,
            "totalStatusNum_2": 0,
            "phoNum": "8001",
            "loginIp": "",
            "preCallType": 2,
            "incomingCallNum": "18827347463"
        }
    ],
    "message": "success"
}
  • 结果字段说明
            "index": 0, 序号
            "agId": "302029", 坐席id
            "agNum": "8001",坐席工号
            "vccId": "2001032",企业id
            "agName": "8001 yuhao",坐席姓名
            "agOriginalName": "yuhao", 坐席真实姓名
            "groupId": "0", 业务组id
            "groupName": "其它业务组", 业务组名称
            "queId": "219202,219302", 技能组id 多个逗号分隔
            "queName": "def,测试", 技能组名称  多个逗号分隔
            "agSta": 3,坐席一级状态  状态说明: 1, "签入",0, "离线",2, "置忙",3, "置闲",5, "事后",10, "振铃",11, "通话"
            "agStaStr": "置闲",一级状态名称
            "agStaTime": "1582560000",坐席进入当前状态的时间   
            "agSignTime": "1582560000",坐席最近签入时间点    
            "agStaReason": 0, 二级状态
            "agStaReasonStr": "置闲", 二级状态名称 其中 示忙原因见manager各企业配置 通话:3-纯通话 51-hold中 61-咨询中 62-三方中
            "agReasonTime": "1582560000",切到某个示忙原因时的时间 通话进入某个状态的时间
            "totalEnterNum": 0,总呼入量 
            "totalStatusTimes_11": 0,总通话时长  
            "totalStatusTimes_2": 0,置忙时长    
            "totalAnsweredNum": 0,呼入接通量 
            "totalSignTime": 0,登录时长 
            "totalStaReasons": [
                {
                    "id": 927,
                    "stat_reason": "小休",
                    "number": 0
                },
                {
                    "id": 928,
                    "stat_reason": "午休",
                    "number": 0
                },
                {
                    "id": 929,
                    "stat_reason": "会议",
                    "number": 0
                }
            ],企业manage置忙原因码表
            "callMtype": 2,坐席通话主类型  呼入- 1 外呼- 2
            "callType": "2_1",坐席通话次类型   客户呼入- 1_1 内部呼入- 1_2 外呼客户- 2_1 内部呼出- 2_2
            "callTypeDetail": "4121",坐席通话类型 
            "callQue": "", 坐席通话技能组  
            "callQueName": "",坐席通话技能组名称
            "totalCallInEnterNum": 0,呼入量    
            "totalCallInAnsweredNum": 0,呼入接听量   
            "totalCallInBusyTime": 0,呼入通话时长 
            "totalCallOutEnterNum": 0,外呼量   
            "totalCallOutAnsweredNum": 0,外呼接通量  
            "totalCallOutBusyTime": 0,外呼通话时长    
            "totalTransferNum": 0,总转移数  
            "totalStatusTimes_5": 0,总事后处理时长     
            "totalStatusNum_5": 0,总事后次数 
            "totalStatusTimes_10": 0,总振铃时长  
            "totalStatusNum_10": 0,总振铃次数    
            "totalCallReasonTimes_51": 0,总保持时长  
            "totalCallReasonNum_51": 0,总保持次数    
            "totalCallInPostPTime": 0,呼入事后处理时长  
            "totalCallOutPostPTime": 0,外呼事后处理时长 
            "totalStatusNum_2": 0,totalStatusNum_N 坐席状态累计次数 N为坐席状态数值    
            "phoNum": "8001",分机号
            "loginIp": "",登录id
            "preCallType": 2,当前电话类型     '1'-'呼入' '2'-'外呼' '3'-'内部
            "incomingCallNum": "18827347463" 记录通话坐席电话   

坐席指标列表接口(基础状态指标)

  • 接口地址

http://m.icsoc.net/api/v3/monitor/agent/state

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |

  • 接口参数

参数说明备注
statusType1 在线 2 全部可选 不传默认全部
groupIds业务组id,逗号分隔可选
queIds技能组id,逗号分隔可选
agIds坐席id,逗号分隔可选
phoNum分机号可选
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
    "code": 200,
    "data": [
        {
            "agId": "302029",
            "agNum": "8001",
            "vccId": "2001032",
            "agName": "8001 yuhao",
            "agOriginalName": "yuhao",
            "groupId": "0",
            "groupName": "其它业务组",
            "queId": "219202,219302",
            "queName": "def,测试",
            "agSta": 3,
            "agStaStr": "置闲",
            "agStaReason": 0,
            "agStaReasonStr": "置闲"
        }
    ],
    "message": "success"
}
  • 结果字段说明
            "agId": "302029", 坐席id
            "agNum": "8001",坐席工号
            "vccId": "2001032",企业id
            "agName": "8001 yuhao",坐席姓名
            "agOriginalName": "yuhao", 坐席真实姓名
            "groupId": "0", 业务组id
            "groupName": "其它业务组", 业务组名称
            "queId": "219202,219302", 技能组id 多个逗号分隔
            "queName": "def,测试", 技能组名称  多个逗号分隔
            "agSta": 3,坐席一级状态  状态说明: 1, "签入",0, "离线",2, "置忙",3, "置闲",5, "事后",10, "振铃",11, "通话"
            "agStaStr": "置闲",一级状态名称
            "agStaReason": 0, 二级状态
            "agStaReasonStr": "置闲", 二级状态名称 其中 示忙原因见manager各企业配置 通话:3-纯通话 51-hold中 61-咨询中 62-三方中

技能组排队数接口

  • 接口地址

http://m.icsoc.net/api/v3/monitor/queueUpNumById

  • 请求方式

POST

  • 请求头 | Content-Type | application/json |

  • 接口参数

参数说明备注
queIds技能组ids 例如 ["210204","216191"]必选
  • 结果编码说明
200: "接口调用成功",
500: "服务器内部异常",
400: "请求参数错误",
403: "token 无效",
  • 结果示例
{
    "code": 200,
    "data": [
        {
            "queId": "211589",
            "totalQueueUpNum": 0
        }
    ],
    "message": "success"
}
  • 结果字段说明
totalQueueUpNum :排队数
Last updated on 6/10/2020 by jialiang
← 监控管理录音管理 →
  • 坐席指标数据接口
  • 获取指定状态坐席数据接口
  • 坐席所在技能组排队数接口
  • 技能组指标接口
  • 呼叫中心总览接口
  • 坐席指标列表接口(全量指标)
  • 坐席指标列表接口(基础状态指标)
  • 技能组排队数接口
中通天鸿开发者平台
产品中心
呼叫中心在线客服工单系统IM机器人CTI-PLUS语音机器人通信云资源云
帮助中心
常见问题更新日志
关于我们
公司简介联系我们友情链接
Copyright © 2021 中通天鸿(北京)通信科技股份有限公司