Studio基础知识

本帮助页面适用于 CXone Studio。此信息也可用于Desktop Studio。

脚本是 CXone 在联系中心如何工作的重要组成部分。它们定义与您组织联系的人员如何联系可以帮助他们的坐席。脚本指定交互期间和交互之后数据发生的情况。这包括将数据显示为面向坐席的弹出屏幕一个可配置的弹出窗口，包含有关联系人的信息。它在某个事件后出现在坐席的屏幕上，通常在坐席连接到一个联系人时。、从联系人捕获数据，以及将数据存储在数据库中。

您的联系中心可能有许多不同的脚本，或者只有几个。所需脚本的确切数目和类型取决于您组织使用的应用程序和功能以及所处理的交互类型。脚本范围可以从非常简单到相当复杂。简单的脚本不需要太多的脚本或代码编写知识。复杂的脚本可能需要自定义脚本代码。

本页概述了有关脚本及其工作方式的基本信息和概念。它还描述了脚本编写如何在联系中心的大局中与 CXone 相适应。

Classics, Inc. 是一家国际书商，正在其联系中心里设立 CXone。Classics, Inc 的联系中心管理员 Christopher Robin 与 Classics Studio 脚本编写者 Eeyore Thistleflower 合作，规划其需要创建的脚本。

Classics 联络中心接收来自其网站的拨入电话、电子邮件和聊天消息。同时还呼出电话并发送电子邮件。此外，Christopher 知道该公司计划开始向客户发送短信，通知他们即将进行的销售和促销活动。基于此，Eeyore 确定去需要用于呼入电话、电子邮件和聊天以及呼出电话、电子邮件和短信的脚本。

Christopher 和 Eeyore 接下来确定的是每个脚本所需的信息。呼入脚本需要从联系人收集某些数据。例如，对于聊天交互，脚本可以提示联系人提供详细信息，例如他们的姓名和他们正在寻求的帮助类型。可将该信息传递给坐席。可将某些信息（例如联系人的姓名、他们的问题和解决方案）传递到 Classics 使用的 CRM 管理联系人、销售信息、支持详细信息和案例历史记录等事项的第三方系统。系统。

一旦脚本被规划好，Eeyore 就开始开发和测试脚本。

CXone 术语

以下列表定义了在编写脚本时需要了解的一些 CXone 术语：

ACD 技能：ACD 技能用于自动将联系人路由至最有可能帮助他们的坐席。可创建它们来使用任何标准，例如部门、团队、专业或经过培训的能力。他们还可以使用其他因素，例如位置、语言等。将 ACD 技能分配给坐席。Studio 脚本使用 ACD 技能来进行自动路由。
渠道：渠道是一种与联系人通信的方法，例如电话、电子邮件、短消息或短信、聊天、社交媒体、语音邮件，等等。每种渠道在 Studio 中都有自己的脚本媒体类型。
联系人：与您的组织交互的人员称为联系人。联系人具有与其关联的 ID 号，用于跟踪平台之间的交互。在 Studio 联机帮助中，联系人也可以指 CXone 中引用与交互相关的数据的项目。
数字：此术语指与 Digital Experience 相关的渠道、技能、脚本、联系人和交互。
交互：这是联系人和坐席之间的完整对话。交互可以是一个电话、持续几个小时的聊天对话，或者包含多条来回消息的电子邮件线程。在数字渠道上，交互可以持续数天、数周或更长时间。
媒体类型：媒体类型是脚本使用的渠道类型，例如电话、聊天、电子邮件等。在您创建脚本时，您是为特定媒体类型创建的脚本。
联络点：联络点 (POC) 是 CXone 平台的入口点。CXone 创建 POC 的目的是定义渠道的特定实例。每个 POC 都被分配有一个 ACD 技能和一个 Studio 脚本。分配给 POC 的脚本必须定义从该渠道上的交互开始时联系人所发生情况的流程。

脚本和 CXone

如果没有脚本，CXone 就无法运行。您组织在 CXone 中使用的每种通信方法（例如电话、电子邮件、聊天等）都需要脚本。脚本定义组织的坐席与他们交谈的人员之间交互期间和之后发生的情况。

下图概述了 CXone 以及它在哪些方面适应组织的大局。它还展示了脚本如何与 CXone 的每个部分以及 CXone 之外的应用程序和系统进行交互。

该图有几点需要注意：

它代表两个呼入渠道，语音和数字聊天。CXone 中的呼入渠道还有许多其他可能性，包括电子邮件和社交媒体。呼入意味着联系人开始与您的组织进行交互。CXone 还支持某些渠道上的呼出交互，以便坐席可以开始交互。CXone 需要单独的脚本进行呼入和呼出交互。
该图显示了两种脚本：
- 系统脚本在后台运行。它们处理 CXone 中无法自定义的进程。您无法修改系统脚本或在 Studio 中查看它们，但知道它们在那里会很有帮助。
- 自定义脚本是您和组织中的其他脚本编写者在 Studio 中创建的内容。它们从交互开始时就控制联系人所发生的事情。自定义脚本还可以控制交互过程中生成和收集的数据，以及交互结束后数据所发生的情况。
系统脚本识别交互正在使用哪个 POC 呼入联系人用来发起交互的入口点，如电话号码或电子邮件地址。。它们分配 POC 已分配的默认 ACD 技能，并将联系人路由至 POC 分配的自定义脚本。ACD 技能和自定义脚本是在 CXone 中创建 POC 时分配的。
自定义脚本可以控制联系人在 CXone 平台中的流程。脚本从 POC 指定的默认 ACD 技能开始。它可以包括 IVR 自动电话菜单，允许呼叫者通过语音命令、按键输入或两者进行交互，以获得信息、路由呼入的语音呼叫或两者。或 ASR 允许联系人通过说话、按手机按键或两者的结合来响应录制的语音提示。菜单或其他机制，以确定每个联系人要使用的更具体的技能。

例如，电话脚本可能包括一个 IVR 菜单，供联系人选择。此菜单可能会显示：“销售请按 1；支持请按 2；计费请按 3。”菜单选项与 ACD 技能相对应。

作为脚本编写者，您可以设置脚本，当联系人按 2 时，就会请求具备支持 ACD 技能的坐席。要进一步了解如何操作，“开始使用 Studio”部分中的开发基本脚本教程第二部分提供了配置脚本以使用 ACD 技能路由的详细步骤。
自定义脚本可以与各种第三方应用程序集成，例如 CRM 管理联系人、销售信息、支持详细信息和案例历史记录等事项的第三方系统。、数据库、虚拟坐席机器人代替现场人工坐席处理客户交互的软件应用程序。或其他服务。例如，您可以从 CRM 检索客户信息，以便在交互开始时向坐席显示。交互完成后，您可以将交互过程中收集的数据保存在 CRM 的联系人记录中。

CXone 和 Studio 中的联系人

术语联系人表示 CXone 中的两个重要概念：

与您组织中的坐席交互的人员。例如，顾客、客户、网站访问者等。
CXone 平台中引用与交互相关的数据的项目。每个联系人都有一个与其关联的 ID 号。此 ID 跟踪平台之间的交互。

Tigger Tigerson 对其订单有疑问，因此他致电 Classics, Inc.。在 CXone 平台中，Tigger 是呼入联系人，因为他以客户身份拨入公司。他的呼叫进入 CXone 平台，联系人 ID 为 7892349239。此联系人 ID 引用与交互相关的数据，例如记录文本、录音和联系历史记录。

当联系人进入系统时，脚本实例会运行，并且 ACD 会为该实例分配一个联系人 ID。这种情况发生在呼入和呼出交互中。在交互过程中收集信息，例如联系人姓名、帐号等。交互期间可能会生成其他信息，例如通话记录和录音。所有这些信息都与交互过程中脚本中的联系人 ID 相关联。交互结束后，与联系人 ID 相关的大部分信息都会被丢弃，除非脚本设计为保存它。某些信息（例如通话录音和联系历史记录）会保留在平台中以用于其他用途。

联系人 ID 标识交互的一个部分。一个完整的交互可能涉及几个部分。新的片段可能会发生在某些情况下，例如呼叫被转移到另一个坐席，或者脚本衍生另一个脚本时。当这些事件发生时，新的联系人 ID 就会开始。在大多数情况下，两个联系人 ID 在整个交互过程中都保持活动状态。新联系人 ID 有时称为子联系人。

在数字脚本中，联系人 ID 不会更改。联系人在整个交互过程中保持相同的 ID。其例外情况是坐席将交互升级到不同的渠道。每个渠道的交互将具有不同的联系人 ID。

为了跟踪与单次交互关联的所有联系人 ID，还会为联系人分配一个主 ID。分配给联系人的任何联系人 ID 都被分组在其主 ID 下。

当您想要在脚本中引用联系人时，您需要在交互的适当部分使用联系人 ID。联系人和主 ID 存储在 contactId 和 masterId 变量中。它们是预定义变量，您可以在脚本中使用它们。预定义变量会在您的脚本中自动创建，因此您无需在使用它们之前声明它们。

针对数字和传统 ACD 渠道的脚本编写

数字是指与 Digital Experience (数字) 相关的渠道、技能、脚本、联系人和交互。数字实体和与其对应的 ACD 不同。已发现在 CXone 平台中管理实体的方面存在一些差异。已发现在与传统 ACD 渠道上的交互相比，平台处理数字交互的方式上存在其他差异。

Digital Experience 和传统 ACD 中都有电子邮件、聊天和短信渠道。这些渠道的传统 ACD 版本使用电子邮件、聊天和短信脚本媒体类型。这些渠道的数字版本均采用数字脚本媒体类型。

此外，用于处理电子邮件、聊天和短消息的许多 Studio 操作仅适用于这些渠道的传统 ACD 版本。您可以查看在线帮助页面的“支持的脚本类型”部分，以了解用于确定您是否可以将其与数字渠道一起使用的操作。

您可以在 Digital Experience 中更详细地了解可用渠道，以及如何在 Digital Experience 在线帮助中管理数字实体。如果您的组织使用数字渠道，您可以在数字脚本帮助页面上了解有关使用这些渠道的更多信息。

脚本组件

脚本包括以下组件：

操作：在 Studio 中，脚本由称为操作的连接块组成。每个操作在脚本中都有特定的用途。操作可以创建选项菜单、播放音频文件或请求下一个可用的坐席。大多数操作都有一组属性，必须对这些属性进行配置，以定义脚本中每个唯一操作实例的特定行为。属性包括选择 ACD 技能用于根据坐席的技能、能力和知识自动传递交互、设置变量和选择要播放的音频文件等。

您可以在操作基础帮助页面中了解有关使用操作的更多信息。此在线帮助的 Studio 操作部分中的单个操作具有在线帮助。
连接器：脚本的流程由操作的连接方式定义。操作之间的连接以直线和箭头表示。
分支：您可以在脚本中创建分支以涵盖一个操作存在多种可能结果的情况。例如，这允许您定义出现错误时会发生什么。您还可以使用分支为联系人提供选择，例如在 IVR 自动电话菜单，允许呼叫者通过语音命令、按键输入或两者进行交互，以获得信息、路由呼入的语音呼叫或两者。菜单中。多个分支可以源于单个操作。在这种情况下，您将定义脚本执行每个分支所必须满足的条件。您还可以在同一操作中拥有多个分支末端。
提示：提示是许多脚本的常见组件。它们是脚本可以播放的消息，以便为联系人提供选择或向其提供信息。例如，IVR 菜单使用提示让联系人知道其进行交互的选项。这可能是诸如“按 1 可联系销售人员。按 2 可联系支持人员”之类的信息。您还可以使用提示提供联系信息，例如您组织的工作时间或联系人的当前帐户余额。提示可以是预先录制的音频文件，也可以是通过文本到语音转换 (TTS 允许用户将录制的提示作为文本输入，并使用计算机生成的语音来朗读内容。) 服务朗读的文本。
自定义代码：有时必须在 Studio 脚本中使用自定义脚本。自定义代码允许您扩展脚本的功能范围。在使用例如虚拟坐席代替现场人工坐席处理客户交互的软件应用程序。等某些产品需要它。即使不需要，使用它也会有帮助，因为它可以简化管理 Studio 脚本的某些方面。

自定义代码必须使用 Snippet 编写，这是一种由 NICE CXone 开发的内部脚本语言。有关使用 Snippet 的参考资料，请参见在线帮助的技术指南部分。

脚本媒体类型

脚本有一个名为媒体类型的属性。媒体类型是联系人和坐席用于通信的渠道联系人与坐席或机器人交互的一种方式。通道可以是语音、电子邮件、聊天、社交媒体等。类型。脚本的媒体类型必须与分配给它使用的渠道类型相匹配。

创建脚本时，系统会提示您选择媒体类型。如有必要，您可以稍后更改此设置。目前，此选项在 CXone Studio 中不可用，因此您必须使用 Desktop Studio应用。

下表显示了 Studio 中的媒体类型。


通用	Email	聊天	电话	语音信箱	工作项目	短信	数字

通用脚本类型在显示脚本类型的位置被标记为系统。例如，您可以在脚本属性的媒体类型字段中看到。

媒体类型会影响脚本中可使用的操作。大多数操作适用于任何类型，但有些操作只适用于某些媒体类型。例如，ASR 允许联系人通过说话、按手机按键或两者的结合来响应录制的语音提示。操作仅适用于电话脚本。如果您正在处理电子邮件脚本，则 ASR 操作在该脚本的“操作”选项板中不可见。

抑制脚本

抑制脚本是一个自定义子脚本，其与呼出电话 ACD 技能一起使用，以确定呼叫请求应继续还是在进行呼叫之前执行自定义逻辑。抑制脚本可在坐席或拨号器进行呼叫时运行。

当请求呼出呼叫时，进行呼叫的系统脚本会检查是否已将抑制脚本分配给用于请求此呼叫的 ACD 技能。如果存在抑制脚本，则会将请求路由到它。当抑制脚本中的逻辑完成后，必须将呼叫请求返回给系统脚本。

抑制脚本必须通过 PERMITCALL 操作或 SUPPRESSCALL 操作来结束。如果呼叫可继续，则使用 PERMITCALL；如果不应进行呼叫，则使用 SUPPRESSCALL。这两个操作都会将呼叫请求返回到原始系统脚本。然后系统脚本会适当地完成请求。

您可以在设置呼叫抑制帮助页面上了解有关创建抑制脚本的更多信息。

脚本版本管理

您可以通过开发命名约定来管理脚本的版本控制。一种常见的命名约定是在脚本文件名的末尾包含 DEV 或 PROD 。这些添加项有助于您识别正在开发或生产中的脚本。如果符合组织的要求，您可以包含其他信息，如日期或版本号。

Studio 不允许在保存后更改脚本名称。需要更改脚本名称时，请使用另存为复制脚本，并为其指定新名称。例如，将脚本从开发转入生产，则需执行此操作。在将脚本投入生产之后，如果您想让脚本文件夹保持整洁，您可以停用旧的生产和开发版本。如果需要再次使用这些脚本，可以重新激活它们。

在 Studio 中，脚本具有两种类型的历史版本。还有：

随着脚本在开发和生产中的移入和移出而累积的单个文件。
由 Studio 自动保存和维护的先前版本。每次保存脚本文件时，Studio 会将新版本添加到该文件的历史记录中。如果需要，可以恢复到脚本文件的先前版本。Studio 保留的版本数是可配置的。

由于每次保存脚本时都会添加另一个版本，因此您可以在编写脚本的会话期间完全替换该脚本的所有已保存版本。在开始处理脚本之前，您可能需要导出一份脚本副本，尤其是要对脚本进行重大修改时。这样，如果需要，您可以引用或完全还原到该副本。为导出的副本命名可能会有所帮助，这样您就知道它是哪个版本及其保留原因。

切勿直接编辑生产脚本。保存的更改会立即生效。如果更改导致脚本出现问题，它可能会影响联络中心的运行能力。如果需要进行更改，请使用 Save As 创建脚本的副本并进行命名，以表明它正在开发中。只有经过充分测试并准备就绪时才可将其投入生产。

开始和结束脚本

脚本以三种方式之一启动。它们可以是：

从联络点呼入联系人用来发起交互的入口点，如电话号码或电子邮件地址。发起。这适用于从交互开始时处理联系人初始路由的脚本。对于此类脚本，您可以通过将它们分配给联络点来将其投入生产。
衍生或由以下人员启动：
- 使用 Runsub 或 Runscript 操作的另一个脚本。
- API。
- “ACD 脚本”页面。
由 Digital Experience 中的工作流自动化作业衍生。

每个脚本都以 Begin 操作开始。脚本以终止操作结束。有几种终止操作。您使用的内容相当关键，并且取决于脚本媒体类型：

Discard：终止电子邮件脚本。
End：终止电话、语音邮件、SMS 或数字脚本。不终止数字联系人，但终止使用其他媒体类型的脚本中的联系人。
End a Contact：终止活动联系人。不终止当前脚本。
EndText：终止不包含 Regagent 操作的 SMS 工作流（仅适用于数字与Digital Experience相关的任何渠道、联系或技能。渠道）。
EndWi：使用原因代码终止工作项。不终止当前脚本。
Exit：终止聊天会话并断开聊天联系。
Hangup：终止电话脚本。
Return：终止下标并将控制权返回给原始脚本。

请勿使用 Stop 操作来终止脚本。它不会终止脚本，而会让联系人继续运行。这会对CXone服务器产生负面影响。

如果您使用End操作，则以下信息适用：

如果您在包含不受支持的媒体类型的脚本中使用 End，则可能无法正确结束所有进程或联系。结束后台进程是终止操作的一项关键功能。因此，使用最适合脚本媒体类型的操作非常重要。
如果您在子脚本中使用 End，则会终止子脚本和原始脚本。如果要终止子脚本但要继续原始脚本，请使用 Return 操作。
End 应用于终止活动脚本的逻辑流并调用 OnRelease 事件操作。因此，不应在 OnRelease 事件逻辑之后使用它。

使用代码片段自定义编码

简单的脚本无需自定义编码。对于这些脚本，使用可用的操作足以管理 CXone 中的基本路由功能。

自定义编码需要更复杂的路由或 CXone 中的部分产品或特性。在某些情况下，Studio 操作或整个 CXone 应用程序需要代码片段才能正常工作。Snippet 操作允许您将代码插入到脚本中需要添加自定义代码的任何位置。

Studio 使用名为 Snippet 的内部脚本语言。这种语言执行服务器端，并编译为 MSIL（微软中间语言），就像 C# 和 Visual Basic .NET 一样。在线帮助中提供了 Snippet 的完整参考指南。

脚本中的备注和注释

Studio 提供了多种向脚本添加注释的方法。这是非常重要的一步，有助于确保您以及之后处理脚本的任何人员以后都能理解该脚本。您可以：

使用 Note 和 ANnotation Studio 操作。
在您的脚本中更改画布工作区上显示的操作的标签。
向 Snippet 操作代码添加评论。

使用 NOTE 和 ANNOTATION 操作

Studio 具有两个可以包含在脚本中的操作，即 Note 和 Annotation。这两种操作都不会影响脚本的工作方式。这些注释仅供参考。这两种操作之间的区别为：

Note 操作可以放置在脚本画布上的任何位置，而无需连接到其他操作。要添加或查看通过此操作所作的注释，必须双击该操作。
Annotation 操作将您的评论直接显示在画布上的灰色矩形中。如果要直接指向注释引用的脚本部分，还可以将 Annotation 连接到另一个操作。

更改操作标签

在脚本中进行注释的另一个选项是更改脚本中操作的标题。在每个操作的属性中都有一个添加说明文字或说明文字字段，可使您添加在 CXone Studio 中显示在画布的操作下的名称或简短说明。在 Desktop Studio 中，其更改画布上的操作名称。借助此字段，您可以用一个单词或短语命名每个操作，以提醒该操作在脚本中的用途。

例如，可以更改 Snippet 操作的名称，以指示其所包含代码的作用。或者您可以在 IVR 自动电话菜单，允许呼叫者通过语音命令、按键输入或两者进行交互，以获得信息、路由呼入的语音呼叫或两者。菜单中使用其播放的音频文件或提示的名称来命名每个 Play 操作。

在 SNIPPET 操作中添加评论

您可以在 Snippet 操作中向自定义代码添加评论。评论可以位于单独的链接上，也可以位于一行代码的末尾。代码片段语言使用两个正斜杠来指示评论 ( // )。以下示例显示了代码片段中的评论：

//custom payload parameters are optional and
//customizable
DYNAMIC customPayload
customPayload.context.id="123"
customPayload.context.parameters.name="Beowulf"
CustomPayload.context.parameters.age=25
ASSIGN tokenjson = "{customPayload.asjson()}" //converts to JSON

有关使用 Studio 的关键事实

“错误和警告”面板显示与脚本相关的任何警告和错误。您可以使用此信息来帮助测试和调试您的脚本。在 CXone Studio 中，警告和错误出现在画布工作区的右侧。
可以将脚本导入和导出为 XML 文件。
Studio 不允许在保存脚本后对其进行重命名。如果您需要更改脚本的名称，您可以可以复制它来使用新名称创建副本，然后停用旧脚本，或者将其移至单独的文件夹中，这样就不会碍事了。
您可以在两个位置查看脚本的先前版本：
- 在 Desktop Studio 中，右键单击“浏览”选项卡（查看> 浏览器）中的脚本，然后将光标悬停在历史记录选项上。当前此选项在 CXone Studio 中不可用。
- 在 CXone 中，单击ACD > 脚本。在此页面上，您还可以将脚本恢复到先前版本。
您可以使用 CXone 中的 ACD> 脚本调度选项调度要运行的脚本。
在 CXone 中的 ACD > 脚本页面上，可以使用脚本用作变量的临时自定义参数衍生脚本。
为了防止脚本变得太大和复杂，您可以将其分成多个较小的脚本，并使用Runsub或Runscript操作链接它们。
Studio 具有一些脚本 API，您可以使用它们以编程方式打开和保存脚本。这需要具备高级脚本编写技能。
对脚本的更改会自动本地保存在您的浏览器中。如果浏览器意外关闭，这可以防止您丢失未保存的工作。如果发生这种情况，下次打开脚本时，CXone Studio 会提示您打开包含未保存的更改的脚本。