接口说明
该规范由优音通信定义,客户系统需按此规范实现该接口。优音通信平台 调用该接口将呼叫事件主动推送给客户系统。
呼叫事件详细数据以 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