Indicate

本帮助页面适用于 Desktop Studio。如果您是 CXone Studio 受控版本 (CR) 计划的成员,则可以在 CXone Studio 在线帮助中找到此信息。如果您不属于 CR 计划,但希望成为该计划的一部分,请联系您的 CXone 客户代表

使用自定义功能扩展代理界面,特别是代理单击以启动自定义功能的图标。坐席界面中的这些图标可用于运行或发送脚本、打开 URL 或构建基于 Web 的基本表单并处理其数据。

双击该操作可打开配置向导。

依赖关系

  • 脚本中的指示器也必须关闭,否则在联系结束后,指示器将继续出现在坐席界面中。通常使用两个 Indicate 操作,一个用于打开按钮,另一个用于关闭按钮。
  • 由于 Indicate 操作非常灵活,因此在编程时要非常小心,并对脚本进行全面测试。
  • 确保与 ImageFile 属性一起使用的链接有效。断开的链接会给 CXone 服务器带来严重的性能问题。
  • 因为您的 MAX 会根据 ActionType 为所有指标使用一组预定义的图像。使用 MAX 属性指定图像ImageFile不会改变坐席看到的图像。

支持的脚本类型

通用脚本类型的图标——一个带有 < 和 > 符号的矩形。

电子邮件脚本类型的图标——菱形中的一个大 @ 符号。

聊天脚本类型的图标——一个聊天气泡,带有一个包含省略号 (...) 的菱形。

电话脚本类型的图标——一种老式电话听筒,带有曲线表示从它发出的声音。

语音邮件脚本类型的图标——一个看起来像盒式磁带的符号——两个圆圈位于一条水平线上。

工作项脚本类型的图标——一张纸,其中一个角向下折叠并且纸上有一个项目符号列表。

SMS 脚本类型的图标——一个带有聊天气泡的智能手机。

数字脚本类型的图标——一个旁边有智能手机的电脑显示器。

通用

电子邮件 聊天 电话 语音邮件 工作项 SMS 数字

类似操作比较

以下操作具有类似功能,但存在一些关键区别:

  • Runapp:从脚本启动自定义功能,尤其是启动表单、网页或应用程序。
  • PopURL:打开网页 URL,并为从网页上弹出的面板提供位置和样式选项。
  • Indicate :使用自定义功能扩展坐席界面,特别是坐席单击以启动自定义功能的图标。这与 Runapp 类似,但使用 Indicate 时,ActionType 由脚本而不是坐席发起。

输入属性

这些属性定义操作在执行时使用的数据。

属性

描述

Target

从下拉列表中选择接收者类型:AgentsTeamSkillEveryoneContactEveryone 选项已弃用。

TargetIDs

目标的 ID,如坐席 ID 或技能 ID。

Name

此属性是用于标识值的名称或键。可以是任何名称或数字。名称不区分大小写。如果您使用多个 Indicate 操作,则此名称用于跟踪已开启或关闭的 Indicate 操作。

ImageFile

CXone 文件服务器上的租户关闭 用于管理 CXone环境的技术支持、计费和全局设置的高级组织分组目录中图像文件的 URL。这是坐席将单击的图像。文件必须为 GIF、JPG 或 PNG 格式,且大小为 16x16 像素。

Agent for SalesforceAgent for Salesforce Lightning 中使用 Indicate 操作时,需要此属性。

警告如果 ImageFile的链接断开,会给相关租户带来严重的性能问题。使用自定义图标时,验证此链接的准确性非常重要。

Tooltip

当鼠标光标悬停在指示器图标或文本上时显示的文本。

State

用于确定是否将显示指示器的 OnOff 下拉列表。通常,您需要两个具有相同名称的操作。一个用于启用该按钮,一个用于禁用该按钮。

ActionType
  • RunExe:运行本地可执行文件。该选项使用仅适用于 Internet Explorer 的 Java 插件,而 CXone 不支持该插件。这要求本地可执行文件位于 Windows 路径下或在 ActionValue 字段中输入完整路径。文件路径必须包含双反斜杠 (\\)。例如,C:\\Program Files\\CXone\\studio.exe。大多数现代浏览器不支持运行可执行程序。如果您希望使用此类型可执行文件,请确保坐席使用兼容的浏览器。
  • OpenURL:打开 ActionValue 字段中指定的 URL 的默认 Web 浏览器。
  • SpawnScript:生成 ActionValue 字段中指定的脚本并传递参数。
  • SignalScript:标示 ActionValue 字段中指定的脚本并传递参数。
  • ShowCustomForm:启动在 Studio 中创建的自定义 HTML 表单。从自定义表单中捕获的数据将触发脚本中的 ONDATA 事件。
ActionValue

该值为指定的 ActionType 所需要。此属性中支持变量,方法是用大括号 ( { } ) 将其括起来。

  • RunExe:Windows 可执行文件的名称或路径。文件路径必须包含双反斜杠 (\\)。例如,C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}
  • OpenURL :必须是全限定域名和 URL。支持查询字符串参数。例如,http://www.example.com/file.asp?ANI={ANI}。您还可以通过将 icAgentPanelTitle= 参数附加到 URL 来自定义 MAX 界面所弹出选项卡的标题。
  • SpawnScript :要生成的脚本的名称。该名称必须是脚本的完整路径(在运行脚本的当前目录中)。脚本生成参数 SkillID 是必需的。如果没有 ACD 技能 ID,脚本将无法生成。
  • SignalScript :要标示的运行脚本的 ID。通常情况下,您正在生成一个相关的脚本,可以使用 {ContactID} 来标示当前脚本。使用 {MasterID} 来标示父脚本,或者使用 {SpawnID} 之类来标示子脚本。
  • ShowCustomForm :此字段允许您创建自定义 HTML 表单。可以使用任何标准表单输入字段,包括“输入”、“文本区域”、“密码”、“复选框”、“单选”、“选择”、“按钮”和“提交”。不应包含<form> 标签。
    • 每个输入字段必须包含一个名称。将忽略没有名称的字段。例如,<input type="text" name="phone">。名称和值将作为变量通过 Ondata 操作返回给脚本。如果脚本中缺失 Ondata 操作,表单将毫无用处。支持多个值的表单字段(例如“复选框”和“选择”)将包含一个逗号分隔的数组。
    • 多个提交按钮可以使用相同或不同的名称,但任何提交按钮都会提交数据并关闭窗口。如果想要一个不提交的按钮,则使用一个按钮而不是提交。
    • 不支持链接样式表,但支持内联样式。例如,<div style="position: absolute: left: 10px: top: 100px:">
    • 当链接到外部 javascript 时,Javascript 将正常工作,但内容必须是 HTTPS,以免出错。例如:

    <script type="text/javascript" src="https://www.example.com/test.js"></script>
    <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)">
    

结果分支条件

结果分支条件允许您在脚本中创建分支,以在执行操作时处理不同的结果。

条件

描述

Default

除了脚本满足条件要求其接受其他分支的情况之外,所要采用的路径。如果未定义操作的其他分支,也会执行此操作。

OnError

操作无法正确执行时所采用的路径。例如,出现连接不良、语法错误等意外问题时。_ERR 变量以单个下划线字符填充,应包含对问题的简要解释。

提示和技巧

支持 Fieldset 和 Legend 以更可读的方式布置表单。内联样式可以应用于 HTML 实体。例如:

<fieldset>
	<legend>Gender:</legend>
	<input type="radio" name="gender" value="male"/>Male
	<input type="radio" name="gender" value="female"/>Female<br/>
</fieldset>

脚本示例

此示例并非完整的脚本。要使用此操作,需要额外的脚本编写工作。

本示例演示如何将 Indicate 操作合并到脚本中。其中包括如何将不同类型的数据传递给生成的脚本的示例。可下载的 ZIP 文件中包含生成脚本的示例。

下载此脚本