中通天鸿开发者平台

中通天鸿开发者平台

  • 开发文档
  • API文档

›中间件wintelapi

中间件wintelapi

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

智能外呼

    快速入门

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

    接口说明

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

短信

  • 短信接口

工单

  • 工单接口

CRM

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

隐私号 axb

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

闪信

  • 认证
  • API

外呼管理

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

其他相关接口

获取企业绑定的中继号码接口

接口地址

GET https://m.icsoc.net/v2/wintelapi/trunks/all

结果示例

{
    "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": "手机号码"
        }
    ]
}

结果字段说明

字段说明
phone中继号
code号码归属地 code
city号码归属地
type号码类型
type_string号码类型

获取企业虚拟号绑定的中继号码接口

接口地址

GET https://m.icsoc.net/v2/wintelapi/virtual/bindings/lists

入参

字段说明必填
virtual虚拟中继号是
per_page每页数量,默认1000条否
current_page当前页,默认1否

出参

字段类型说明必填
codeint返回代码。0 为成功,其它均为不成功是
messagestring提示是
dataData结果

Data 定义

字段类型说明必填
per_pageint每页数量是
current_pageint当前页是
totalint总条数是
total_pageint总页数是
resultsstring[]结果是

结果示例

{
    "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企业代码不存在
200ok

结果示例

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。此参数和 time_start_* 必选其一特殊可选
time_start_begin通话开始起始时间。此参数和 call_id 必选其一,且时间范围不能超过1个月特殊可选
time_start_end通话开始结束时间。此参数和 call_id 必选其一,且时间范围不能超过1个月特殊可选
per_page每页数量,默认100条否
current_page当前页,默认1否

出参

字段类型说明必填
codeint返回代码。0 为成功,其它均为不成功是
messagestring提示是
dataData结果

Data 定义

字段类型说明必填
per_pageint每页数量是
current_pageint当前页是
totalint总条数是
total_pageint总页数是
resultsResult[]结果是

Result 定义

字段类型说明
vcc_idint企业id
vcc_codestring企业code
ag_idint坐席id
call_idstring呼叫id
call_typeint呼叫类型
call_resultint呼叫结果
trunk_numstring中继号码
user_numstring用户号码
user_area_codestring用户归属地区号
time_startstring呼叫时间
time_ringstring振铃事件
time_answerstring应答时间
time_connstring双方接通时间
time_hangupstring挂机时间
dur_ringint用户振铃周期
dur_ring2int从呼叫开始到用户振铃结束周期
dur_answerint用户应答周期
dur_connint用户与坐席接通周期
dur_allint从呼叫开始到挂机周期
user_datastring用户数据

枚举

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_idstring通话id是
business_statusstring0未成功,1成功是
user_datastringjson 的 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": "更新成功"
}

结果字段说明

字段说明
code200更新成功
message提示信息
Last updated on 8/19/2021 by yanda
← 双向外呼(不推荐)话单推送 →
  • 获取企业绑定的中继号码接口
    • 接口地址
    • 结果示例
    • 结果字段说明
  • 获取企业虚拟号绑定的中继号码接口
    • 接口地址
    • 入参
    • 出参
    • 结果示例
  • 获取置忙原因数据接口
    • 接口地址
    • 接口参数
    • 结果编码说明
    • 结果示例
    • 结果字段说明
  • 获取中继话单接口
    • 接口地址
    • 入参
    • 出参
    • 枚举
    • 结果示例
  • 更新通话记录业务标识
    • 接口地址
    • 入参
    • 举例
    • 结果示例
    • 结果字段说明
中通天鸿开发者平台
产品中心
呼叫中心在线客服工单系统IM机器人CTI-PLUS语音机器人通信云资源云
帮助中心
常见问题更新日志
关于我们
公司简介联系我们友情链接
Copyright © 2021 中通天鸿(北京)通信科技股份有限公司