3.1 异步调用接口列表

3.1.1 坐席登录

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"logon","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken","online":1,"workType":1}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:logon
callBackUrlString否回调地址
workTypeinteger是0 手机 1 sip
onlineIntger否默认 0 0 自动空闲 1 手动 预测外呼登录时只能为1
autoIntger否默认0 1 预测外呼登录(该方式登录后需要手动置闲否则无法接到电话) 0 普通方式登录
agentString否需要操作的坐席工号(企业管理方式认证,必传)
请求示例
 响应包体
属性 类型 约束 说明 
codeInteger必选返回码
messageString必选结果消息
dataObject必选返回结果 
响应示例
  • {
  •     "code": 0,
  •     "message": "success",
  •     "data": null
  • } 
回调接口示例
  • // 上班结果通知
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"上班成功",
  •         "stationNo":111,
  •         "type":"logon",
  •         "systemtime":"2020-08-12 16:11:46",
  •         "mainCaller":"8715628449220019",
  •         "status":0
  •     }
  • }
 返回事件说明
事件参数名 参数类型 参数说明 是否必填 
typestring固定值 logon必填
statusint状态码 0 正常 非0 错误必填
reasonstring原因必填
systemtimestring系统当前时间 时间格式 yyyy-MM-dd HH:mm:ss必填
  • // ps: 当用户已经处于登录状态时返回参数
  • { 
  •   "code" :  0 , 
  •   "message" :  "has bean logon" 
  • } 
  • // 此时仍然可以正常进行后续其它操作. 

3.1.2 坐席下班

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"logout","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:logout
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • // 下班结果通知
  • {    
  •     "code": 0,
  •     "message": "success",
  •     "data": null
  • }
 回调接口示例
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"登出成功",
  •         "type":"logout",
  •         "systemtime":"2020-08-12 16:15:44",
  •         "status":0
  •     }
  • }
 

2.1.3 坐席空闲

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"agentidle","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:agentidle
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  •   "code": 0, 
  •   "message": "success",    
  •   "data": null
  • }
回调接口示例
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"示闲成功.",
  •         "type":"agentidle",
  •         "status":0
  •     }
  • }
 

2.1.4 坐席忙碌

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"agentbusy","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:agentbusy
busydescrint否值为admin配置的忙碌类型的id 默认值0
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  •  {    
  •  "code": 0,    
  •  "message": "success",    
  •  "data": null
  •  }
回调接口示例
  •  {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"示忙成功",
  •         "agentkey":"1001@wucb",
  •         "type":"agentbusy",
  •         "status":0
  •     }
  • }
 

2.1.5 获取坐席当前状态

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"agentstate","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:agentstate
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {
  •     "code":0,
  •     "message":"success",
  •     "data":{
  •         "callBackStr":"{"reason":"示忙成功","agentkey":"1002@zl","type":"agentbusy","status":0}",
  •         "workType":1,
  •         "online":1,
  •         "operatorId":"1002",
  •         "agentSte":"NotReady",
  •         "mainCaller":"8760746",
  •         "auto":0,
  •         "callmute":0
  •     }
  • }
agentSte取值范围: 
值含义
Login上班
Logout下班
NotReady忙碌
Ready空闲
After话后
OutCallingFirst发起外呼成功
OutRing外呼坐席振铃
OutCall坐席外呼接听
CalledRingIng被叫振铃
InnerRingIng内呼坐席振铃
OutBoundCall坐席外呼通话中
InnerCall内呼坐席通话中
Mute保持
UnMute取消保持
Monitor发起班长监听
MonitorRingIng班长监听振铃
MonitorInCall班长监听通话中
InRingIng呼入振铃
InCall呼入接听
PlayTTS播放工号
SIPError话机异常
TransferIng转接中
TransferInRingIng转接来电振铃
TransferInCall转接通话中
ConsultationCalls发起咨询通话
ConsultInRinging咨询来电振铃
ConsultInCall咨询来电通话中
SanFangCall三方通话
 

 3.1.6 话后状态预设

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"agentstatepreset","callBackUrl":"http://localhost/callback.php","preSetState":2}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:agentstatepreset
callBackUrlString否回调地址
preSetStateInteger是坐席预设状态: 0 不做任何操作 1 主动空闲 2 主动忙碌
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
{    
  •   "code": 0,   
  •   "message": "success"
  • }

3.1.7 坐席外呼

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"makecall","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken",
"called":"1331111111","userData":"{\"key\":\"value\"}"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:makecall
callBackUrlString否回调地址
calledString是被叫号码/被叫坐席工号@企业缩写
callerString否给客户展示的显号
agentcallerString否给坐席展示的显号
previewJSON否预览外呼任务参数
autoAnswerString否坐席硬话机自动应答,目前只支持易联话机 固定值
intercom
userDataString否用户随路数据(json字符串)
uuiDataString否user to user data
uuiTypeint否是否加密 0不加密 1加密 默认为0
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  •  {    
  •  "code": 0,    
  •  "message": "success"
  •  }
 通话回调事件涉及多个场景,请见通话  回调相关接口-事件回调
 

3.1.8 坐席静音

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"callmute","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
  请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:callmute
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
 返回参数示例
  •  {    
  •  "code": 0,    
  •  "message": "success"
  •  }
  回调接口示例
  • // 请求回调 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "type":"callmute",
  •         "dir":1,
  •         "status":0
  •     }
  • }
 

3.1.9 坐席取消静音

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"callunmute","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
 请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:callunmute
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
 返回参数示例
  • {    
  • "code": 0,   
  •  "message": "success"
  •  }
回调接口示例
  • // 请求回调 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "type":"callunmute",
  •         "dir":1,
  •         "status":0
  •     }
  • }

3.1.10 挂机

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"cancelmakecall","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:cancelmakecall
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  • "code": 0,    
  • "message": "success",    
  • "data": null
  • }
回调接口示例
  • // 请求回调
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"挂机成功",
  •         "type":"cancelmakecall",
  •         "status":0
  •     }
  • }
  • // 话单回调 
  • {    "agentKey":"1001@wucb",
  •     "message": {
  •         "callid":"202080556074266084388",
  •         "answer_time":"2020-08-12 16:24:18",
  •         "auto":false,
  •         "called":"18910393942",
  •         "calledArea": {
  •             "city":"北京 ",
  •             "provice":"北京"
  •         },
  •         "operator_id":"1001 ",
  •         "altering_time ":"2020 - 08 - 12 16: 23: 43 ",
  •         "cause ":0,
  •         "callerArea ": {
  •             "city ":"北京 ",
  •             "provice ":"北京 "
  •         },
  •         "type ":"after ",
  •         "dir ":1,
  •         "devicetype ":"1 ",
  •         "duration ":447,
  •         "agent_answer_time ":"2020 - 08 -12 16: 23: 46 ",
  •         "hangupdir ":0,
  •         "rstime ":"2020 - 08 - 12 16: 23: 46 ",
  •         "timestamp ":1597220623,
  •         "end_time ":"2020 - 08 - 12 16: 31: 13 ",
  •         "begin_time ":"2020 - 08 - 12 16: 23: 43 ",
  •         "recordcode ":"152 _202080556074266084388_18910393942_18910393942_20200812162346_1597220626451 ",
  •         "operator_name ":"1001 ",
  •         "caller ":"18910393942 ",
  •         "filename ":"/app/clpms/record/20200812/152 _202080556074266084388_18910393942_18910393942_20200812162346_1597220626451.wav ",
  •         "mediano ":2,
  •         "device ":"202080557173764336702 "
  •     }
  • }
 

3.1.11 电话保持

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"mute","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:mute
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  • "code": 0,    
  • "message": "success",    
  • "data": null
  • }
 回调接口示例 
  • // 电话保持是否成功 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "type":"mute",
  •         "dir":1,
  •         "status":0
  •     }
  • }
 

3.1.12 电话取消保持

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"unmute","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:unmute
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  • "code": 0,    
  • "message": "success",   
  •  "data": null
  • }
回调接口示例
  • // 电话取消保持是否成功 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "type":"unmute",
  •         "dir":1,
  •         "status":0
  •     }
  • }
 

 3.1.13 班长监听

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"monitor","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken","otherOperatorId":"3001"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:monitor
callBackUrlString否回调地址
otherOperatorIdString是被监听坐席工号如:1002
typeInteger否0监听 1 耳语 默认0
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  • "code": 0,    
  • "message": "success",   
  •  "data": null
  •  }
回调接口示例
  • // 调用回调说明  
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "monitor":1,
  •         "type":"monitor",
  •         "status":0
  •     }
  • }

  • // 班长监听振铃
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "callid":"202080556074266084394",
  •         "userdata": {
  •             "caller":"18910393942",
  •             "called":"133111111",
  •             "groupid":802,
  •             "innercall":0,
  •             "origShowcaller":"18910393942",
  •             "agentkey":"3001@wucb",
  •             "dir":1,
  •             "type":"makecall"
  •         },
  •         "caller":"18910393942",
  •         "origcaller":"8715628449220000",
  •         "called":"133111111",
  •         "nowgroupid":802,
  •         "type":"monitorringing",
  •         "followData": {
  •  
  •         },
  •         "device":"202080557173764336715",
  •         "timestamp":1597223590
  •     }
  • }

  • // 班长监听接听
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "callid":"202080556074266084394",
  •         "userdata": {
  •             "caller":"18910393942",
  •             "called":"133111111",
  •             "groupid":802,
  •             "innercall":0,
  •             "origShowcaller":"18910393942",
  •             "agentkey":"3001@wucb",
  •             "dir":1,
  •             "type":"makecall"
  •         },
  •         "caller":"18910393942",
  •         "origcaller":"8715628449220000",
  •         "called":"133111111",
  •         "nowgroupid":802,
  •         "type":"monitorincall",
  •         "followData": {
  •  
  •         },
  •         "device":"202080557173764336715",
  •         "timestamp":1597223590
  •     }
  • }
 

3.1.14 转接

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"transfercall","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken","called":"3001@wucb","transferType":0}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:transfercall
callBackUrlString否回调地址
calledString是转接号码/转接坐席工号@企业/VDN
transferTypeInteger否0 默认 号码 1 VDN
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  •  "code": 0,    
  •  "message": "success",   
  •  "data": null
  • }
回调接口示例
  • // 转接中 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "type":"transfering"
  •     }
  • }
  •  
  • // 话后话单  
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "callid":"202080556074266084395",
  •         "auto":false,
  •         "called":"18910393942",
  •         "calledArea": {
  •             "city":"北京",
  •             "provice":"北京"
  •         },
  •         "operator_id":"1001",
  •         "altering_time":"2020-08-12 17:29:13",
  •         "end_time":"2020-08-12 17:29:41",
  •         "cause":0,
  •         "begin_time":"2020-08-12 17:29:13",
  •         "recordcode":"152_202080556074266084395_18910393942_18910393942_20200812172915_1597224555269",
  •         "callerArea": {
  •             "city":"北京",
  •             "provice":"北京"
  •         },
  •         "type":"after",
  •         "dir":1,
  •         "devicetype":"1",
  •         "duration":27,
  •         "agent_answer_time":"2020-08-12 17:29:14",
  •         "operator_name":"1001",
  •         "caller":"18910393942",
  •         "filename":"/app/clpms/record/20200812/152_202080556074266084395_18910393942_18910393942_20200812172915_1597224555269.wav",
  •         "hangupdir":0,
  •         "mediano":2,
  •         "rstime":"2020-08-12 17:29:15",
  •         "device":"202080557173764336716",
  •         "timestamp":1597224553
  •     }
  • }
 

3.1..15 取消转接

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"canceltransfercall","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:canceltransfercall
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    
  •   "code": 0,    
  •   "message": "success",    
  •   "data": null
  • }
回调接口示例
  • // 取消转接事件 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"取消转接或转接失败",
  •         "type":"transfercall",
  •         "dir":1,
  •         "status":1
  •     }
  • }
 

3.1.16 咨询

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"consult","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken","called":"3001@wucb"}
请求参数说明
参数名 参数类型 是否必填 备注 
cmdString是固定值:consult
callBackUrlString否回调地址
calledStirng是咨询号码外线/被咨询坐席工号@企业缩写
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例 
  • {    "code": 0,    "message": "success",    "data": null}
 回调接口示例
  • // 咨询是否发起成功
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "caller":"1001@wucb",
  •         "type":"agentconsult",
  •         "status":0
  •     }
  • }

  • // 被咨询方接听
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "type":"consultationcalls"
  •     }
  • }

3.1.17 咨询返回(被咨询方接通后,发起方有权让被咨询方挂机,恢复二人通话)

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"agentconsultback","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:agentconsultback
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    "code": 0,    "message": "success",    "data": null} 
回调接口示例
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "type":"agentconsultback",
  •         "dir":1,
  •         "status":0
  •     }
  • }

3.1.18 咨询转接

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"agentshift","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:agentshift
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    "code": 0,    "message": "success",    "data": null} 
 回调接口示例 
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "callid":"202080556074266084397",
  •         "answer_time":"2020-08-13 09:43:06",
  •         "auto":false,
  •         "called":"18910393942",
  •         "calledArea": {
  •             "city":"北京",
  •             "provice":"北京"
  •         },
  •         "operator_id":"1001",
  •         "altering_time":"2020-08-13 09:42:32",
  •         "cause":0,
  •         "callerArea": {
  •             "city":"北京",
  •             "provice":"北京"
  •         },
  •         "type":"after",
  •         "dir":1,
  •         "devicetype":"1",
  •         "duration":818,
  •         "agent_answer_time":"2020-08-13 09:42:33",
  •         "hangupdir":0,
  •         "rstime":"2020-08-13 09:42:34",
  •         "timestamp":1597282952,
  •         "end_time":"2020-08-13 09:56:11",
  •         "begin_time":"2020-08-13 09:42:32",
  •         "recordcode":"152_202080556074266084397_18910393942_18910393942_20200813094234_1597282954235",
  •         "operator_name":"1001",
  •         "caller":"18910393942",
  •         "filename":"/app/clpms/record/20200813/152_202080556074266084397_18910393942_18910393942_20200813094234_1597282954235.wav",
  •         "mediano":2,
  •         "device":"202080557173764336723"
  •     }
  • }

3.1.19 三方通话

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"tripartitetalk","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:tripartitetalk
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    "code": 0,    "message": "success",    "data": null}
 回调接口示例
  • // 发起三方成功
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"Success",
  •         "type":"tripartitetalk",
  •         "status":0 }

  • // 进入三方通话
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "type":"sanfangcall"
  •     }
  • }

3.1.20 咨询ivr 

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"consulationservice","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken","filename":"10043.xml"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:consulationservice
callBackUrlString否回调地址
filenameString是流程文件名
userDataString否穗路数据 json格式
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例 
  • {    "code": 0,    "message": "success",    "data": null} 
回调接口示例
  • // 发起咨询服务成功
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "reason":"咨询转接成功.",
  •         "type":"consulationservice",
  •         "status":0
  •     }
  • }

  • // 咨询服务返回
  • {
  •     "agentKey":"1001@wucb",
  •     "message": {
  •         "callid":"202080556074266084400",
  •         "userdata":"{"callid":"202080556074266084400","orgcaller":"18910393942","called":"18910393942","groupid":802,"origShowcaller":"18910393942","agentkey":"1001@wucb","orgcalled":"8715628449220019","dir":1,"type":"makecall","start_time":"2020-08-13 10:21:03","caller":"18910393942","companyid":152,"filename":"10043.xml","userdevice":"202080557173764336733","connect_time":"2020-08-13 10:21:35","innercall":0,"device":"202080557173764336733","followData":{"key":"value"},"timestamp":"1597285261"}",
  •         "caller":"18910393942",
  •         "called":"18910393942",
  •         "type":"answer",
  •         "followData": {
  •             "key":"value"
  •         }
  •     }
  • }

3.1.21 转接ivr

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"transferservice  ","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken","filename":"10043.xml"}
请求参数说明  
参数名 参数类型 是否必填 备注 
cmdString是固定值: 
transferservice 
callBackUrlString否回调地址
filenameString是流程文件名
userDataString否穗路数据 json格式
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例 
  • {    "code": 0,    "message": "success",    "data": null}
 回调接口示例
  • {"reason":"挂机成功","type":"cancelmakecall","status":0}}
  • {
  •     "agentKey":"1002@zl",
  •     "message": {
  •         "callid":"20207091162065780764",
  •         "answer_time":"2020-09-17 19:29:39",
  •         "auto":false,
  •         "called":"13300000000",
  •         "calledArea": {
  •             "city":"南宁",
  •             "provice":"广西"
  •         },
  •         "operator_id":"1002",
  •         "altering_time":"2020-09-17 19:29:35",
  •         "cause":0,
  •         "callerArea": {
  •             "city":"",
  •             "provice":""
  •         },
  •         "type":"after",
  •         "dir":1,
  •         "devicetype":"1",
  •         "duration":13,
  •         "agent_answer_time":"2020-09-17 19:29:37",
  •         "hangupdir":0,
  •         "rstime":"2020-09-17 19:29:39",
  •         "timestamp":1600342175,
  •         "end_time":"2020-09-17 19:29:50",
  •         "begin_time":"2020-09-17 19:29:35",
  •         "recordcode":"307_20207091162065780764_1002_13300000000_20200917192939_1600342179356",
  •         "operator_name":"1002",
  •         "caller":"1002",
  •         "filename":"/app/clpms/record/20200917/307_20207091162065780764_1002_13300000000_20200917192939_1600342179356.wav",
  •         "mediano":1,
  •         "device":"20207092261577408548"
  •     }
  • }
 

3.1.22 获取空闲坐席

请求地址https://177183.acloudcc.com/api/v1/cti/cc/api
请求方式get/post
身份验证用户名1000@wucb
 密码123456
请求头Content-Typeapplication/json
请求体{"cmd":"idleagents ","callBackUrl":"http://192.168.183.147:58113/openapi/token/getToken"}
请求参数说明 
参数名 参数类型 是否必填 备注 
cmdString是固定值:idleagents 
callBackUrlString否回调地址
agentString否需要操作的坐席工号(企业管理方式认证,必传)
返回参数示例
  • {    "code": 0,    "message": "success",    "data": null}
回调接口示例
  • // 空闲坐席列表 与ccs保持一致 
  • {
  •     "agentKey":"1002@zl",
  •     "message": {
  •         "data": [
  •              {
  •                 "agentInfo": [
  •  
  •                 ],
  •                 "groupid":1051,
  •                 "groupname":"用于总机中的分机1001登陆的默认队列",
  •                 "agents": [
  •  
  •                 ]
  •             },
  •              {
  •                 "agentInfo": [
  •                      {
  •                         "agentName":"1002",
  •                         "agentKey":"1002@zl",
  •                         "status":"onwork"
  •                     }
  •                 ],
  •                 "groupid":1038,
  •                 "groupname":"预测技能组1",
  •                 "agents": [
  •                     "1002@zl"
  •                 ]
  •             },
  •              {
  •                 "agentInfo": [
  •  
  •                 ],
  •                 "groupid":1039,
  •                 "groupname":"预览技能组1",
  •                 "agents": [
  •  
  •                 ]
  •             }
  •         ],
  •         "cmdtype":1,
  •         "type":"idleagents"
  •     }
  • }
 

3.1.23 呼入事件通知

  • // 呼入振铃 
  • {
  •     "agentKey":"1000@wucb",
  •     "message": {
  •         "callid":"202080556038358745993",
  •         "userdata": {
  •             "callId":"202080556038358745993",
  •             "caller":"18910393942",
  •             "companyId":152,
  •             "called":"01081470001",
  •             "groupid":802,
  •             "connect_time":1594886022328,
  •             "queuePlaying":true,
  •             "executed":true,
  •             "autocall":10,
  •             "agentKey":"1000@wucb",
  •             "agentkey":"1000@wucb",
  •             "dir":0
  •         },
  •         "caller":"18910393942",
  •         "origcaller":"18910393942",
  •         "called":"01081470001",
  •         "nowgroupid":802,
  •         "type":"inringing",
  •         "timestamp":1594886045
  •     }
  • }

  • // 正在播放工号
  • {
  •     "agentKey":"1000@wucb",
  •     "message": {
  •         "type":"playtts"
  •     }
  • }

  • // 呼入接听
  • {   "agentKey":"1000@wucb",
  •     "message": {
  •         "callid":"202080556038358745993",
  •         "caller":"18910393942",
  •         "called":"01081470001",
  •         "type":"incall"
  •     }
  • }