监听接续事件

监听接续事件，即可以在您的企业系统中，对希望关注的通话事件进行监听，例如座席状态事件与音视频通话事件。如果您期望能在您的系统中能利用这些事件进行日志记录、弹屏提示等功能的开发，请您继续阅读本章节内容，我们提供的主要可监听事件如表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); 
}