更新时间:2024-08-22 GMT+08:00
分享

监听接续事件

监听接续事件,即可以在您的企业系统中,对希望关注的通话事件进行监听,例如座席状态事件与音视频通话事件。如果您期望能在您的系统中能利用这些事件进行日志记录、弹屏提示等功能的开发,请您继续阅读本章节内容,我们提供的主要可监听事件如表1所示。事件详情请参考“云客服> API参考> 座席工作台> 附录> 事件”

表1 事件说明

事件

事件标示符

作用说明

座席忙

AgentState_Busy

表示座席正在进行呼叫处理。

工作中

AgentState_Work

表示某个座席进入工作整理态中。

示闲

AgentState_Ready

表示某个座席进入空闲状态。

示忙成功

AgentState_SetNotReady_Success

表示某个座席示忙成功。

取消示忙成功

AgentState_CancelNotReady_Success

表示某个座席取消示忙成功。

休息成功

AgentState_SetRest_Success

表示某个座席请求休息成功。

取消休息成功

AgentState_CancelRest_Success

表示某个座席取消请求休息成功。

休息超时提醒

AgentState_Rest_Timeout

表示某个座席请求休息后已经超时,提醒用户超时信息(此事件为提醒,并不代表座席退出休息态)。

进入工作态

AgentState_SetWork_Success

表示某个座席请求进入工作态成功。

退出工作态

AgentState_CancelWork_Success

示某个座席请求退出工作态成功。

座席进入talking

AgentEvent_Talking

表示某个座席进入Talking状态。

保持成功

AgentEvent_Customer_Alerting

表示当前座席已处于保持状态。

外呼失败

AgentEvent_Call_Out_Fail

座席发起外呼呼叫失败,可能失败的原因为电话号码不对等。

座席退出呼叫

AgentEvent_Call_Release

表示座席从指定callId的呼叫中退出。

客户退出呼叫

AgentEvent_Customer_Release

表示客户从指定的callId呼叫中退出。

座席物理话机振铃

AgentOther_PhoneAlerting

表示某个座席的物理话机正在振铃。

您可以通过我们以下示例在您的页面对所需的事件进行监听,以下以“座席物理话机振铃”为例。

某页面集成了轻量接续条,需要在座席收到来话时,在页面上进行振铃提示,可以通过设置回调方法callback,捕获"AgentOther_PhoneAlerting"事件,实现来话提醒功能。参考代码如下:
callback = function(data){
  alert("来电话啦")
}

window.onload = function(){
  var param = new Array;
  param.push("AgentOther_PhoneAlerting");
  var json={name:"eventpost",param:param}

  setTimeout(function(){ window.frames["ccbarclient"].postMessage(JSON.stringify(json), $aicc_ContextPath); }, 2000)//如果出现window.frames["ccbarclient"]值报错,可以将对应检查时间适当设置更大一点,例如设置为3000,4000等。
}				
if (window.addEventListener) { 
  window.addEventListener('message', callback); } 
else { 
  window.attachEvent('onmessage', callback); 
} 

callback:回调方法,实现具体的业务功能。

$aicc_ContextPath:域名,会在集成js加载成功后在页面中生成。

ccbarclient:被集成的集成接续条的iframe名称。

eventpost:注册在集成接续条中的获取接续事件的方法的名称。

addEventListener:添加接续事件监听。

相关文档