Configurer les Flux de travail HubSpot pour Agent Workspace (Agent)

Il s'agit de la dernière étape de l'intégration de HubSpot à Agent Workspace (Agent). Vous pouvez plutôt effectuer cette tâche à l'aide de l'action Studio ENHANCED WORKFLOW EXECUTE. Vous pouvez également, si vous le souhaitez, permettre aux agents de créer manuellement des enregistrements.

Vous pouvez configurer les flux de travail de recherche, de création personnalisée et de création standard pour HubSpot et NiCE CXone Agent Workspace (Agent). Ces flux de travail recherchent ou créent des enregistrements HubSpot, également appelés entités ou objets. Il s'agit de la configuration en arrière-plan du mappage des données dynamiques.

La chronologie personnalisée n’est pas prise en charge pour HubSpot.

Type de flux de travail

 Description

Flux de travail
Rechercher Les flux de travail de recherche analysent HubSpot pour trouver des enregistrements applicables à l'interactionClosed La conversation complète avec un agent sur un canal. Par exemple, une interaction peut être un appel vocal, un courriel, un clavardage ou une conversation sur les réseaux sociaux. que l'agent traite. Recherche d'EAN
Recherche personnalisée
Création personnalisée Les flux de travail de création personnalisée permettent de créer n’importe quel type d’enregistrement avec des champs standard et personnalisés. Création personnalisée
Création standard

Les flux de travail de création standard créent des enregistrements HubSpot standard avec leurs champs de données standard. La charge utile SNIPPET de ces flux de travail doit inclure les champs standard et uniquement ces champs.

 Créer une entreprise (Company)
Créer un contact
Créer un Ticket
Créer un ticket avec association

Les flux de travail s'exécutent à l'aide des rôles et autorisations de l'utilisateur du système. Il s'agit du compte utilisateur HubSpot que vous avez créé spécifiquement pour la configuration de NiCE CXone. Lorsque des enregistrements sont créés, ils utilisent le nom et le fuseau horaire de l'utilisateur du système.

Avant de commencer, consultez le diagramme d'intégration CRM, le diagramme des flux de travail CRM, et la liste de terminologie d'intégration CRM.

De plus, téléchargez ce dossier de scripts modèles. Il contient des scripts voix et numériques pour Desktop Studio et Studio.

Configurer les Flux de travail de recherche

Il existe deux flux de recherche : Recherche d’EAN et Recherche personnalisée.

Lorsque vous utilisez des mappages de données dynamiques dans un flux de travail de recherche, la Section Interactions associée dans la fiche client icon: a person next to a document. affiche d'abord les enregistrements qui :

  • correspondent aux critères de recherche, et

  • contiennent des données dans chaque champ mappé.

Les agents peuvent cliquer sur Actualiser dans la fiche client icon: a person next to a document. pour afficher tous les enregistrements qui correspondent aux critères de recherche.

Configurer le Flux de travail de la recherche d’EAN

Vous pouvez configurer le flux de travail Rechercher un EAN pour les appels téléphoniques ou les courriels.

N'incluez pas la propriété timeoutMilliSec dans le code de votre flux de travail. Cela pourrait entraîner que plusieurs occurrences de la même interaction soient livrées à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le flux de travail Recherche pour EAN.

  2. Si ce n'est pas déjà fait, ajoutez une SNIPPET action après BEGIN et avant l'Exécution du Flux de travail action.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Pour configurer le flux de travail Rechercher un EAN pour les appels téléphoniques, copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

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

  5. Pour configurer le flux de travail Rechercher un EAN pour les courriels, copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

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

  6. Enregistrez votre script.

  7. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le Flux de travail de la recherche personnalisée

Le flux de travail Recherche personnalisée vous permet de rechercher un ou plusieurs enregistrements HubSpot. Ils vous permettent également de rechercher plusieurs champs et variables au sein d'un enregistrement spécifié. Vous pouvez connecter différentes exigences de recherche à l'aide d'opérateurs HubSpot.

Ce flux de travail prend en charge ces enregistrements HubSpot :

  • Entreprise (Company)
  • Contact
  • Ticket (avec ou sans enregistrements associés)

N'incluez pas la propriété timeoutMilliSec dans le code de votre flux de travail. Cela pourrait entraîner que plusieurs occurrences de la même interaction soient livrées à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le flux de travail Recherche personnalisée.

  2. Si ce n'est pas déjà fait, ajoutez une SNIPPET action après BEGIN et avant l'Exécution du Flux de travail action.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

    
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.search = searchArray
ASSIGN searchJson = "{searchFlowPayload.asjson()}"

  5. Modifiez la valeur des attributs filters1 et filters2.

    1. Modifiez les valeurs des attributs filters1.propertyName et filters2.propertyName pour qu'elles correspondent aux noms des champs que vous souhaitez utiliser pour la recherche. Par exemple, filters1.propertyName = "subject".

      Une liste complète des noms de champs, appelés propriétés, et des points de terminaison se trouve dans la documentation HubSpot pour les enregistrements :

    2. Modifiez les valeurs des attributs filters1.operator et filters2.operator pour les opérateurs HubSpot que vous voulez utiliser. Une liste complète des opérateurs HubSpot se trouve dans la documentation HubSpot Boîte avec une flèche indiquant la navigation vers un site externe.. La valeur est sensible à la casse.

    3. Modifiez les valeurs des attributs filters1.value et filters2.value pour les valeurs que vous voulez assigner aux champs. Par exemple, filters1.value = "Account invalid Login".

  6. Modifiez les valeurs des attributs sort1.

    1. Modifiez la valeur de l'attribut sort1.propertyName pour le champ que vous voulez utiliser pour trier les résultats. Par exemple, sort1.propertyName = "createdate".

    2. Remplacez la valeur de l’attribut sort1.direction par ASCENDING ou DESCENDING.

  7. Modifiez la valeur de l'attribut searchArray[1].entity pour le nom API de l'enregistrement que vous voulez rechercher. Par exemple, searchArray[1].entity = "company". La valeur est sensible à la casse.

    Enregistrement

    API

    		 Peut être lié
    Entreprise (Company) company Oui
    Contact contact Oui
    Ticket ticket Oui

  8. Enregistrez votre script.

  9. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer des Flux de travail de création personnalisée

Les flux de travail de création personnalisée vous permettent de configurer une charge utile SNIPPET pour créer tout type d'enregistrement HubSpot, standard ou personnalisé. Ils vous permettent également de remplir tout type de champ, standard ou personnalisé. Par exemple, vous pourriez créer un enregistrement Company avec certains des champs standards de ce type d'enregistrement, ainsi que vos propres champs personnalisés.

C’est la méthode recommandée pour créer des enregistrements HubSpot.

Configurer le Flux de travail de création personnalisée

Le flux de travail Custom Create crée tout type d'enregistrement HubSpot, standard ou personnalisé. Cet enregistrement peut afficher des champs de données standards et personnalisés. Les champs doivent contenir du texte, des nombres ou des variables.

  1. Assurez-vous que l'outil Sales Hub Enterprise est activé dans HubSpot. Vous avez besoin de cet outil afin de créer des enregistrements HubSpot personnalisés.

  2. Utilisez cette documentation HubSpot Boîte avec une flèche indiquant la navigation vers un site externe. pour créer un enregistrement personnalisé, ou objet, dans HubSpot.

  3. Dans Studio, ouvrez le script dans lequel vous voulez configurer le flux de travail Custom Create.

  4. Si ce n'est pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Exécution du Flux de travail.

  5. Double-clic sur l'action SNIPPET sur le canevas du script.

  6. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

    
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]"
createPayload.screenPop = "[true or false]"

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

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

  7. Modifiez la valeur de l'attribut createPayload.entities.name pour l'API de l'enregistrement personnalisé que vous avez créé. Par exemple, createPayload.entities.name = "companies". La valeur est sensible à la casse.

    Enregistrement

    API

    		 Peut être lié
    Entreprise (Company) companies Oui
    Contact contacts Oui
    Ticket tickets Oui

  8. Dans les attributs createPayload.entities.properties, remplacez [fieldname] par le nom du champ que vous voulez ajouter à l'enregistrement personnalisé. Par exemple, createPayload.entities.properties.accountNumber.

  9. Modifiez les valeurs des attributs createPayload.entities.properties pour les valeurs que vous voulez assigner aux champs. Par exemple, createPayload.entities.properties.accountNumber = "12345".

  10. Modifiez la valeur de l'attribut createPayload.pinnedRecord pour true ou false. Lorsque la valeur est true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelle de la fiche client. Lorsque la valeur est false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, la valeur false sera présumée.
  11. Modifiez la valeur de l'attribut createPayload.screenPop pour true ou false. Lorsque la valeur est true, l'enregistrement créé apparaît automatiquement pour l'agent sous forme d'incrustation à l'écran dans HubSpot. Lorsque la valeur est false, ce n'est pas le cas. Si vous n'incluez pas cet attribut dans la charge utile, la valeur false sera présumée.

  12. Modifiez toutes les occurrences de [ObjectName] dans les trois dernières lignes du code pour le nom de l'enregistrement que vous avez créé. Mettez une majuscule au nom pour qu'il corresponde à la casse de l'attribut. Par exemple, si le nom de l'enregistrement que vous avez créé est account, votre code serait :

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

  13. Cliquez sur l'action Exécution du Flux de travail qui suit le SNIPPET de ce flux de travail. Définissez la propriété workflowPayload de cette action à la variable create[ObjectName]Json dans la dernière ligne de la charge utile SNIPPET. Mettez-la entre accolades ( { } ). Par exemple, {createAccountJson}.

  14. Enregistrez votre script.

  15. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configuration des Flux de travail de création standard

Les flux de travail de création standard créent des enregistrements HubSpot standard avec les champs spécifiés dans la charge utile du flux de travail.

Vous ne pouvez pas ajouter ou supprimer des champs dans la charge utile SNIPPET des flux de travail de création standard. Si vous ajoutez ou supprimez des champs, l'enregistrement ne sera pas créé. Pour créer un enregistrement standard ou personnalisé avec les champs que vous voulez, utilisez le flux de travail Création personnalisée.

Configurer le Flux de travail de création d'une entreprise

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le flux de travail Créer Entreprise (Company).

  2. Si ce n'est pas déjà fait, ajoutez une SNIPPET action après BEGIN et avant l'Exécution du Flux de travail action.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

    
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]"
						
createPayload.pinnedRecord = "[true or false]"
createPayload.screenPop = "[true or false]"
						
DYNAMIC createCompanyPayload
createCompanyPayload.workflowInput = createPayload

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

    Vous devez inclure chacune de ces lignes. Si vous voulez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.entities.properties.city = "".

  5. Changez les valeurs des attributs. Chacun de ces éléments peut être codé en dur, être une variable ou une combinaison des deux. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

    1. Changez la valeur de l'attribut createPayload.entities.properties.name pour le nom de l'entreprise. Par exemple, createPayload.entities.properties.name = "Classics, Inc.".

    2. Changez la valeur de l'attribut createPayload.entities.properties.domain pour le site Web de l'entreprise. Par exemple, createPayload.entities.properties.domain = "classics.com".

    3. Changez la valeur de l'attribut createPayload.entities.properties.city pour la ville de l'entreprise. Par exemple, createPayload.entities.properties.city = "London".

    4. Changez la valeur de l'attribut createPayload.entities.properties.phone pour le numéro de téléphone de l'entreprise. Par exemple, createPayload.entities.properties.phone = "1234567890".

  6. Changez la valeur de l'attribut createPayload.pinnedRecord pour true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche aux agents dans la section Current Interactions de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, la valeur false sera présumée.
  7. Changez la valeur de l'attribut createPayload.screenPop pour true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche automatiquement à l'agent sous forme de fenêtre contextuelle dans HubSpot. Lorsqu'elle est définie sur false, ce n'est pas le cas. Si vous n'incluez pas cet attribut dans la charge utile, la valeur false sera présumée.

  8. Cliquez sur l'action Exécution du Flux de travail qui suit le SNIPPET de ce flux de travail. Définissez la propriété workflowPayload de cette action sur {createCompanyJson}. Assurez-vous d'inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le Flux de travail de création de contact

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le flux de travail Créer Contact.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET dans le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

    
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]"
						
createPayload.pinnedRecord = "[true or false]"
createPayload.screenPop = "[true or false]"

DYNAMIC createContactPayload
createContactPayload.workflowInput = createPayload

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

    Vous devez inclure chacune de ces lignes. Si vous voulez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.entities.properties.email = "".

  5. Modifiez les valeurs des attributs. Chacun de ces éléments peut être codé en dur, être une variable ou une combinaison des deux. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

    1. Modifiez la valeur de l'attribut createPayload.entities.properties.firstName pour qu'elle corresponde au prénom du contact. Par exemple, createPayload.entities.properties.firstName = "Elinor".

    2. Modifiez la valeur de l'attribut createPayload.entities.properties.email pour qu'elle corresponde à l'adresse courriel du contact. Par exemple, createPayload.entities.properties.email = "elinor.dashwood@classics.com".

    3. Modifiez la valeur de l'attribut createPayload.entities.properties.lastName pour qu'elle corresponde au nom du contact. Par exemple, createPayload.entities.properties.lastName = "Dashwood".

    4. Modifiez la valeur de l'attribut createPayload.entities.properties.phone pour qu'elle corresponde au numéro de téléphone du contact. Par exemple, createPayload.entities.properties.phone = "1234567890".

  6. Modifiez la valeur de l'attribut createPayload.pinnedRecord à true ou false. Lorsqu'elle est définie à true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelle de la fiche client. Lorsqu'elle est définie à false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  7. Modifiez la valeur de l'attribut createPayload.screenPop à true ou false. Lorsqu'elle est définie à true, l'enregistrement créé s'affiche automatiquement pour l'agent sous la forme d'une fenêtre contextuelle dans HubSpot. Lorsqu'elle est définie à false, ce n'est pas le cas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  8. Cliquez sur l'action Workflow Execute qui suit le SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action à {createContactJson}. Assurez-vous d'inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le Flux de travail de création de ticket

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le flux de travail Create Ticket.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

    
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]"
						
createPayload.pinnedRecord = "[true or false]"
createPayload.screenPop = "[true or false]"

DYNAMIC createTicketPayload
createTicketPayload.workflowInput = createPayload

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

    Vous devez inclure chacune de ces lignes. Si vous voulez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.entities.properties.hs_ticket_priority = "".

  5. Modifiez la valeur des attributs.

    1. Changez la valeur de l'attribut createPayload.entities.properties.subject pour l'objet du ticket : pourquoi il a été créé. Par exemple, createPayload.entities.properties.subject = "Query about large book orders". Cette valeur peut être codée en dur, être une variable ou une combinaison des deux. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

    2. Changez la valeur de l'attribut createPayload.entities.properties.hs_pipeline pour le numéro de pipeline du ticket. Par exemple, createPayload.entities.properties.hs_pipeline = "0".

    3. Changez la valeur de l'attribut createPayload.entities.properties.hs_pipeline_stage pour le nombre qui indique l'état du ticket dans le pipeline. Par exemple, createPayload.entities.properties.hs_pipeline_stage = "3".

    4. Remplacez la valeur de l’attribut createPayload.entities.properties.hs_ticket_priority par LOW, MEDIUM ou HIGH.

  6. Changez la valeur de l'attribut createPayload.pinnedRecord pour true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelles de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  7. Changez la valeur de l'attribut createPayload.screenPop pour true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche automatiquement à l'agent sous forme de fenêtre contextuelle dans HubSpot. Lorsqu'elle est définie sur false, ce n'est pas le cas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  8. Cliquez sur l'action Exécution du Flux de travail qui suit le SNIPPET de ce flux de travail. Définissez la propriété workflowPayload de cette action sur {createTicketJson}. Assurez-vous d'inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le Flux de travail de création de ticket avec association

  1. Dans Studio, ouvrez le script dans lequel vous voulez configurer le flux de travail Create Ticket with Association.

  2. Si ce n'est pas déjà fait, ajoutez une SNIPPET action après BEGIN et avant l'Exécution du Flux de travail action.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet Vue textuelle de la fenêtre de l’éditeur.

    
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]"
						
createPayload.pinnedRecord = "[true or false]"
createPayload.screenPop = "[true or false]"

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

DYNAMIC createTicketPayload
createTicketPayload.workflowInput = createPayload

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

    Vous devez inclure chacune de ces lignes. Si vous voulez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.entities.properties.hs_ticket_priority = "".

  5. Modifiez les valeurs des attributs createPayload.

    1. Changez la valeur de l'attribut createPayload.entities.properties.subject pour l'objet du ticket : pourquoi il a été créé. Par exemple, createPayload.entities.properties.subject = "Query about mass book orders". Cette valeur peut être codée en dur, être une variable ou une combinaison des deux. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

    2. Changez la valeur de l'attribut createPayload.entities.properties.hs_pipeline pour le numéro du pipeline du ticket. Par exemple, createPayload.entities.properties.hs_pipeline = "0".

    3. Changez la valeur de l'attribut createPayload.entities.properties.hs_pipeline_stage pour le nombre qui indique l'état du ticket dans le pipeline. Par exemple, createPayload.entities.properties.hs_pipeline_stage = "3".

    4. Remplacez la valeur de l’attribut createPayload.entities.properties.hs_ticket_priority par LOW, MEDIUM ou HIGH.

  6. Changez la valeur de l'attribut createPayload.pinnedRecord pour true ou false. Lorsqu'il est défini à true, l'enregistrement créé s'affiche aux agents dans la section Interactions actuelle de la carte client. Lorsqu'il est défini à false, il s'affiche dans la section Interactions récentes de la carte client. Si vous n'incluez pas cet attribut dans la charge utile, il sera présumé être false.
  7. Changez la valeur de l'attribut createPayload.screenPop pour true ou false. Lorsqu'il est défini à true, l'enregistrement créé apparaît automatiquement à l'agent sous forme de fenêtre contextuelle dans HubSpot. Lorsqu'il est défini à false, ce n'est pas le cas. Si vous n'incluez pas cet attribut dans la charge utile, il sera présumé être false.

  8. Modifiez les valeurs des attributs item1.

    1. Changez la valeur de l'attribut item1.relatedObjectType pour l'API de l'enregistrement que vous voulez connecter à ce flux de travail. Par exemple, item1.relatedObjectType = "companies". La valeur est sensible à la casse.

      Enregistrement

      API

      		 Peut être lié
      Entreprise (Company) companies Oui
      Contact contacts Oui
      Ticket tickets Oui

    2. Changez la valeur de l'attribut item1.relatedObjectId pour le numéro d'ID de l'enregistrement que vous voulez connecter à ce flux de travail. Par exemple, item1.relatedObjectId = "19019671367".

  9. Cliquez sur l'action Workflow Execute qui suit le SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action à {createTicketJson}. Assurez-vous d'inclure les accolades.

  10. Enregistrez votre script.

  11. Vous pouvez tester votre script en simulant une interaction dans Studio.

Épingler les enregistrements

Vous pouvez épingler un enregistrement à la Section Interaction actuelle de la fiche client. Lorsqu'un enregistrement est épinglé, il est lié icon of a check mark in a green box. par défaut pour la mémorialisation des données et les informations de chronologie. Cela signifie que la mémorialisation des données et les informations de chronologie seront ajoutées à l'enregistrement HubSpot lorsque l'interaction sera terminée. Si l'agent ne souhaite pas que les informations soient mappées, il peut Dissocier l'enregistrement.

  1. Ouvrez l'action Extrait de code le Flux de travail de création SNIPPET dans votre script.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[RecordType]Payload :

    						
createPayload.pinnedRecord = "true"

  3. Assurez-vous que createPayload correspond aux lignes précédentes de votre flux de travail.

  4. Enregistrez votre script.

Configurer les enregistrements pour le ScreenPop

Vous pouvez configurer les enregistrements pour qu'ils apparaissent automatiquement comme montées de fiche-client dans HubSpot. Pour ce faire, modifiez la charge utile du flux de travail.

Dans les Flux de travail de recherche

Par défaut, les enregistrements à jumelage uniqueClosed Se produit lorsqu’un flux de travail de recherche renvoie un seul enregistrement. apparaissent comme montées de fiche-client. Vous pouvez modifier ce comportement en définissant l'attribut screenPop à false.

Les enregistrements de jumelage Multiple n'apparaissent pas comme montées de fiche-client, même si vous définissez l'attribut screenPop à true.

  1. Ouvrez l'action SNIPPET du flux de travail dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant ASSIGN searchJson = "{searchInput.asjson()}" :

    						
searchPayload.screenPop = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que searchPayload correspond aux lignes précédentes de votre flux de travail.

    2. Modifiez la valeur de l'attribut screenPop :

      • Définissez-la à true pour afficher l'enregistrement comme montée de fiche-client.

      • Définissez-la à false pour ne pas l'afficher.

  4. Enregistrez votre script.

Dans les Flux de travail de création

Par défaut, les enregistrements créés n'apparaissent pas comme montées de fiche-client. Vous pouvez modifier ce comportement en définissant l'attribut screenPop à true.

  1. Ouvrez l'action SNIPPET du flux de travail dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[ObjectName]Payload:

    						
createPayload.screenPop = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que createPayload correspond aux lignes précédentes de votre flux de travail.

    2. Modifiez la valeur de l’attribut screenPop :

      • Réglez-le à true pour afficher l’enregistrement sous forme de montée de fiche-client.

      • Réglez-le à false pour ne pas l’afficher.

  4. Enregistrez votre script.

Configurer la mise en cache du Flux de travail

Vous pouvez déterminer si les résultats des flux de travail Search et Create sont mis en cache. Pour ce faire, vous devez modifier la charge utile du flux de travail. Lorsque les résultats sont mis en cache, ils s’affichent dans la fiche client de l’application Agent.

Dans les Flux de travail Search

Par défaut, les résultats du flux de travail Search sont mis en cache. Vous pouvez modifier ce comportement en définissant l’attribut cacheResponse à false. Les enregistrements retournés ne s’afficheront pas dans l’application Agent.

  1. Ouvrez l’action SNIPPET du flux de travail dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant ASSIGN searchJson = "{searchInput.asjson()}" :

    						
searchPayload.cacheResponse = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que searchPayload correspond aux lignes précédentes de votre flux de travail.

    2. Modifiez la valeur de l’attribut cacheResponse :

      • Définissez-la à true pour mettre en cache les résultats du flux de travail.

      • Définissez-la à false pour ne pas les mettre en cache.

  4. Enregistrez votre script.

Dans les Flux de travail Create

Par défaut, les résultats du flux de travail Create sont mis en cache. Vous pouvez modifier ce comportement en définissant l’attribut cacheResponse à false. Les enregistrements créés ne s’afficheront pas dans l’application Agent.

  1. Ouvrez l’action SNIPPET du flux de travail dans votre script.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[ObjectName]Payload:

    						
createPayload.cacheResponse = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que createPayload correspond aux lignes précédentes de votre flux de travail.

    2. Modifiez la valeur de l’attribut cacheResponse :

      • Définissez-le à true pour mettre en cache les résultats du flux de travail.

      • Définissez-le à false pour ne pas les mettre en cache.

  4. Enregistrez votre script.