8. 通话事务部分

8.1 通话事务文件

通话事务文件位于CCSDK根目录下。需要用到活动及拨打模式切换时引入通话事务文件。
 
 

8.2 通话模式切换

8.2.1 通话模式介绍

活动支持两种拨打模式：
预览外呼模式：坐席签入语音平台，业务系统通过集成SDK预览接口获取到联系人信息，坐席通过业务系统呼叫按钮发起外呼，外呼结束，坐席处理拨打结果，业务系统通过集成SDK预览接口提交拨打结果的外呼模式。
预测外呼模式：坐席签入语音平台，语音平台根据活动的配置策略，通过最优拨打算法，发起智能外呼，外呼结束，坐席处理拨打结果的外呼模式。

8.2.2 通话模式切换事件

每次坐席签入有活动在执行，且活动拨打模式切换时，都会收到callmodelchange事件，监听callmodelchange事件，获取活动拨打方式：
事件参数名参数类型参数说明
typestring固定值 callmodelchange 
cmdtypeint固定值1
statusint状态码 0成功 非0失败
prev_call_typeint前一次拨打模式，0预览，1预测
next_call_typeint要切换的拨打模式，0预览，1预测
groupidint执行活动的技能组ID
taskidint当前执行拨打模式ID
contact_group_idInt任务关联的联系人组ID
 示例：
  • var prevCallType, nextCallType, needToggleCallModel, groupId,taskid;
    • 

  • CallCenter.addEventListener("callmodelchange", function (json) {
    • 

  •  prevCallType = json.prev_call_type;
    • 

  •  nextCallType = json.next_call_type;
    • 

  • groupId = json.groupid;
    • 

  • taskid=json.taskid;
    • 

  •  
    • 

  • // 拨打模式相同时则不需要切换
    • 

  •  needToggleCallModel = prevCallType !== nextCallType;
    • 

  • });
 注意：
1. 坐席通话中不要进行模式切换
2. 相同拨打模式不要进行模式切换
3. 考虑到坐席在签入请求前拨打模式未切换，签入之后拨打模式已切换的场景，需要每次坐席签入时调用【11.3.4 获取拨打模式】接口，获取坐席签入的初始拨打模式。

8.2.3 通话模式通知事件

活动中轮次切换、拨打名单切换时会有sendmsg 事件通知，监听sendmsg事件获取通知信息。
事件参数名参数类型参数说明
typestring固定值 sendmsg 
cmdtypeint固定值1
msgstring通知消息
 示例：
  • CallCenter.addEventListener(“sendmsg”,function(json){
    • 

  •  // 如果收到的是任务通知
    • 

  • if(!json.json.annoucement){
    • 

  • // {"msg":"任务[SY的任务042]第[1]轮次,已结束.","type":"sendmsg","cmdtype":1}
    • 

  • }
    • 

  • });

8.2.4 切换为预览外呼模式

接口名称：CallCenter.Transaction.callModel.preview()
功能：切换拨打模式为预览外呼模式
参数：无
返回值：无
示例：
  • if (needToggleCallModel && nextCallType === 0) {
    • 

  •  CallCenter.Transaction.callModel.preview();
    • 

  •  if(!CallCenter.isCalling()){
    • 

  • needToggleCallModel = false;
    • 

  • }
    • 

  • }
注意：
1. 坐席通话中不要进行模式切换
2. 相同拨打模式不要进行模式切换
 

8.2.5 切换为预测外呼模式

接口名称：CallCenter.Transaction.callModel.predict()
功能：切换拨打模式为预测外呼模式
参数：无
返回值：无
示例：
  • if (needToggleCallModel && nextCallType === 1) {
    • 

  •     CallCenter.Transaction.callModel.predict();
    • 

  • if(!CallCenter.isCalling()){
    • 

  • needToggleCallModel = false;
    • 

  • }
    • 

  • }
 注意：
1. 坐席通话中不要进行模式切换
2. 相同拨打模式不要进行模式切换
3. 预览切换为预测时需要考虑最后一个获取到的名单的拨打情况