邀请者信息类 JCCInviter

用于存储和管理呼叫中心系统中发起邀请的成员信息,主要用于座席邀请访客的场景。 包含用户ID、昵称、业务号和扩展信息等基本属性,通过这些信息可以标识邀请者并进行相关业务处理。 在通话状态变化回调 JCCGuestCallback.onCallStateChanged 中作为参数传递,提供邀请者的详细信息。

// 在回调中处理邀请者信息
const guestCallback: JCCGuestCallback = {
onCallStateChanged: (type, incomingType, inviter, reason) => {
if (type === JCCGuestCallStateChangeType.INCOMING) {
console.info(`收到来自 ${inviter.displayName}(${inviter.userId}) 的呼叫`);
console.info(`业务号: ${inviter.businessNumber}`);
console.info(`附加信息: ${inviter.extraInfo}`);
}
}
};

Accessors

  • get userId(): undefined | string

    获取用户ID

    Returns undefined | string

    用户ID,如果未设置则返回undefined

    返回邀请者的用户ID,可用于身份识别和权限验证。 用户ID通常是系统中用户的唯一标识符,可用于后续的业务处理和日志记录。

    // 根据用户ID处理不同的邀请者
    if (inviter.userId === "admin") {
    // 处理管理员邀请
    } else {
    // 处理普通座席邀请
    }
  • get displayName(): undefined | string

    获取用户昵称

    Returns undefined | string

    用户昵称,如果未设置则返回undefined

    返回邀请者的显示名称,通常用于UI界面展示。 昵称相比用户ID更加友好,适合在用户界面上显示,提升用户体验。

    // 在来电界面显示邀请者昵称
    Text(`来电: ${inviter.displayName || "未知用户"}`)
    .fontSize(18)
    .fontWeight(FontWeight.Bold);
  • get businessNumber(): undefined | string

    获取邀请者业务号

    Returns undefined | string

    业务号,如果未设置则返回undefined

    返回座席所属的业务号,用于确定服务类型和路由规则。 业务号通常用于区分不同的业务线,如售前咨询、售后服务、技术支持等。

    // 根据业务号确定处理方式
    switch (inviter.businessNumber) {
    case "10086":
    // 处理售前咨询
    break;
    case "10087":
    // 处理技术支持
    break;
    default:
    // 处理其他业务
    }
  • get extraInfo(): undefined | string

    获取邀请者扩展信息

    Returns undefined | string

    扩展信息,如果未设置则返回undefined

    返回邀请者的额外信息,可用于传递自定义数据和业务逻辑处理。 扩展信息通常以JSON字符串形式传递,可包含自定义字段用于特定业务场景。

    // 解析扩展信息中的自定义数据
    if (inviter.extraInfo) {
    try {
    const extraData = JSON.parse(inviter.extraInfo);
    if (extraData.urgent) {
    // 处理紧急呼叫
    }
    } catch (e) {
    console.error("解析扩展信息失败");
    }
    }