通过

使用自动化字典传递参数键

  • 项目

自动化字典维护会话的上下文数据。 您可以使用自动化字典中的密钥在操作中传递参数。

在管理应用中创建模板和宏时，您可以传递参数键，例如会话标题、通知标题、应用选项卡模板的标题，以及应用程序选项卡类型的自定义参数值。 执行时，将根据可用的上下文信息替换这些密钥。

通过模板传递数据参数

让我们看一下通知中使用模板的一种方案。

此通知显示特定字段和值，分别称为字段标题和值。

客户 Kenny Smith 启动了一个对话，并且在代理查看通知时，该对话显示的客户名称为 Kenny Smith。

此处的字段标题为客户名称，值为 Kenny Smith。

对于将客户名称标识为 Kenny Smith 的模板，您（管理员）必须将参数作为键传递。

同样，对于会话和通知标题，您可以传递数据参数。 详细信息：数据参数密钥的自动化词典格式

系统将根据会话上下文、渠道提供程序、Microsoft Dataverse 和用户操作把这些参数密钥替换为实际值。 详细信息：上下文数据参数的类型

在宏和代理脚本中传递数据参数

宏是一组用户按需运行的已配置的顺序操作。 作为管理员，您需要配置宏必须执行的操作。 若要配置操作，需要传递数据参数。 详细信息：用于传递数据参数键的自动化字典格式

当代理运行宏时，系统将根据会话上下文、渠道提供程序、Dataverse 和用户操作把这些参数密钥替换为实际值。

当上下文来自会话时，将基于当前会话的信息运行宏操作，其中的信息从“定位点”选项卡或位于焦点的当前选项卡获取。 例如，要创建案例，您需要定义包含事件实体窗体的操作以及窗体的 GUID（可选）。 详细信息：上下文数据参数的类型

上下文数据参数的类型

自动化词典使用可从以下来源获取的上下文数据参数：

自动化词典。

来自渠道提供程序的上下文数据

此上下文数据来自第一方渠道提供程序（如 Customer Service 全渠道），或使用 Dynamics 365 渠道集成框架公开的小组件的第三方渠道提供程序。 来自适用于客户服务的全渠道的上下文数据是对话前调查、访问者门户导航等。

来自用户操作的上下文数据

到代理在会话中执行某些活动时填充此数据。 例如，当打开新客户记录、服务案例等时。

来自 Dataverse 的上下文数据

组织数据存储在 Dataverse 中，您可以使用 OData 查询提取数据。 详细信息：OData 查询

来自其他宏操作的上下文数据

宏中的操作用于生成该宏中其他操作使用的上下文数据。

例如，有两个操作步骤是按以下顺序：

  1. 打开新窗体以创建记录。
  2. 打开包含预定义模板的电子邮件窗体。

创建打开包含预定义模板的电子邮件窗体操作时，可从打开新窗体以创建记录宏操作步骤获取上下文数据参数密钥。

来自第一个宏操作的上下文数据参数如下所示：

  • 实体逻辑名称
  • 页面类型
  • 选项卡 Id

备注

来自其他宏操作的上下文数据参数特定于宏，而不适用于模板。

用于传递数据参数密钥的自动化词典格式

自动化字典维护会话的上下文数据。 可将自动化词典中的密钥作为参数传递到宏中的操作。 系统将根据会话上下文、渠道提供程序、Dataverse 和用户操作把这些参数密钥替换为实际值。

自动化词典支持以下格式：

数据域

数据域是系统根据上下文在运行时填充的替换参数。 应仅对宏和代理脚本使用以下数据域列表，并使用它们来使用代理脚本表达式生成器将代理脚本设置为默认值。 详细信息：工作效率工具

工作效率工具的数据域（宏和代理脚本）

宏和代理脚本支持以下数据域：

数据域 描述
${customerName} 发起对话的客户的名称。
${caseId} 案例的唯一 ID。 系统仅在案例链接到对话时显示案例 ID。
${caseTitle} 案例的标题。 系统仅在案例链接到对话时显示案例的标题。
${LiveWorkItemId} 对话的唯一 ID。
${queueId} 队列的唯一 ID。 此字母数字字符串显示在队列页面 URL 中。
${visitorLanguage} 启动对话的客户的语言。
${visitorDevice} 启动对话的客户的设备。
${entityRoutingLogicalName} 实体的名称（如果通知是针对实体记录）。
${customerEntityName} 实体（联系人或客户）的名称（如果客户已通过身份验证）。
${customerRecordId} 实体（联系人或客户）的唯一 ID（如果客户已通过身份验证）。
${<name of the pre-conversation survey questions>} 为工作流配置的所有对话前调查问题采用数据域名称作为问题的名称。

备注

${anchor.<attribute_name>} 数据域仅在 Customer Service workspace 的宏和脚本中受支持。

以下数据域用于生成可与客户共享以重新连接同一代理和对话的重新连接链接。 详细信息：配置与上一个聊天的重新连接

数据域 描述
{ReconnectUrl{ReconnectID}} 在快速回复中用于生成重新连接链接。

工作效率工具的数据域的格式

从渠道提供程序、当前用户会话、其他宏操作的输出或 Dataverse 中检索上下文的 ${Slug} 参数格式。

工作效率自动化上下文

当您想要在生产力自动化环境（用于执行与 Dynamics 365 中的模型驱动应用相关的操作）中执行数据域时，请使用 ${</slug/>} 例如：${customerName}

会话连接器上下文

当您要在会话上下文中执行数据域时，必须使用 ${$session.<slug>} 格式。 例如：${$session.customerName}

可用于会话上下文的数据域包括：

  • ${$session.visitorDevice}
  • ${$session.visitorDevice}
  • ${$session.entityRoutingLogicalName}
  • ${$session.entityRoutingRecordId}
  • ${$session.<name of the pre-chat survey questions>

全渠道连接器上下文

当您要在 Customer Service 全渠道上下文中执行数据域时，必须使用 ${$oc.<slug>} 格式。 例如：${$oc.customerName}

Session.CurrentTab.<Attribute> 和 Session.AnchorTab.<Attribute> 参数基于当前会话和位于焦点的定位点选项卡或当前选项卡提供上下文数据。 下面是支持的属性类型：

  • EntityName
  • EntityId

示例：

  • Session.CurrentTab.<EntityName>
  • Session.CurrentTab.<EntityId>
  • Session.AnchorTab.<EntityName>
  • Session.AnchorTab.<EntityId>

备注

Session.CurrentTab.<Attribute> 和 Session.AnchorTab.<Attribute> 参数仅适用于宏，不适用于模板。

模板的数据域

下面是支持的数据域的列表：

数据域 说明
{anchor.<attribute_name>} 用于访问在定位点选项卡中加载的记录的属性。
{customerName} 发起对话的客户的名称。
{caseId} 案例的唯一 ID。 系统仅在案例链接到对话时显示案例 ID。
{caseTitle} 案例的标题。 系统仅在案例链接到对话时显示案例的标题。
{queueId} 队列的唯一 ID。 此字母数字字符串显示在队列页面 URL 中。
{visitorLanguage} 启动对话的客户的语言。
{visitorDevice} 启动对话的客户的设备。
{entityRoutingLogicalName} 实体的名称（如果通知是针对实体记录）。
{entityRoutingRecordId} 实体记录的唯一 ID（如果通知是针对实体记录）。
{customerRecordId} 实体（联系人或客户）的唯一 ID（如果客户已通过身份验证）。
{<name of the pre-chat survey questions>} 为工作流配置的所有聊天前调查问题采用数据域名称作为问题的名称。

模板的数据域的格式

从渠道提供程序、当前用户会话或 Dataverse 中检索模板上下文的 {Slug} 参数格式。 例如：{caseId}

OData 查询

您可以使用 OData 查询获取 Dataverse 中提供的上下文。

OData 查询格式是：

{$odata.<entityName>.<entityAttributeName>.<?options>}

示例：

  • {$odata.account.name.?$filter=accountid eq '{customerRecordId}'}
  • {$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}
  • {$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}

静态值

这些是您根据业务要求更新的硬编码值。 对于所选的每个硬编码属性，请使用该特定属性的格式类型。

示例（宏）：

您希望追加案例标题时始终带有 Contoso -。 您可以使用包含以下字段的打开新窗体以创建记录操作。

参数 值
实体逻辑名称 事件
属性名称 服务案例标题
属性值 Contoso - {caseTitle}

在这里，Contoso - 是硬编码的静态值。

示例（模板）：

对于传入聊天请求，您希望为代理将在运行时看到的会话和通知模板提供静态标题。

通知标题 = New chat request

会话标题 = Chat conversation

另请参阅

管理会话模板
管理应用程序选项卡模板
管理通知模板
将模板与工作流关联