为 CXone Agent Embedded 配置 Microsoft Dynamics 工作流

这是在 Microsoft Dynamics 中设置 CXone Agent Embedded 的最后一步。

您可以为 Microsoft Dynamics 和 CXone Agent Embedded 配置“搜索”、“自定义创建”和“标准创建”工作流。这些工作流搜索或创建 Microsoft Dynamics 记录，也称为实体。这是动态数据映射的后端配置。

工作流类型

 说明

工作流程
搜索 “搜索”工作流扫描 Microsoft Dynamics 以查找适用于坐席正在处理的交互的记录。 搜索 ANI
自定义搜索
自定义创建 “自定义创建”工作流使用标准字段和自定义字段创建任何记录类型。 创建自定义记录
标准创建

“标准创建”工作流使用标准数据字段创建标准 Microsoft Dynamics 记录。这些工作流的 SNIPPET 有效负载必须包含标准字段，并且仅包含这些字段。

 创建账户
创建案例
创建联系人
创建潜在客户
创建机会
创建电话

配置“搜索”工作流

“搜索”工作流有两个：搜索 ANI 和自定义搜索。

配置“搜索 ANI”工作流

搜索 ANI 工作流使用 ACD 中的 ANI关闭 也称为呼叫者 ID。所列的语音来电的电话号码。 来搜索所有标准电话字段以查找匹配记录。

使用此示例脚本。

  1. 在 Studio 中，打开您要在其中配置搜索 ANI 工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC searchInput
searchInput.workflowInput.phoneNumber = "{ANI}"
ASSIGN searchJson = "{searchInput.asjson()}"

  5. 保存脚本。

  6. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“自定义搜索”工作流

自定义搜索工作流可使您搜索一条或多条 Microsoft Dynamics 记录。它们还可使您搜索指定记录中的多个字段和变量。您可以使用 Microsoft Dynamics 运算符连接不同的搜索要求。

此工作流支持以下 Microsoft Dynamics 记录：

  • 联系

  • 账户

  • 引导

  • 机会

  • 案例

  • 任务

使用此示例脚本。

  1. 在 Studio 中，打开您要在其中配置自定义搜索工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC searchInput
DYNAMIC payload
payload.entity = "[API name]"
payload.filter = "[fieldName] [operator] {variable}"
searchInput.workflowInput.search = payload
ASSIGN searchJson = "{searchInput.asjson()}"

  5. 将 payload.entity 属性的值更改为您要使用的记录的 API 名称。例如，payload.entity = "incident"。其区分大小写。

    记录

    API

    		 可链接
    联系 contact 是
    账户 account 是
    引导 lead 是
    机会 opportunity 是
    案例 incident 是
    任务 task 否

  6. 更改 payload.filter 属性的值。这可确定记录的搜索筛选标准。例如，payload.filter = "phone='{ANI}'"。

    1. 将 [fieldName] 更改为要用于搜索的字段的名称，例如 ticketNumber。其区分大小写。

    2. 将 [operator] 更改为您要使用的 Microsoft Dynamics 运算符。其区分大小写。

      操作员

      说明

      		 示例
      eq 等于 $filter=revenue eq 10000
      ne 不等于 $filter=revenue ne 10000
      gt 大于 $filter=revenue gt 10000
      ge 大于或等于 $filter=revenue ge 10000
      lt 小于 $filter=revenue lt 10000
      le 小於或等於 $filter=revenue le 10000
      and 与 $filter=revenue lt 10000 and revenue gt 2000
      or 或 $filter=contains(name,'(sample)') or contains(name,'test')
      not 否定 $filter=not contains(name,'sample')

    3. 将 {variable} 更改为要分配给该字段的变量。其区分大小写。

  7. 要添加其他搜索筛选器，请在筛选器之间使用 Microsoft Dynamics 运算符。例如： 

    
payload.filter = "phone eq '{ANI}'AND customer_number_c eq '{CustomerNumber}'"

  8. 保存脚本。

  9. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“自定义创建”工作流

自定义创建工作流可使您配置 SNIPPET 有效负载以创建任何类型的 Microsoft Dynamics 记录（标准或自定义）。它们还可使您填充任何字段类型（标准或自定义）。例如，您可以使用该记录类型的一些标准字段以及您自己的自定义字段来创建“帐户”记录。

这是创建 Microsoft Dynamics 记录的推荐方法。

配置“创建自定义记录”工作流（先前为“创建实体”）

创建自定义记录工作流可创建任何类型的 Microsoft Dynamics 记录（标准或自定义）。此记录可以显示标准和自定义数据字段。这些字段必须包含文本、数字或变量。绑定字段通常由搜索结果或选项列表填充，但您可以将此工作流配置为将硬编码数据添加到绑定字段。

  • 单行文本

  • 多行文本

  • 整数

  • 浮点数

  • 十进制数

  • 选项集

  • 多选选项集

  • 两个选项

  • 查找

  • 简单

  • 货币

  • 客户（已绑定）

  • 所有者（已绑定）

  • PartyList（已绑定）

  • 关于（已绑定）

使用此示例脚本。

先前这称为创建实体工作流。

  1. 在 Studio 中，打开您要在其中配置创建自定义记录工作流的脚本。

  2. 如果尚未添加，请在 ONANSWER 或 ONASSIGNMENT 之后添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createPayload
DYNAMIC createDataArray
						
DYNAMIC item1
item1.field = "subject"
item1.value = "New Record - {CONTACTID}"
DYNAMIC item2
item2.field = "phonenumber"
item2.value = "{ANI}"
DYNAMIC item3
item3.field = "new_contactid"
item3.value = "{CONTACTID}"
						
createPayload.entity = "phonecalls"
		ASSIGN createDataArray[1] = item1
		ASSIGN createDataArray[2] = item2
		ASSIGN createDataArray[3] = item3
CreatePayload.data = createDataArray
						
createPayload.pinnedRecord = "[true or false]"
						
DYNAMIC create[RecordName]Payload
create[RecordName]Payload.workflowInput = createPayload
						
ASSIGN create[RecordName]Json = "{create[RecordName]Payload.asjson()}"

    您必须包含其中每一行。

  5. 将 createPayload.pinnedRecord 属性的值更改为 true 或 false。当设置为 true 时，创建的记录将向 客户卡 的“当前交互”部分中的坐席显示。如果设置为 false，它将显示在 客户卡 的“最近交互”部分中。如果您没有将此属性包含不有效负载中，它将被假定为 false。

  6. 将代码最后三行中的所有 [RecordName] 实例更改为您创建的记录的名称。将此名称大写以匹配属性的驼峰式大小写。例如，如果您创建的记录的名称是 phonecall，您的代码将为：

    
DYNAMIC createPhoneCallPayload
createPhoneCallPayload.workflowInput = createPayload
						
ASSIGN createPhoneCallJson = "{createPhoneCallPayload.asjson()}"

  7. 要添加其他字段：

    1. 在 item3.value = "{CONTACTID}" 下创建其他动态数据对象。请遵循以下格式：

      
DYNAMIC item#
item#.field = "[fieldname]"
item#.value = "{variable}"

    2. 然后在 createPayload.entity = "phonecalls" 下创建其他数据数组。请遵循以下格式：

      
ASSIGN createDataArray[#] = item#

      每将一个额外项目添加到数组中，数字 (#) 就需要增加一。

  8. 保存脚本。

  9. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“标准创建”工作流

“标准创建”工作流可使用户搜索 Microsoft Dynamics 内的标准 Microsoft Dynamics 记录。

您无法在“标准创建”工作流的 SNIPPET 有效负载中添加或删除字段。如果添加或删除字段，则不会创建记录。要使用所需字段创建标准或自定义记录，请使用创建自定义记录工作流。

配置“创建帐户”工作流

使用此示例脚本。

  1. 在 Studio 中，打开您要在其中配置创建帐户工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createAccount
createAccount.accountName = "[Contact Name]"
createAccount.email = "[email address]"
createAccount.mainPhone = "{ANI}"
DYNAMIC createAccountPayload
createAccountPayload.workflowInput = createAccount
ASSIGN createAccountJson = "{createAccountPayload.asjson()}"

    您必须包含其中每一行。如果您希望字段保持空白，则可以使用空值 ("")。例如，createAccount.email = ""。

  5. 将 createAccount.accountName 属性的值更改为联系人的姓名。例如，createAccount.accountName = "Elinor Dashwood"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  6. 将 createAccount.email 属性的值更改为联系人的电子邮件地址。例如，createAccount.email = "elinor.dashwood@classics.com"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  7. 保存脚本。

  8. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“创建案例”工作流

  1. 在 Studio 中，打开您要在其中配置创建案例工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createCase
createCase.title = "[Case Name]"
createCase.entityType = "contact" 
createCase.phoneNumber = "{ANI}"
createCase.email = "[email address]"
DYNAMIC createCasePayload
createCasePayload.workflowInput = createCase
ASSIGN createCaseJson = "{createCasePayload.asjson()}"

    您必须包含其中每一行。如果您希望字段保持空白，则可以使用空值 ("")。例如，createCase.email = ""。

  5. 将 createCase.title 属性的值更改为案例的名称。例如，createCase.title = "Elinor's Case"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  6. 将 createCase.email 属性的值更改为联系人的电子邮件地址。例如，createCase.email = "elinor.dashwood@classics.com"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  7. 保存脚本。

  8. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“创建联系人”工作流

使用此示例脚本。

  1. 在 Studio 中，打开您要在其中配置创建联系人工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createContact
createContact.firstName = "[first name]"
createContact.lastName = "[last name]"
createContact.email = "[email address]"
createContact.businessPhone = "{ANI}"
DYNAMIC createContactPayload
createContactPayload.workflowInput = createContact
ASSIGN createContactJson = "{createContactPayload.asjson()}"

    您必须包含其中每一行。如果您希望字段保持空白，则可以使用空值 ("")。例如，createContact.email = ""。

  5. 将 createContact.firstName 属性的值更改为联系人的名字。例如，createContact.firstName = "Elinor"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  6. 将 createContact.lastName 属性的值更改为联系人的姓氏。例如，createContact.lastName = "Dashwood"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  7. 将 createContact.email 属性的值更改为联系人的电子邮件地址。例如，createContact.email = "elinor.dashwood@classics.com"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  8. 保存脚本。

  9. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“创建潜在客户”工作流

使用此示例脚本。

  1. 在 Studio 中，打开您要在其中配置创建潜在客户工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createLead
createLead.topic = "[topic]"
createLead.mobilePhone = "{ANI}"
DYNAMIC createLeadPayload
createLeadPayload.workflowInput = createLead
ASSIGN createLeadJson = "{createLeadPayload.asjson()}"

    您必须包含其中每一行。如果您希望字段保持空白，则可以使用空值 ("")。例如，createLead.email = ""。

  5. 将 createLead.topic 属性的值更改为潜在客户的主题：联系人感兴趣的内容。例如，createLead.topic = "car insurance"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  6. 保存脚本。

  7. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“创建机会”工作流

  1. 在 Studio 中，打开您要在其中配置创建机会工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createOpportunity
createOpportunity.topic = "[topic]"
DYNAMIC createOpportunityPayload
createOpportunityPayload.workflowInput = createOpportunity
ASSIGN createOpportunityJson = "{createOpportunityPayload.asjson()}"

    您必须包含其中每一行。如果您希望字段保持空白，则可以使用空值 ("")。例如，createOpportunity.topic = ""。

  5. 将 createOpportunity.topic 属性的值更改为机会的主题：联系人感兴趣的内容。例如，createOpportunity.topic = "car insurance"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  6. 保存脚本。

  7. 您可以通过在 Studio 中模拟交互来测试脚本。

配置“创建电话”工作流

  1. 在 Studio 中，打开您要在其中配置创建电话工作流的脚本。

  2. 如果尚未添加，请在 BEGIN 之后以及 Workflow Execute 操作之前添加 SNIPPET 操作。

  3. 双击脚本画布上的 SNIPPET 操作。

  4. 复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
DYNAMIC createPhoneCall
createPhoneCall.subject = "[subject]"
createPhoneCall.phoneNumber = "{ANI}"
createPhoneCall.directionCode = "Inbound"
DYNAMIC createPhoneCallPayload
createPhoneCallPayload.workflowInput = createPhoneCall
ASSIGN createPhoneCallJson = "{createPhoneCallPayload.asjson()}"

    您必须包含其中每一行。如果您希望字段保持空白，则可以使用空值 ("")。例如，createPhoneCall.subject = ""。

  5. 将 createPhoneCall.subject 属性的值更改为呼叫的主题。例如，createPhoneCall.subject = "billing issue"。该值可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

  6. 保存脚本。

  7. 您可以通过在 Studio 中模拟交互来测试脚本。

固定记录

您可以将记录固定到 客户卡 的“当前交互”部分。

  1. 打开具有您要固定的记录的工作流的 SNIPPET。

  2. 复制此行代码并将其粘贴到 DYNAMIC create[RecordType]Payload 之前：

    						
createPayload.pinnedRecord = "true"

  3. 保存脚本。

配置弹出屏幕的记录

您可以将记录配置成自动显示为 Microsoft Dynamics 中的弹出屏幕关闭 一个可配置的弹出窗口，包含有关联系人的信息。它在某个事件后出现在坐席的屏幕上，通常在坐席连接到一个联系人时。。如果您使用 Microsoft Dynamics CIF v2.0，则仅显示一条记录。如果您有多条创建的记录，则仅显示第一个。坐席需要单击 客户卡 中的其他记录才能打开它们。

  1. 打开具有您要显示为弹出屏幕的记录的工作流的 SNIPPET。

  2. 固定记录。如果 createPayload.pinnedRecord 缺失或被设置为 false，则创建的记录将不会在 Microsoft Dynamics 中自动显示为弹出屏幕，即使您完成以下步骤也是如此。

  3. 复制此行代码并将其粘贴到 DYNAMIC create[RecordType]Payload 之前：

    						
createPayload.screenPops = "true"

  4. 保存脚本。

相关记录

您可以将创建的记录与 Microsoft Dynamics 中的其他记录相关联。这可使坐席将其关联 蓝色框中的链节图标。 到 CXone Agent Embedded 客户卡 的“相关交互”部分中显示的记录。当交互完成时，将发生这种关联。对于呼入交互，此关联仅适用于记录中的呼叫发起者字段。对于呼出交互，其仅适用于记录中的呼叫接听者字段。

创建的记录必须加以固定。

创建的记录被固定到“当前交互”部分。链接已单击。记录显示在“相关交互”部分中。

  1. 打开具有您要关联的记录的工作流的 SNIPPET。

  2. 复制此行代码并将其粘贴到 DYNAMIC create[RecordType]Payload 之前：

    						
createPayload.relatesTo = "true"

  3. 保存脚本。