為CXone Agent配置 HubSpot工作流程

您可以為HubSpot和CXone Agent 配置搜尋、自訂建立和標準建立工作流程。這些工作流程搜尋或建立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 名稱

   記錄	API	可連結
   公司	companies	是
   聯絡	contacts	是
   票證	tickets	是

8. 儲存您的指令碼。

9. 您可以透過 在 Studio 中模擬互動來測試您的指令碼。

配置自訂建立工作流程

自訂建立工作流程可讓您配置 SNIPPET 工作負載以建立任何類型的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 名稱

   記錄	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記錄。

配置建立公司工作流程

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()}"
   		

   您必須包含這些代碼中的每一行。如果希望欄位保持空白，可以使用 null 值 ("")。例如，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()}"
   		

   您必須包含這些代碼中的每一行。如果希望欄位保持空白，可以使用 null 值 ("")。例如，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()}"
   		

   您必須包含這些代碼中的每一行。如果希望欄位保持空白，可以使用 null 值 ("")。例如，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()}"
   		

   您必須包含這些代碼中的每一行。如果希望欄位保持空白，可以使用 null 值 ("")。例如，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 名稱

      記錄	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. 儲存您的指令碼。