接口说明
该规范由优音通信定义,客户系统需按此规范实现该接口。优音通信平台 调用该接口将呼叫事件主动推送给客户系统。
呼叫事件详细数据以 json 字符串格式封装,通过 http post 方式推送给客户
接口名称
pushCallEvent
数据格式
{"eventData":
"{"account":"4006350623",
"calledid":"8004042291",
"callingid":"01053917692",
"endTime":"20191031140332",
"event":"disconnected",
"extension":"1001",
"serviceSn":"sdc21536478ddsas",
"startTime":"20191031140341",
"transferresult":"1" }"
}
参数说明
序号 | 名称 | 是否必填 | 说明 |
---|---|---|---|
1 | serviceSn | 是 | 同一通通话唯一标识 |
2 | account | 是 | 企业 400 |
3 | calledid | 是 | 被叫号码 |
4 | callingid | 是 | 主叫号码 |
5 | extension | 是 | 分机号码 |
6 | event | 是 | 事件状态 |
7 | startTime | 是 | 通话开始时间 |
8 | endTime | 是 | 通话结束时间 |
9 | transferresult | 是 | 接听状态:1 接通 -1 主叫主动挂机 -2 被叫电话不应答 |
event事件类型说明
event 事件类型 | startTime 具体含义 | endTime 具体含义 |
---|---|---|
alert(来电) | 平台来电接入时间 | 无 |
transfer(转接) | 开始转接时间 | 无 |
transferfail(转接失败) | 无 | 无 |
connected(接通) | 开始通话时间 | 无 |
disconnected(挂断) | 无 | 通话结束时间 |
callout(开始外呼) | 无 | 无 |
calloutanswer(外呼接通) | 无 | 无 |
calloutdropped(外呼挂断) | 无 | 无 |
取参示例
public Object pushCallEvent(HttpServletRequest request){
ResultBase rb = new ResultBase();
StringBuffer jb = new StringBuffer();
String line = null;
try{
BufferedReader reader = request.getReader();
while((line = reader.readLine()) != null){
jb.append(line);
}
System.out.println("推送数据为:" + jb);
com.alibaba.fastjson.JSONObject json = com.alibaba.fastjson.JSONObject.parseObject(jb.toString());
String eventData = json.getString("eventData");
com.alibaba.fastjson.JSONObject jsonData = com.alibaba.fastjson.JSONObject.parseObject(eventData);
String account = jsonData.getString("account");
rb.setResult("200"); rb.setMessage("success");
}catch(Exception e){
/* report an error */
rb.setResult("100");
rb.setMessage("failure");
}
return rb;
}
返回结果示例
{ "message": "success", "result": "200" }
result:200-成功。其他-失败
文档更新时间: 2022-08-10 10:40 作者:admin