音视频通话

排队

功能介绍

在呼叫中心的业务场景下,有多个客户呼叫进来,有多个坐席提供服务,简单的一对一呼叫无法满足业务需求。此时可以使用我们的排队功能,客户不再直接呼叫某个坐席,而是呼叫到一个坐席队列,由系统自动给客户分配一个空闲的坐席。

  • 多个坐席可以服务于一个队列,客户排队这个队列时,系统会自动分配一个空闲坐席来提供服务。
  • 一个坐席可以同时服务多个队列,优先服务高优先级队列里的客户,队列优先级相同时优先服务最早排队的客户。
  • 业务高峰期没有空闲的坐席时,客户将在队列中排队等待,当有坐席空闲时,将为最早排队的客户提供服务。
  • 同一队列的坐席可以配置不同的坐席优先级,队列中的客户优先由空闲的高优先级的坐席来提供服务。
注意:

在登录成功并且启用呼叫功能的情况下才可以使用排队功能

1.创建队列

可以通过两种方式创建队列:

2.初始化队列

在登录成功后,初始化队列信息

  • 调用接口:
import { CrSDK, CrSDKNotifier, NOTIFIER_EVENT } from '@cr/react-native-rtc';

// 初始化队列数据
const initRes = await CrSDK.instance.initQueue();
if (initRes.sdkErr === 0) {
  console.log('队列初始化成功');
} else {
  console.log(`队列初始化失败:${initRes.sdkErr}`);
}

// 订阅队列事件
class QueueListener extends CrSDKNotifier {
  // 队列状态变化通知
  queueStatusChanged(statusJson: string) {
    const status = JSON.parse(statusJson);
  }

  // 排队信息变化通知
  queuingInfoChanged(infoJson: string) {
    const info = JSON.parse(infoJson);
  }

  // 自动分配用户通知
  autoAssignUser(userInfoJson: string) {
    const userInfo = JSON.parse(userInfoJson);
  }

  // 分配用户被取消通知
  cancelAssignUser(queID: number, userID: string) {}
}

const listener = new QueueListener();
listener.addCrNotifierListener([
  NOTIFIER_EVENT.queueStatusChanged,
  NOTIFIER_EVENT.queuingInfoChanged,
  NOTIFIER_EVENT.autoAssignUser,
  NOTIFIER_EVENT.cancelAssignUser,
]);

相关 API 请参考:

3.获取队列信息

在初始化队列成功后,才可以使用获取队列信息。并且可以多次获取。

  • 调用接口:
// 获取队列信息
const queueList = await CrSDK.instance.getAllQueueInfo();

相关 API 请参考:

相关结构定义请参考:

4.1坐席:服务队列

  • 调用接口:
// 开始服务某个队列(可以多次调用,开启对多个队列的服务)
const result = await CrSDK.instance.startService(queID);

// 停止服务某个队列
const result2 = await CrSDK.instance.stopService(queID);

相关 API 请参考:

相关结构定义请参考:

4.2客户:排队

客户选择一个队列进行排队,每次只能排一个队列

  • 调用接口:
// 开始/停止排队,会触发队列状态变化通知,即上面 QueueListener 的回调
const result = await CrSDK.instance.startQueuing(queID); // 客户开始排队

const result2 = await CrSDK.instance.stopQueuing(); // 客户停止排队

相关 API 请参考:

相关结构定义请参考:

5.系统给坐席分配客户

客户分配模式有自动和手动两种:

  • 在自动分配模式下,坐席一旦空闲系统就会立即分配当前排队的客户过来,适用于坐席可以持续提供服务的业务场景。
  • 在手动分配模式下,坐席空闲后系统不自动分配客户,而是坐席准备好后手动触发分配一个当前排队的客户,适用于坐席接待完客户后需要进行信息录入之类的善后工作,或者需要在接待新客户之前进行一些准备工作的业务场景。

自动分配模式:

  • 回调通知:
// 在 QueueListener 中处理 autoAssignUser 和 cancelAssignUser
class QueueListener extends CrSDKNotifier {
  autoAssignUser(userInfoJson: string) {
    const user = JSON.parse(userInfoJson);
    if (/* 接受系统分配的客户 */) {
      const result = await CrSDK.instance.acceptAssignUser(user.queID, user.usrID);
      // 接下来做其他任务…… 例如:创建房间
    } else {
      // 拒绝系统分配的客户
      const result = await CrSDK.instance.rejectAssignUser(user.queID, user.usrID);
    }
  }

  cancelAssignUser(queID: number, userID: string) {
    // 系统取消已经安排的客户,坐席不应该再进入房间……
  }
}

相关 API 请参考:

手动分配模式:

  • 调用接口:
// 坐席请求客户分为 2步:
// 1. 开启免打扰状态
const result = await CrSDK.instance.setDNDStatus(1);

// 2. 请求分配一个客户
const userResult = await CrSDK.instance.reqAssignUser();

相关 API 请参考:

6.坐席呼叫客户

接受系统分配的客户后, 就可以向客户发起呼叫处理, 相关流程参见:呼叫功能