5. 注册事件回调

5.1 添加事件监听

接口名称:CallCenter.addEventListener (event,fun)
功能:增加事件的监听
参数:
参数名类型说明
eventstring事件名称
funfunction监听函数
返回值:事件ID,通过该事件ID可以移除监听的事件
示例:
  • // 添加事件监听
  • CallCenter.addEventListener("after",function(json){
  •  // json 响应数据
  • });
注意:
多次添加同一事件会依次执行,不会覆盖
添加事件时记录事件ID,该ID在移除事件时提供,否则无法移除事件

5.2 移除事件监听

接口名称:CallCenter.removeEventListener (event,uuid)
功能:移除指定事件的监听函数
参数:
参数名类型说明
eventstring事件名称
uuidstring事件ID,添加事件时的返回值,不能通过其它方式获取
返回值:0失败或事件未注册,非0成功
示例:
  • // 移除事件监听
  • CallCenter.removeEventListener("answer","1254");
注意:

5.3 查看事件监听绑定数量

接口名称:getEventListenerCount (event)
功能:返回指定事件绑定监听函数个数
参数:
参数名类型说明
eventstring事件名称
返回值:绑定数量
示例:
  • CallCenter. getEventListenerCount (“answer”)
注意:
说明SDK提供一系列事件供集成时自定义事件行为,如:集成方可以根据自己需要注册登录事件回调(logon),当座席登录时,SDK调用回调,响应自定义事件行为。
 
所有的事件回调必须注册到CallCenter对象(语法如下),回调函数调用时会传入事件数据,供集成时使用。
示例// 注册outringing事件
CallCenter.addEventListener(‘outringing’,function(json){
//TODO:  此处为事件回调代码
//json为outringing事件触发时传入的事件数据
})
 
//注册answer事件
CallCenter.addEventListener(‘answer’,function(json){
//TODO:  此处为事件回调代码
//json为answer事件触发时传入的事件数据
})
 
//注册after事件
CallCenter.addEventListener(‘after’,function(json){
//TODO:  此处为事件回调代码
//json为after事件触发时传入的事件数据
})
注意不同的事件接收的事件数据不同,根据业务需要区分处理
手动外呼被叫正常振铃接听事件顺序:
logon(登录)àagentidle(座席空闲)àmakecall(外呼)àoutringing(座席端振铃)àoutcall(座席摘机)àcalledringing(被叫振铃)àanswer(被叫应答)àafter(话后)àagentidle(座席空闲)
预测外呼正常转接座席事件顺序:
logon(登录)àinringing(座席端振铃)àincall(座席端摘机)àagentidle(座席空闲) à outringing(座席端振铃)àoutboundcall(接通被叫)àafter(话后)àagentidle(座席空闲)
呼入座席接听事件顺序:
logon(登录)àagentidle(座席空闲)àinringing(呼入振铃)[àplaytts(播放TTS)开通后存在]àincall(座席端摘机)àafter(话后)àagentidle(座席空闲)