为 CXone Agent for Microsoft Teams 配置 HubSpot 工作流

这是将 HubSpot 与 CXone Agent for Microsoft Teams 集成的最后一步。

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

HubSpot 不支持自定义时间线。

工作流类型

 说明

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

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

 创建公司
创建联系人
创建票证
创建具有关联的票证

配置“搜索”工作流

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

配置“搜索 ANI”工作流

您可以为电话或电子邮件配置搜索 ANI 工作流。

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

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

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

  4. 要为电话配置搜索 ANI 工作流，则复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
ASSIGN phoneNumber = "{ANI}"
ASSIGN email = ""
DYNAMIC searchInput
searchInput.phoneNumber = "{phoneNumber}"
DYNAMIC searchFlowPayload
searchFlowPayload.workflowInput = searchInput

  5. 要为电子邮件配置搜索 ANI 工作流，则复制以下每一行代码并将其粘贴到“编辑器”窗口的“文本视图”选项卡中。

    
ASSIGN phoneNumber = ""
ASSIGN email = "{ANI}"
DYNAMIC searchInput
searchInput.email = "{email}"
DYNAMIC searchFlowPayload
searchFlowPayload.workflowInput = searchInput

  6. 保存脚本。

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

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

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

此工作流支持以下 HubSpot 记录：

  • 公司
  • 联系
  • 票证（有或没有关联记录）

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

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

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

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

    
DYNAMIC filterGroups
	
DYNAMIC filters1
filters1.propertyName = "[fieldName]"
filters1.operator = "[operator]"
filters1.value = "[value]"

DYNAMIC filters2
filters2.propertyName = "[fieldName]"		
filters2.operator = "[operator]"
filters2.value = "[value]"

filterGroups.filters[1] = filters1
filterGroups.filters[2] = filters2

DYNAMIC sorts
DYNAMIC sort1
sort1.propertyName = "[fieldName]"
sort1.direction = "[ASCENDING or DESCENDING]"
sorts[1] = sort1

DYNAMIC searchArray
searchArray[1].entity = "[API name]"
searchArray[1].filter.filterGroups[1] = filterGroups

DYNAMIC searchFlowPayload
searchFlowPayload.workflowInput.entities = searchArray

  5. 更改 filters1 和 filters2 属性的值。

    1. 将 filters1.propertyName 和 filters2.propertyName 属性的值更改为您要用于搜索的字段的名称。例如，filters1.propertyName = "subject"。

      字段名称的完整列表（称为属性和端点）可以在记录的 HubSpot 文档中找到：

    2. 将 filters1.operator 和 filters2.operator 属性的值更改为要使用的 HubSpot 运算符。HubSpot 运算符的完整列表可以在 HubSpot 文档 带有指示导航到外部站点的箭头的框。 中找到。其区分大小写。

    3. 将 filters1.value 和 filters2.value 属性的值更改为您要分配到这些字段的值。例如，filters1.value = "Account invalid Login"。

  6. 更改这些 sort1 属性的值。

    1. 将 sort1.propertyName 属性的值更改为您要用于对结果进行排序的字段。例如，sort1.propertyName = "createdate"。

    2. 将 sort1.direction 属性的值更改为 ASCENDING 或 DESCENDING。

  7. 将 searchArray[1].entity 属性的值更改为您要搜索的记录的 API 名称。例如，searchArray[1].entity = "companies"。其区分大小写。

    记录

    API

    		 可链接
    公司 companies 是
    联系 contacts 是
    票证 tickets 是

  8. 保存脚本。

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

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

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

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

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

自定义创建工作流可创建任何类型的 HubSpot 记录（标准或自定义）。此记录可以显示标准和自定义数据字段。这些字段必须包含文本、数字或变量。

  1. 确保您已在 HubSpot 中启用了 Sales Hub Enterprise 工具。您需要此工具才能创建自定义 HubSpot 记录。

  2. 使用此 HubSpot 文档 带有指示导航到外部站点的箭头的框。 在 HubSpot 中创建自定义记录或对象。

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

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

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

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

    
DYNAMIC createPayload
createPayload.entities.name = "[custom record API]"
createPayload.entities.properties.[fieldName]= "[field value]"
createPayload.entities.properties.[fieldName]= "[field value]"
createPayload.entities.properties.[fieldName]= "[field value]"
createPayload.entities.properties.[fieldName]= "[field value]"
						
createPayload.pinnedRecord = "[true or false]"

DYNAMIC create[ObjectName]Payload
create[ObjectName]Payload.workflowInput = createPayload

ASSIGN create[ObjectName]Json = "{create[RecordName]Payload.asjson()}"

  7. 将 createPayload.entities.name 属性的值更改为您创建的自定义记录的 API。例如，createPayload.entities.name = "companies"。其区分大小写。

    记录

    API

    		 可链接
    公司 companies 是
    联系 contacts 是
    票证 tickets 是

  8. 在 createPayload.entities.properties 属性中，将 [fieldname] 更改为要添加到自定义记录的字段的名称。例如，createPayload.entities.properties.accountNumber。

  9. 将 createPayload.entities.properties 属性的值更改为您要分配到这些字段的值。例如，createPayload.entities.properties.accountNumber = "12345"。

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

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

    
DYNAMIC createAccountPayload
createAccountPayload.workflowInput = createPayload
						
ASSIGN createAccountJson = "{createAccountPayload.asjson()}"

  12. 保存脚本。

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

配置“标准创建”工作流

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

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

配置“创建公司”工作流

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

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

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

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

    
DYNAMIC createPayload
createPayload.entities.name = "company"
createPayload.entities.properties.name = "[company name]"
createPayload.entities.properties.domain = "[company website]"
createPayload.entities.properties.city = "[company city]"
createPayload.entities.properties.phone = "[company phone number]"
						
DYNAMIC createCompanyPayload
createCompanyPayload.workflowInput = createPayload

ASSIGN createCompanyJson = "{createCompanyPayload.asjson()}"

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

  5. 更改这些属性的值。其中任何一个都可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

    1. 将 createPayload.entities.properties.name 属性的值更改为公司的名称。例如，createPayload.entities.properties.name = "Classics, Inc."。

    2. 将 createPayload.entities.properties.domain 属性的值更改为公司的网站。例如，createPayload.entities.properties.domain = "classics.com"。

    3. 将 createPayload.entities.properties.city 属性的值更改为公司的城市。例如， createPayload.entities.properties.city = "London"。

    4. 将 createPayload.entities.properties.phone 属性的值更改为公司的电话号码。例如，createPayload.entities.properties.phone = "1234567890"。

  6. 保存脚本。

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

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

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

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

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

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

    
DYNAMIC createPayload
createPayload.entities.name = "contact"
createPayload.entities.properties.firstName = "[first name]"
createPayload.entities.properties.email = "[email address]"
createPayload.entities.properties.lastName = "[last name]"
createPayload.entities.properties.phone = "[phone number]"

DYNAMIC createContactPayload
createContactPayload.workflowInput = createPayload

ASSIGN createContactJson = "{createContactPayload.asjson()}"

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

  5. 更改这些属性的值。其中任何一个都可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

    1. 将 createPayload.entities.properties.firstName 属性的值更改为联系人的名字。例如， createPayload.entities.properties.firstName = "Elinor"。

    2. 将 createPayload.entities.properties.email 属性的值更改为联系人的电子邮件地址。例如，createPayload.entities.properties.email = "elinor.dashwood@classics.com"。

    3. 将 createPayload.entities.properties.lastName 属性的值更改为联系人的姓氏。例如，createPayload.entities.properties.lastName = "Dashwood"。

    4. 将 createPayload.entities.properties.phone 属性的值更改为联系人的电话号码。例如， createPayload.entities.properties.phone = "1234567890"。

  6. 保存脚本。

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

配置“创建票证”工作流

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

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

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

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

    
DYNAMIC createPayload
createPayload.entities.name = "ticket"
createPayload.entities.properties.subject = "[ticket subject]"
createPayload.entities.properties.hs_pipeline = "[#]"
createPayload.entities.properties.hs_pipeline_stage = "[#]"
createPayload.entities.properties.hs_ticket_priority = "[LOW, MEDIUM, or HIGH]"

DYNAMIC createTicketPayload
createTicketPayload.workflowInput = createPayload

ASSIGN createTicketJson = "{createTicketPayload.asjson()}"

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

  5. 更改这些属性的值。

    1. 将 createPayload.entities.properties.subject 属性的值更改为票证主题：创建票证的原因。例如， createPayload.entities.properties.subject = "Query about large book orders"。这可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

    2. 将 createPayload.entities.properties.hs_pipeline 属性的值更改为票证的管道编号。例如，createPayload.entities.properties.hs_pipeline = "0"。

    3. 将 createPayload.entities.properties.hs_pipeline_stage 属性的值更改为指示票证在管道中的状态的数字。例如， createPayload.entities.properties.hs_pipeline_stage = "3"。

    4. 将 createPayload.entities.properties.hs_ticket_priority 属性的值更改为 LOW、MEDIUM 或 HIGH。

  6. 保存脚本。

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

配置“创建具有关联的票证”工作流

  1. 在 Studio 中，打开您要在其中配置创建具有关联的票证工作流的脚本。

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

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

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

    
DYNAMIC createPayload
createPayload.entities.name = "ticket"
createPayload.entities.properties.subject = "[ticket subject]"
createPayload.entities.properties.hs_pipeline = "[#]"
createPayload.entities.properties.hs_pipeline_stage = "[#]"
createPayload.entities.properties.hs_ticket_priority = "[LOW, MEDIUM, or HIGH]"

DYNAMIC Association
DYNAMIC item1
item1.relatedObjectType = "[record API]"
item1.relatedObjectId = "[#]"
createPayload.entities.association[1] = item1

DYNAMIC createTicketPayload
createTicketPayload.workflowInput = createPayload

ASSIGN createTicketJson = "{createTicketPayload.asjson()}"

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

  5. 更改这些 createPayload 属性的值。

    1. 将 createPayload.entities.properties.subject 属性的值更改为票证主题：创建票证的原因。例如， createPayload.entities.properties.subject = "Query about mass book orders"。这可以是硬编码值、变量或它们的组合。如果您希望该值针对每次交互进行更新，请使用变量。

    2. 将 createPayload.entities.properties.hs_pipeline 属性的值更改为票证的管道编号。例如，createPayload.entities.properties.hs_pipeline = "0"。

    3. 将 createPayload.entities.properties.hs_pipeline_stage 属性的值更改为指示票证在管道中的状态的数字。例如， createPayload.entities.properties.hs_pipeline_stage = "3"。

    4. 将 createPayload.entities.properties.hs_ticket_priority 属性的值更改为 LOW、MEDIUM 或 HIGH。

  6. 更改这些 item1 属性的值。

    1. 将 item1.relatedObjectType 属性的值更改为您要连接到此工作流的记录的 API。例如，item1.relatedObjectType = "companies"。其区分大小写。

      记录

      API

      		 可链接
      公司 companies 是
      联系 contacts 是
      票证 tickets 是

    2. 将 item1.relatedObjectId 属性的值更改为您要连接到此工作流的记录的 ID 号。例如，item1.relatedObjectId = "19019671367"。

  7. 保存脚本。

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

固定记录

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

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

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

    						
createPayload.pinnedRecord = "true"

  3. 保存脚本。