预定义变量

本帮助页面上的信息同时适用于 CXone StudioDesktop Studio

预定义变量是已定义的系统变量。您无需创建它们即可在脚本中使用它们。可以覆盖预定义变量的预期值,但不建议这样做。仅当在线帮助或 CXone 客户代表 指示您时才覆盖这些内容。

预定义变量会自动添加到脚本中。有些变量来自在交互路由到脚本之前在后台运行的系统脚本。这些变量也称为系统变量。其他预定义变量来自您添加到脚本中的操作。您可以使用追踪工具查看脚本中的变量。单击追踪输出中的每个操作时,“变量”选项卡将显示此时脚本中的操作。

查看脚本中的预定义变量

您可以使用跟踪工具查看脚本中的变量。如果您在交互期间跟踪脚本,您可以查看传递到其中的变量。这些变量来自系统脚本和其他来源,例如电话服务提供商。您可以通过模拟交互来跟踪脚本,但只能查看从系统脚本传递到其中的变量。本节介绍跟踪模拟的呼入电话脚本。您还可以通过在其他交互上运行跟踪来查看脚本中的预定义变量。

  1. Studio 中,打开脚本。
  2. 单击脚本画布上的空白区域,然后单击 Properties 选项卡。
  3. 单击 Inbound 将其展开,然后完成以下属性:

    • PhoneNumber:输入您有权访问的电话号码。
    • SimulateInbound:选择 True
    • SimulationANI:输入用于 PhoneNumber 属性的相同号码。
    • SimulationDNIS:输入另一个电话号码。这不必是真实的电话号码。
  4. Studio 工具栏中,单击 Start with Trace
  5. 当您的电话响起时,请接听。如果您想在脚本中进一步查看由操作添加的变量,您可以按照提示进行操作。如果您想查看传递到脚本中的系统变量,您可以挂断。
  6. 在“跟踪输出”窗口中,单击 Begin 操作。Variables 选项卡显示从系统脚本传递到该脚本中的所有变量。

  7. 双击变量可查看该变量的名称及其值。这对于具有不适合 Value 列的长值的变量很有帮助。

    如果您希望在交互过程中查看添加到脚本中的其他变量,请单击该Trace Output 窗口主部分中的其他操作。

常见预定义变量

下表包含了一些比较常见的预定义变量。并非每个脚本都包含列表中的所有变量。脚本中可用的预定义变量取决于脚本的媒体类型和脚本中使用的操作。此外,一些变量来自服务提供商。这些变量可能会根据提供商的不同而变化。

在使用本节中的任何变量之前,请使用跟踪工具验证它们是否存在于您正在处理的脚本中。当未将此变量传递到脚本中或者通过操作添加了此变量时,在脚本中使用预定义变量可能会导致脚本无法按您的预期运行。

如果可能,请使用实时交互而不是模拟交互来验证脚本中的变量。模拟交互可能包含实时交互不包含的变量。同样,实时交互可能包含模拟不包含的变量。

变量名称 说明
__agentContactID 坐席应用程序 会话的会话 ID。
__agentId 回答交互的坐席的 ID。在坐席回答交互之前,该变量不包含任何值。
ANI

北美编号计划格式的呼叫者电话号码。这是北美电话号码的标准格式。e164ANI 变量保存相同号码,但采用国际格式。

该值来自电话运营商。可能的值包括 RestrictedAnonymous

busno

业务单位关闭 用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组的编号。这是 CXone您公司的唯一标识符

如果您的组织有多个业务单位,您可以使用此值在脚本中使用逻辑确定。例如,您可以在分配 ACD 技能关闭 用于根据坐席的技能、能力和知识自动传递交互之前检查 busno,以确保您正在分配的技能存在于该业务单位中。

contactId 每个联系人的唯一标识符。您可以使用 contactId查找特定的联系人并生成报告。如果生成了次脚本,将创建一个新的 contactId
city 呼叫发起所在的城市的名称。

对于呼入交互,该值来自联系人的服务提供商。对于呼出交互,该值来自您的服务提供商。

country

呼入或呼出呼叫的电话号码字符串中的国家/地区代码(见下一项)所指代的国家/地区名称。CXone 电话平台基于国际电信联盟 (ITU) 的值自动生成此值,并在呼叫元数据关闭 提供其他数据相关信息的数据。中传递该值。

对于呼入交互,该值来自联系人的服务提供商。对于呼出交互,该值来自您的服务提供商。

countryCode

国际电信联盟 (ITU) 代码,用于指代呼入呼叫的来源国/地区,或呼出呼叫的目的国/地区。此代码出现在任何电话号码字符串的开头,并在呼叫元数据中传递。例如,美国的 ITU 代码是 +1。要查看任何指定国家/地区的代码,请在 Internet 上搜索国家/地区代码 <country>。其格式可能因呼叫来源而异。

对于呼入交互,该值来自联系人的服务提供商。对于呼出交互,该值来自您的服务提供商。

DNIS 呼叫者拨打的号码(采用北美编号计划格式)。这是北美电话号码的标准格式。e164DNIS 变量保存相同号码,但采用国际格式。

e164ANI

e164DNIS

ANI关闭 也称为呼叫者 ID。所列的语音来电的电话号码。DNIS关闭 识别联系人在呼入语音呼叫联系您时拨打的号码,以及坐席或系统在呼出语音呼叫时拨打的号码。 根据 E.164 电话格式标准进行了格式化。E.164 是用于格式化美国境外电话号码的国际标准。
from 发件人的电子邮件地址。
isReskill 表示在当前联系人 ID 方面已进行了技能重塑。值为 1 (true) 或 0 (false)。
__lastStateChange 联系人上次更改状态的时间戳。例如,当联系人从“队列等待前”状态变为“队列等待”状态时,此变量将填充发生此变化时的时间戳。
masterId

使源自同一父级的所有脚本都可识别的唯一标识符。当一个脚本衍生另一个脚本或从另一个脚本运行该脚本时使用它。对于父脚本,contactIdmasterId 是相同的。对于任何子脚本,contactId 是一个唯一的新值,而 masterId 是与父脚本的 contactId 相同的值。

例如,当您对交互进行技能重塑时,已进行了技能重塑的交互的 masterId 与原始交互的 contactId 相同。如果再一次对该交互进行了技能重塑,则最新进行了技能重塑的交互的 masterId 与子脚本的 contactId 相同。

__mediaServerName 媒体服务器的名称。在与 NICE CXone 技术支持合作时,此变量对于解决与服务器相关的问题非常有用。问题包括远程延迟或电话问题等。
__POC 联络点关闭 呼入联系人用来发起交互的入口点,如电话号码或电子邮件地址。的唯一 ID。它与 CXone ACD 应用程序中的 ID 相匹配。
__SIPInvite 包含联系人的标头信息。如果您将呼叫从一个业务单位关闭 用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组转移到另一个业务单位,则此变量包含有关原始呼叫的信息。例如,您可以访问来自原始的呼叫的 contactID
__Skill

特定 ACD 技能关闭 用于根据坐席的技能、能力和知识自动传递交互的唯一标识符。您可以使用 __Skill变量查找具体的技能并生成相关报告。该值可通过 Reqagent 操作进行更改。

_SkillName ACD 技能的名称。它伴随着 __Skill 并且可通过 Reqagent 操作进行更改。

state 呼叫者居住地所在的美国的州。该值来自联系人的服务提供商。
test 不要尝试在 Snippet 操作CXone Studio 中的帮助页面:操作之外设置此变量。这样做可能会导致严重的后果。这是为在 Snippet 操作中调试代码而保留的。
to 目的地电子邮件地址。

来自 Uptivity 的预定义变量

变量名称 说明
_customFilter

此变量的值用作 NICE Uptivity 中的 ACD Gate 筛选器

_user1 - _user 8

这些变量的值用于填充 NICE Uptivity 中的 User 1 through User 8 字段

User9

尽管 User9 在技术上不是一个变量,但它确实从坐席的用户帐户中获取其值,特别是 Custom 1 属性中的值,并填充 NICE Uptivity 中的 User 9 字段。

User10 尽管 User10 在技术上不是一个变量,但它确实从坐席的用户帐户中获取其值,特别是 Custom 2 属性中的值,并填充 NICE Uptivity 中的 User 10 字段。
_surveyDNIS

是用户创建的唯一 ID,是在创建 NICE Uptivity 调查时赋予的值,用于确定在回呼关闭 保留客户在队列中的位置,并在客户移动到队列前面时自动呼叫该客户。期间运行哪个调查。

_surveyCallbackDNIS

该值是将在调查回呼中使用的数字。此变量仅用于 NICE Uptivity 调查。

_surveyCallbackANI

该值是调查回呼期间显示的呼叫者 ID。此变量仅用于 NICE Uptivity 调查。