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