Konfigurieren von HubSpot-Arbeitsabläufen für CXone Agent for Microsoft Teams

Dies ist der letzte Schritt der Integration von HubSpot mit CXone Agent for Microsoft Teams.

Sie können die Arbeitsabläufe "Suchen", "Benutzerdefiniertes Erstellen" und "Standardmäßiges Erstellen" für HubSpot und CXone Agent for Microsoft Teams konfigurieren. Diese Arbeitsabläufe suchen oder erstellen HubSpot-Datensätze, die auch als Entitäten oder Objekte bezeichnet werden. Dies ist die Backend-Konfiguration der Zuordnung dynamischer Daten.

Die benutzerdefinierte Chronik wird für HubSpot nicht unterstützt.

Arbeitsablauf-Typ

 Beschreibung

Arbeitsabläufe
Suchen Arbeitsabläufe des Typs "Suchen" durchsuchen HubSpot nach Datensätzen, die für die Interaktion relevant sind, die der Agent bearbeitet. ANI suchen
Benutzerdefinierte Suche
Erstellen/benutzerdefiniert Arbeitsabläufe des Typs "Benutzerdefiniertes Erstellen" erstellen einen beliebigen Datensatztyp mit standardmäßigen und benutzerdefinierten Feldern. Erstellen/benutzerdefiniert
Erstellen/standardmäßig

Arbeitsabläufe des Typs "Standardmäßiges Erstellen" erstellen standardmäßige HubSpot-Datensätze mit ihren standardmäßigen Datenfeldern. Die SNIPPET-Payload dieser Arbeitsabläufe muss die Standardfelder und nur die Standardfelder enthalten.

 Unternehmen erstellen
Kontakt erstellen
Ticket erstellen
Ticket mit Zuordnung. erstellen

Arbeitsabläufe des Typs "Suchen" konfigurieren

Es gibt zwei Suchen-Arbeitsabläufe: ANI suchen und Benutzerdefinierte Suche.

Konfigurieren des Arbeitsablaufs "ANI suchen"

Sie können den Arbeitsablauf ANI suchen für Telefonanrufe oder E-Mails konfigurieren.

  1. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf ANI suchen konfigurieren möchten.

  2. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  3. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  4. Um den Arbeitsablauf ANI suchen für Telefonanrufe zu konfigurieren, kopieren Sie jede der folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" des Editor-Fensters ein.

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

  5. Um den Arbeitsablauf ANI suchen für E-Mails zu konfigurieren, kopieren Sie jede der folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" des Editor-Fensters ein.

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

  6. Speichern Sie Ihr Skript.

  7. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Konfigurieren des Arbeitsablaufs "Benutzerdefinierte Suche"

Mit dem Arbeitsablauf Benutzerdefinierte Suche können Sie nach einem oder mehren HubSpot-Datensätzen suchen. Sie können damit auch nach mehreren Feldern und Variablen innerhalb eines bestimmten Datensatzes suchen. Verschiedene Suchkriterien lassen sich mithilfe von HubSpot-Operatoren kombinieren.

Dieser Arbeitsablauf unterstützt die folgenden HubSpot-Datensätze:

  • Unternehmen
  • Kontakt
  • Ticket (mit oder ohne zugeordnete Datensätze)

  1. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf Benutzerdefinierte Suche konfigurieren möchten.

  2. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  3. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  4. Kopieren Sie die folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" im Editor-Fenster ein.

    
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. Ändern Sie die Werte der Attribute filters1 und filters2.

    1. Ändern Sie den Wert der Attribute filters1.propertyName und filters2.propertyName in die Namen der Felder, die Sie für die Suche verwenden möchten. Zum Beispiel filters1.propertyName = "subject".

      Eine vollständige Liste der Feldnamen, Eigenschaften genannt, und Endpunkte finden Sie in der HubSpot-Dokumentation für die Datensätze:

    2. Ändern Sie die Werte der Attribute filters1.operator und filters2.operator in die HubSpot-Operatoren, die Sie verwenden möchten. Eine vollständige Liste der HubSpot-Operatoren finden Sie in der HubSpot-Dokumentation Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft. Dabei wird die Groß-/Kleinschreibung beachtet.

    3. Ändern Sie die Werte der Attribute filters1.value und filters2.value in die Werte, die Sie den Feldern zuweisen möchten. Zum Beispiel filters1.value = "Account invalid Login".

  6. Ändern Sie die Werte der Attribute sort1.

    1. Ändern Sie den Wert des Attributs sort1.propertyName in das Feld, das Sie zum Sortieren der Ergebnisse verwenden möchten. Zum Beispiel sort1.propertyName = "createdate".

    2. Ändern Sie den Wert des Attributs sort1.direction in ASCENDING oder DESCENDING.

  7. Ändern Sie den Wert des Attributs searchArray[1].entity in den API-Namen für den Datensatz, den Sie suchen möchten. Zum Beispiel searchArray[1].entity = "companies". Dabei wird die Groß-/Kleinschreibung beachtet.

    Datensatz

    API

    		 Verknüpfbar
    Unternehmen companies Ja
    Kontakt contacts Ja
    Ticket tickets Ja

  8. Speichern Sie Ihr Skript.

  9. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Konfigurieren von Arbeitsabläufen des Typs "Erstellen/benutzerdefiniert"

Arbeitsabläufe für das benutzerdefinierte Erstellen ermöglichen Ihnen, eine SNIPPET-Payload zu konfigurieren, um beliebige Arten von HubSpot-Datensätzen zu erstellen, standardmäßige oder benutzerdefinierte. Außerdem können Sie damit beliebige Feldtypen ausfüllen, standardmäßige oder benutzerdefinierte. Beispielsweise könnten Sie einen Unternehmensdatensatz erstellen, der einige der Standardfelder für diesen Datensatztyp und auch eigene benutzerdefinierte Felder enthält.

Dies ist die empfohlene Methode, um HubSpot-Datensätze zu erstellen.

Konfigurieren des Arbeitsablaufs "Erstellen/benutzerdefiniert"

Der Arbeitsablauf Benutzerdefiniertes Erstellen erstellt einen beliebigen HubSpot-Datensatztyp, standardmäßig oder benutzerdefiniert. Dieser Datensatz kann standardmäßige und benutzerdefinierte Datenfelder anzeigen. Die Felder müssen Text, Zahlen oder Variablen enthalten.

  1. Sales Hub Enterprise muss in HubSpot aktiviert sein. Sie benötigen dieses Tool, um benutzerdefinierte HubSpot-Datensätze zu erstellen.

  2. Lesen Sie in dieser HubSpot-Dokumentation Kästchen mit Pfeil als Anzeige, dass dieser Link eine externe Website aufruft, wie Sie einen benutzerdefinierten Datensatz bzw. ein Objekt in HubSpot erstellen.

  3. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf Erstellen/benutzerdefiniert konfigurieren möchten.

  4. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  5. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  6. Kopieren Sie die folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" im Editor-Fenster ein.

    
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. Ändern Sie den Wert des createPayload.entities.name-Attributs in die API für den benutzerdefinierten Datensatz, den Sie erstellt haben. Zum Beispiel createPayload.entities.name = "companies". Dabei wird die Groß-/Kleinschreibung beachtet.

    Datensatz

    API

    		 Verknüpfbar
    Unternehmen companies Ja
    Kontakt contacts Ja
    Ticket tickets Ja

  8. Ändern Sie in den Attributen createPayload.entities.properties [fieldname] in den Namen des Felds, das Sie zum benutzerdefinierten Datensatz hinzufügen möchten. Zum Beispiel createPayload.entities.properties.accountNumber.

  9. Ändern Sie die Werte der Attribute und createPayload.entities.properties in die Werte, die Sie den Feldern zuweisen möchten. Zum Beispiel createPayload.entities.properties.accountNumber = "12345".

  10. Ändern Sie den Wert des Attributs createPayload.pinnedRecord in true oder false. Mit der Einstellung true wird der erstellte Datensatz den Agenten im Abschnitt "Aktuelle Interaktion" in der Kundenkarte angezeigt. Mit der Einstellung false wird er im Bereich "Letzte Interaktionen" der Kundenkarte angezeigt. Wenn Sie dieses Attribut nicht in der Payload verwenden, wird sein Wert als false vorausgesetzt.

  11. Ändern Sie alle Instanzen von [ObjectName] in den drei letzten Codezeilen in den Namen des Datensatzes, den Sie erstellt haben. Verwenden Sie Großbuchstaben für den Namen, um der Schreibweise des Attributs mit gemischter Groß- und Kleinschreibung zu entsprechen. Wenn der Name des Datensatzes, den Sie erstellt haben, beispielsweise account lautet, sieht Ihr Code folgendermaßen aus:

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

  12. Speichern Sie Ihr Skript.

  13. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Konfigurieren von Arbeitsabläufen des Typs "Erstellen/standardmäßig"

Arbeitsabläufe des Typs "Standardmäßiges Erstellen" ermöglichen Benutzern, standardmäßige HubSpot-Datensätze in HubSpot zu suchen.

Sie können in der SNIPPET-Payload von "Standardmäßiges Erstellen"-Arbeitsabläufen keine Felder hinzufügen oder löschen. Wenn Sie Felder hinzufügen oder löschen, wird der Datensatz nicht erstellt. Um einen standardmäßigen oder benutzerdefinierten Datensatz mit den gewünschten Feldern zu erstellen, verwenden Sie den Arbeitsablauf Benutzerdefiniertes Erstellen.

Konfigurieren des Arbeitsablaufs "Unternehmen erstellen"

  1. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf Unternehmen erstellen konfigurieren möchten.

  2. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  3. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  4. Kopieren Sie die folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" im Editor-Fenster ein.

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

    Sie müssen jede dieser Zeilen einschließen. Wenn ein Feld leer bleiben soll, können Sie einen Nullwert verwenden (""). Zum Beispiel createPayload.entities.properties.city = "".

  5. Ändern Sie die Werte der Attribute. Bei allen kann es sich um einen fest kodierten Wert, eine Variable oder eine Kombination handeln. Verwenden Sie eine Variable, wenn sich der Wert für jede Interaktion ändern soll.

    1. Ändern Sie den Wert des Attributs createPayload.entities.properties.name in den Namen des Unternehmens. Zum Beispiel createPayload.entities.properties.name = "Classics, Inc.".

    2. Ändern Sie den Wert des Attributs createPayload.entities.properties.domain in die Website des Unternehmens. Zum Beispiel createPayload.entities.properties.domain = "classics.com".

    3. Ändern Sie den Wert des Attributs createPayload.entities.properties.city in den Ort des Unternehmens. Zum Beispiel createPayload.entities.properties.city = "London".

    4. Ändern Sie den Wert des Attributs createPayload.entities.properties.phone in die Telefonnummer des Unternehmens. Zum Beispiel createPayload.entities.properties.phone = "1234567890".

  6. Speichern Sie Ihr Skript.

  7. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Konfigurieren des Arbeitsablaufs "Kontakt erstellen"

  1. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf Kontakt erstellen konfigurieren möchten.

  2. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  3. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  4. Kopieren Sie die folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" im Editor-Fenster ein.

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

    Sie müssen jede dieser Zeilen einschließen. Wenn ein Feld leer bleiben soll, können Sie einen Nullwert verwenden (""). Zum Beispiel createPayload.entities.properties.email = "".

  5. Ändern Sie die Werte der Attribute. Bei allen kann es sich um einen fest kodierten Wert, eine Variable oder eine Kombination handeln. Verwenden Sie eine Variable, wenn sich der Wert für jede Interaktion ändern soll.

    1. Ändern Sie den Wert des Attributs createPayload.entities.properties.firstName in den Vornamen des Kontakts. Zum Beispiel createPayload.entities.properties.firstName = "Elinor".

    2. Ändern Sie den Wert des Attributs createPayload.entities.properties.email in die E-Mail-Adresse des Kontakts. Zum Beispiel createPayload.entities.properties.email = "elinor.dashwood@classics.com".

    3. Ändern Sie den Wert des Attributs createPayload.entities.properties.lastName in den Nachnamen des Kontakts. Zum Beispiel createPayload.entities.properties.lastName = "Dashwood".

    4. Ändern Sie den Wert des Attributs createPayload.entities.properties.phone in die Telefonnummer des Kontakts. Zum Beispiel createPayload.entities.properties.phone = "1234567890".

  6. Speichern Sie Ihr Skript.

  7. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Konfigurieren des Arbeitsablaufs "Ticket erstellen"

  1. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf Ticket erstellen konfigurieren möchten.

  2. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  3. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  4. Kopieren Sie die folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" im Editor-Fenster ein.

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

    Sie müssen jede dieser Zeilen einschließen. Wenn ein Feld leer bleiben soll, können Sie einen Nullwert verwenden (""). Zum Beispiel createPayload.entities.properties.hs_ticket_priority = "".

  5. Ändern Sie die Werte der Attribute.

    1. Ändern Sie den Wert des Attributs createPayload.entities.properties.subject in das Thema des Tickets: Warum wurde es erstellt. Zum Beispiel createPayload.entities.properties.subject = "Query about large book orders". Dieser Wert kann fest kodiert, eine Variable oder eine Kombination sein. Verwenden Sie eine Variable, wenn sich der Wert für jede Interaktion ändern soll.

    2. Ändern Sie den Wert des Attributs createPayload.entities.properties.hs_pipeline in die Pipeline-Nummer des Tickets. Zum Beispiel createPayload.entities.properties.hs_pipeline = "0".

    3. Ändern Sie den Wert des Attributs createPayload.entities.properties.hs_pipeline_stage in die Zahl, die den Status des Tickets in der Pipeline angibt. Zum Beispiel createPayload.entities.properties.hs_pipeline_stage = "3".

    4. Ändern Sie den Wert des Attributs createPayload.entities.properties.hs_ticket_priority in LOW, MEDIUM oder HIGH.

  6. Speichern Sie Ihr Skript.

  7. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Konfigurieren des Arbeitsablaufs "Ticket mit Zuordnung erstellen"

  1. Öffnen Sie in Studio das Skript, in dem Sie den Arbeitsablauf Ticket mit Zuordnung erstellen konfigurieren möchten.

  2. Fügen Sie eine SNIPPET Aktion nach BEGIN und vor der Workflow Execute Aktion hinzu, falls noch nicht geschehen.

  3. Doppelklicken Sie im Skriptbereich auf die SNIPPET-Aktion.

  4. Kopieren Sie die folgenden Codezeilen und fügen Sie sie in die Registerkarte "Textansicht" im Editor-Fenster ein.

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

    Sie müssen jede dieser Zeilen einschließen. Wenn ein Feld leer bleiben soll, können Sie einen Nullwert verwenden (""). Zum Beispiel createPayload.entities.properties.hs_ticket_priority = "".

  5. Ändern Sie die Werte der Attribute createPayload.

    1. Ändern Sie den Wert des Attributs createPayload.entities.properties.subject in das Thema des Tickets: Warum wurde es erstellt. Zum Beispiel createPayload.entities.properties.subject = "Query about mass book orders". Dieser Wert kann fest kodiert, eine Variable oder eine Kombination sein. Verwenden Sie eine Variable, wenn sich der Wert für jede Interaktion ändern soll.

    2. Ändern Sie den Wert des Attributs createPayload.entities.properties.hs_pipeline in die Pipeline-Nummer des Tickets. Zum Beispiel createPayload.entities.properties.hs_pipeline = "0".

    3. Ändern Sie den Wert des Attributs createPayload.entities.properties.hs_pipeline_stage in die Zahl, die den Status des Tickets in der Pipeline angibt. Zum Beispiel createPayload.entities.properties.hs_pipeline_stage = "3".

    4. Ändern Sie den Wert des Attributs createPayload.entities.properties.hs_ticket_priority in LOW, MEDIUM oder HIGH.

  6. Ändern Sie die Werte der Attribute item1.

    1. Ändern Sie den Wert des Attributs item1.relatedObjectType in die API für den Datensatz, den Sie mit diesem Arbeitsablauf verbinden möchten. Zum Beispiel item1.relatedObjectType = "companies". Dabei wird die Groß-/Kleinschreibung beachtet.

      Datensatz

      API

      		 Verknüpfbar
      Unternehmen companies Ja
      Kontakt contacts Ja
      Ticket tickets Ja

    2. Ändern Sie den Wert des Attributs item1.relatedObjectId in die ID-Nummer des Datensatzes, den Sie mit diesem Arbeitsablauf verbinden möchten. Zum Beispiel item1.relatedObjectId = "19019671367".

  7. Speichern Sie Ihr Skript.

  8. Sie können Ihr Skript testen, indem Sie in Studio eine Interaktion simulieren.

Datensätze anheften

Sie können einen Datensatz an den Abschnitt mit der aktuellen Interaktion in der Kundenkarte anheften.

  1. Öffnen Sie das SNIPPET mit dem Arbeitsablauf für den Datensatz, den Sie anheften möchten.

  2. Kopieren Sie die folgende Codezeile und fügen Sie sie vor DYNAMIC create[RecordType]Payload ein:

    						
createPayload.pinnedRecord = "true"

  3. Speichern Sie Ihr Skript.