HubSpot-workflows voor CXone Agent configureren

U kunt de workflows Zoeken, Aangepast maken en Standaard maken configureren voor HubSpot en CXone Agent. Deze workflows zoeken of maken HubSpot records, ook entiteiten of objecten genoemd. Dit is de backend-configuratie van een dynamische gegevenstoewijzing.

Workflow Type	Beschrijving	Werkstromen
Zoeken	Zoekworkflows zoeken in HubSpot naar records die van toepassing zijn op de interactie waar de agent mee bezig is.	ANI zoeken
		Aangepaste zoekactie
Aangepast maken	Aangepaste Maken-workflows make elke recordtype met zowel standaard als aangepaste velden.	Aangepast maken
Standaard maken	Standaard Maken-workflows maken standaard HubSpot records met hun standaardgegevensvelden. De SNIPPET-payload van deze workflows moet de standaard velden en alleen die velden bevatten.	Bedrijf maken
		Contact maken
		Ticket maken
		Ticket met koppeling maken

Zoekworkflows configureren

Er zijn twee Zoeken-workflows: ANI zoeken en Aangepast zoeken.

De workflow ANI zoeken configureren

U kunt de workflow ANI zoeken configureren voor telefoongesprekken of e-mails.

1. Ga naar Studio en open het script waarin u de workflow ANI zoeken wilt configureren.

2. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

3. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

4. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor om de workflow ANI zoeken te configureren voor telefoongesprekken.

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

5. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor om de workflow ANI zoeken te configureren voor e-mails.

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

6. Sla het script op.

7. U kunt uw script testen door een interactie te simuleren in Studio.

De workflow Aangepaste zoekactie configureren

Met de workflow Aangepaste zoekactie kunt u van een of meer HubSpot-records zoeken. Ze laten u ook meerdere velden en variabelen binnen een opgegeven record zoeken. U kunt verschillende zoekvereisten verbinden met HubSpot-operators.

Deze workflow ondersteunt de volgende HubSpot-records:

• Bedrijf
• Contact
• Ticket (met of zonder gekoppelde records)

1. Ga naar Studio en open het script waarin u de workflow Aangepaste zoekactie wilt configureren.

2. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

3. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

4. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor.

   
   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. Wijzig de waarden van de attributen filters1 en filters2.

   1. Wijzig de waarden van de attributen filters1.propertyName en filters2.propertyName naar de namen van de velden die u wilt gebruiken om te zoeken. Bijvoorbeeld, filters1.propertyName = "subject".

      Een volledige lijst met veldnamen die eigenschappen heet en eindpunten kunnen worden teruggevonden in de HubSpot-documentatie voor de records:

      • Bedrijf

      • Contact

      • Ticket

   2. Wijzig de waarden van de attributen filters1.operator en filters2.operator naar de HubSpot-operators die u wilt gebruiken. Een volledige lijst van HubSpot-operatoren vindt u in de HubSpot-documentatie . Deze waarde is hoofdlettergevoelig.

   3. Wijzig de waarden van de attributen filters1.value en filters2.value naar de waarden die u aan de velden wilt toewijzen. Bijvoorbeeld, filters1.value = "Account invalid Login".

6. Wijzig de waarden van de sort1-attributen.

   1. Wijzig de waarde van het attribuut sort1.propertyName naar het veld dat u wilt gebruiken om de resultaten te sorteren. Bijvoorbeeld, sort1.propertyName = "createdate".

   2. Wijzig de waarde van het attribuut sort1.direction naar ASCENDING of DESCENDING.

7. Wijzig de waarde van het attribuut searchArray[1].entity naar de API-naam voor de record die u wilt zoeken. Bijvoorbeeld, searchArray[1].entity = "companies". Deze waarde is hoofdlettergevoelig.

   De API-namen voor elke record weergeven

   Opnemen	API	Koppelbaar
   Bedrijf	companies	Ja
   Contact	contacts	Ja
   Ticket	tickets	Ja

8. Sla het script op.

9. U kunt uw script testen door een interactie te simuleren in Studio.

Aangepaste Maken-workflows configureren

Met aangepaste Maken-workflows kunt u een SNIPPET-payload configureren om elk type HubSpot-record te maken, standaard of aangepast. Ze laten u ook toe om een veldtype in te vullen, standaard of aangepast. U kunt bijvoorbeeld een Bedrijfsrecord maken met enkele van de standaardvelden van dat recordtype, evenals uw eigen aangepaste velden.

De workflow Aangepast maken configureren

Met de workflow Aangepaste maken kunt u elk type HubSpot-record maken, standaard of aangepast. Deze record kan standaard- en aangepaste gegevensvelden weergeven. De velden moeten tekst, getallen of variabelen bevatten.

1. Zorg dat de tool Sales Hub Enterprise is ingeschakeld in HubSpot. U hebt deze tool nodig om aangepaste HubSpot-records te maken.

2. Raadpleeg deze HubSpot documentatie om een aangepaste record of aangepast object te maken in HubSpot.

3. Open in Studio het script waarin u de workflow Aangepast maken wilt configureren.

4. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

5. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

6. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor.

   
   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. Wijzig de waarde van het attribuut createPayload.entities.name naar de API voor de aangepaste record die u hebt gemaakt. Bijvoorbeeld, createPayload.entities.name = "companies". Deze waarde is hoofdlettergevoelig.

   De API-namen voor elke standaard record weergeven

   Opnemen	API	Koppelbaar
   Bedrijf	companies	Ja
   Contact	contacts	Ja
   Ticket	tickets	Ja

8. Verander in de createPayload.entities.properties-attributen [fieldname] naar de naam van het veld dat u aan de aangepaste record wilt toevoegen. Bijvoorbeeld, createPayload.entities.properties.accountNumber.

9. Wijzig de waarden van de createPayload.entities.properties-attributen naar de waarden die u aan de velden wilt toewijzen. Bijvoorbeeld, createPayload.entities.properties.accountNumber = "12345".

10. Wijzig de waarde van het attribuut createPayload.pinnedRecord naar true of false. Wanneer dit is ingesteld op true, wordt de gemaakt record weergegeven voor de agent in de sectie Huidige interactie van de klantkaart. Als dit is ingesteld op false, wordt dit weergegeven in de sectie Recente interacties van de klantkaart. Als u dit attribuut niet opneemt in de payload, wordt dit verondersteld als false.

11. Wijzig alle instanties van [ObjectName] in de laatste drie coderegels naar de naam van de record die u hebt gemaakt. Geef de naam een hoofdletter zodat het hoofdlettergebruik overeenkomt met die van het attribuut. Bijvoorbeeld: als de naam van de door u gemaakte record account is, wordt uw code als volgt:

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

12. Sla het script op.

13. U kunt uw script testen door een interactie te simuleren in Studio.

Standaard Maken-workflows configureren

Met standaard Maken-workflows kunnen gebruikers standaard HubSpot-records zoeken binnen HubSpot.

De workflow Bedrijf maken configureren

1. Ga naar Studio en open het script waarin u de workflow Bedrijf maken wilt configureren.

2. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

3. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

4. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor.

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

   U moet elke regel toevoegen. Als u wilt dat een veld leeg blijft, kunt u een nulwaarde ("") gebruiken. Bijvoorbeeld, createPayload.entities.properties.city = "".

5. Wijzig de waarden van de attributen. Alle waarden kunnen hard gecodeerd, een variabele of een combinatie hiervan zijn. Gebruik een variabele als u wilt dat de waarde voor elke interactie wordt bijgewerkt.

   1. Wijzig de waarde van het attribuut createPayload.entities.properties.name naar de bedrijfsnaam. Bijvoorbeeld, createPayload.entities.properties.name = "Classics, Inc.".

   2. Wijzig de waarde van het attribuut createPayload.entities.properties.domain naar de website van het bedrijf. Bijvoorbeeld, createPayload.entities.properties.domain = "classics.com".

   3. Wijzig de waarde van het attribuut createPayload.entities.properties.city naar de stad van het bedrijf. Bijvoorbeeld, createPayload.entities.properties.city = "London".

   4. Wijzig de waarde van het attribuut createPayload.entities.properties.phone naar het telefoonnummer van het bedrijf. Bijvoorbeeld, createPayload.entities.properties.phone = "1234567890".

6. Sla het script op.

7. U kunt uw script testen door een interactie te simuleren in Studio.

De workflow Contact maken configureren

1. Ga naar Studio en open het script waarin u de workflow Contact maken wilt configureren.

2. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

3. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

4. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor.

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

   U moet elke regel toevoegen. Als u wilt dat een veld leeg blijft, kunt u een nulwaarde ("") gebruiken. Bijvoorbeeld, createPayload.entities.properties.email = "".

5. Wijzig de waarden van de attributen. Alle waarden kunnen hard gecodeerd, een variabele of een combinatie hiervan zijn. Gebruik een variabele als u wilt dat de waarde voor elke interactie wordt bijgewerkt.

   1. Wijzig de waarde van het attribuut createPayload.entities.properties.firstName naar de voornaam van het contact. Bijvoorbeeld, createPayload.entities.properties.firstName = "Elinor".

   2. Wijzig de waarde van het attribuut createPayload.entities.properties.email naar het e-mailadres van het contact. Bijvoorbeeld, createPayload.entities.properties.email = "elinor.dashwood@classics.com".

   3. Wijzig de waarde van het attribuut createPayload.entities.properties.lastName naar de achternaam van het contact. Bijvoorbeeld, createPayload.entities.properties.lastName = "Dashwood".
      

   4. Wijzig de waarde van het attribuut createPayload.entities.properties.phone naar het telefoonnummer van het contact. Bijvoorbeeld, createPayload.entities.properties.phone = "1234567890".

6. Sla het script op.

7. U kunt uw script testen door een interactie te simuleren in Studio.

De workflow Ticket maken configureren

1. Ga naar Studio en open het script waarin u de workflow Ticket maken wilt configureren.

2. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

3. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

4. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor.

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

   U moet elke regel toevoegen. Als u wilt dat een veld leeg blijft, kunt u een nulwaarde ("") gebruiken. Bijvoorbeeld, createPayload.entities.properties.hs_ticket_priority = "".

5. Wijzig de waarden van de attributen.

   1. Wijzig de waarde van het attribuut createPayload.entities.properties.subject naar het onderwerp van de ticket: waarom deze is aangemaakt. Bijvoorbeeld, createPayload.entities.properties.subject = "Query about large book orders". Deze kan hard gecodeerd worden, een variabele of een combinatie van beide zijn. Gebruik een variabele als u wilt dat de waarde voor elke interactie wordt bijgewerkt.

   2. Wijzig de waarde van het attribuut createPayload.entities.properties.hs_pipeline naar het pijplijnnummer van de ticket. Bijvoorbeeld, createPayload.entities.properties.hs_pipeline = "0".

   3. Wijzig de waarde van het attribuut createPayload.entities.properties.hs_pipeline_stage naar het nummer dat de status van de ticket in de pijplijn aangeeft. Bijvoorbeeld, createPayload.entities.properties.hs_pipeline_stage = "3".
      

   4. Wijzig de waarde van het attribuut createPayload.entities.properties.hs_ticket_priority naar LOW, MEDIUM of HIGH.

6. Sla het script op.

7. U kunt uw script testen door een interactie te simuleren in Studio.

De workflow Ticket met koppeling maken configureren

1. Ga naar Studio en open het script waarin u de workflow Ticket met koppeling maken wilt configureren.

2. Als u dat nog niet hebt gedaan, voeg dan een SNIPPET-actie toe na BEGIN en vóór de Workflow Execute-actie.

3. Dubbelklik op de SNIPPET-actie op het scriptcanvas.

4. Kopieer elk van de volgende coderegels en plak ze in het tabblad Tekstweergave van het venster Editor.

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

   U moet elke regel toevoegen. Als u wilt dat een veld leeg blijft, kunt u een nulwaarde ("") gebruiken. Bijvoorbeeld, createPayload.entities.properties.hs_ticket_priority = "".

5. Wijzig de waarden van de createPayload-attributen.

   1. Wijzig de waarde van het attribuut createPayload.entities.properties.subject naar het onderwerp van de ticket: waarom deze is aangemaakt. Bijvoorbeeld, createPayload.entities.properties.subject = "Query about mass book orders". Deze kan hard gecodeerd worden, een variabele of een combinatie van beide zijn. Gebruik een variabele als u wilt dat de waarde voor elke interactie wordt bijgewerkt.

   2. Wijzig de waarde van het attribuut createPayload.entities.properties.hs_pipeline naar het pijplijnnummer van de ticket. Bijvoorbeeld, createPayload.entities.properties.hs_pipeline = "0".

   3. Wijzig de waarde van het attribuut createPayload.entities.properties.hs_pipeline_stage naar het nummer dat de status van de ticket in de pijplijn aangeeft. Bijvoorbeeld, createPayload.entities.properties.hs_pipeline_stage = "3".
      

   4. Wijzig de waarde van het attribuut createPayload.entities.properties.hs_ticket_priority naar LOW, MEDIUM of HIGH.

6. Wijzig de waarden van de item1-attributen.

   1. Wijzig de waarde van het attribuut item1.relatedObjectType naar de API voor de record die u aan deze workflow wilt koppelen. Bijvoorbeeld, item1.relatedObjectType = "companies". Deze waarde is hoofdlettergevoelig.

      De API-namen voor elke record weergeven

      Opnemen	API	Koppelbaar
      Bedrijf	companies	Ja
      Contact	contacts	Ja
      Ticket	tickets	Ja

   2. Wijzig de waarde van het attribuut item1.relatedObjectId naar de ID voor de record die u aan deze workflow wilt koppelen. Bijvoorbeeld, item1.relatedObjectId = "19019671367".

7. Sla het script op.

8. U kunt uw script testen door een interactie te simuleren in Studio.

Records vastmaken

U kunt een record vastzetten in de sectie Huidige interactie van de klantenkaart.

1. Open de SNIPPET met de workflow voor de record die u wilt vastzetten.

2. Kopieer deze codelijn en plak deze voor DYNAMIC create[RecordType]Payload:

   						
   createPayload.pinnedRecord = "true"					
   		

3. Sla het script op.