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 effectuer cette tâche à l'aide de l'Action Studio ENHANCED WORKFLOW EXECUTE à la place. Vous pouvez également, si vous le souhaitez, permettre aux agents de créer manuellement des enregistrements.

Vous pouvez configurer les flux de travail Search, Custom Create et Standard Create 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 back-end de mappage des données dynamiques.

La personnalisation de la chronologie n’est pas prise en charge pour HubSpot.

Type de Workflow

 Description

Flux de travail
Recherche Les flux de travail de recherche analysent HubSpot à la recherche d'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. Rechercher un ANI
Recherche personnalisée
Création personnalisée Les flux de travail de création personnalisée permettent de créer le type d’enregistrement voulu depuis les champs standard et personnalisés. Personnaliser Créer
Créer Standard

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

 Créer une Société
Créer un contact
Créer un Ticket
Créer un ticket avec association

Les flux de travail s'exécutent en utilisant les 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 de workflow CRM, et la liste de terminologie d'intégration CRM.

Par ailleurs, téléchargez ce dossier de modèles de scripts. 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 travail de recherche : Recherche d'ANI et Recherche personnalisée.

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

  • Correspondent aux critères de recherche, et

  • Comporter 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 correspondant aux critères de recherche.

Configurer le Flux de travail Recherche d’ANI

Vous pouvez configurer le flux de travail Rechercher ANI pour les appels téléphoniques et les e-mails.

Ne faites pas figurer la propriété timeoutMilliSec dans votre code de workflow. Cela peut entraîner la livraison de plusieurs fois la même interaction à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Rechercher via ANI.

  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. Pour configurer le flux de travail Rechercher ANI pour les appels téléphoniques, copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

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

  5. Pour configurer le flux de travail Rechercher ANI pour les e-mails, copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre É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 Workflow Recherche personnalisée

Le workflow Custom Search vous permet de rechercher un ou plusieurs enregistrements HubSpot. Ils permettent également de rechercher plusieurs champs et variables dans un enregistrement spécifique. Vous pouvez associer plusieurs critères de recherche en utilisant les opérateurs HubSpot.

Ce flux de travail prend en charge les enregistrements HubSpot suivants :

  • Société
  • Contacter
  • Ticket (avec ou sans enregistrements associés)

Ne faites pas figurer la propriété timeoutMilliSec dans votre code de workflow. Cela peut entraîner la livraison de plusieurs fois la même interaction à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Custom Search.

  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 texte de la fenêtre É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 les valeurs des attributs filters1 et filters2.

    1. Remplacez les valeurs des attributs filters1.propertyName et filters2.propertyName par les noms des champs à 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, est disponible dans la documentation HubSpot relative aux enregistrements :

    2. Remplacez les valeurs des attributs filters1.operator et filters2.operator par les opérateurs HubSpot à utiliser. Une liste complète des opérateurs HubSpot est disponible dans la documentation HubSpot Boîte avec flèche indiquant une navigation vers un site externe.. Ces noms sont sensibles à la casse.

    3. Remplacez les valeurs des attributs filters1.value et filters2.value par les valeurs à affecter aux champs. Par exemple, filters1.value = "Account invalid Login".

  6. Remplacez les valeurs des attributs sort1.

    1. Modifiez la valeur de l'attribut sort1.propertyName pour indiquer le champ que vous souhaitez 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 par le nom API de l'enregistrement que vous souhaitez rechercher. Par exemple, searchArray[1].entity = "company". Ces noms sont sensibles à la casse.

    Record

    API

    		 Liable
    Société company Oui
    Contact contact Oui
    Ticket ticket Oui

  8. Enregistrez votre script.

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

Configurer les 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 permettent également de remplir n'importe quel type DE champ, Standard ou personnalisé. Par exemple, vous pouvez créer l’enregistrement Entreprise avec une partie des champs standard de ce type d’enregistrement, ainsi que vos propres champs personnalisés.

Il s’agit de la méthode recommandée pour créer des enregistrements HubSpot

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

Le workflow Custom Create crée tout type de HubSpot enregistrement, standard ou personnalisé. Cet enregistrement permet d’afficher des champs de données standard 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 devez disposer de cet outil pour créer des enregistrements HubSpot personnalisés.

  2. Utilisez cette documentation HubSpot Carré avec une flèche indiquant que le lien mène à un site externe. pour créer un enregistrement personnalisé, ou objet, dans HubSpot.

  3. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Custom Create.

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

  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 texte de la fenêtre É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". Ces noms sont sensibles à la casse.

    Record

    API

    		 Liable
    Société companies Oui
    Contact contacts Oui
    Ticket tickets Oui

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

  9. Remplacez les valeurs des attributs createPayload.entities.properties par les valeurs à affecter aux champs. Par exemple, createPayload.entities.properties.accountNumber = "12345".

  10. Modifiez la valeur de l'attribut createPayload.pinnedRecord sur true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche aux agents dans la Section Interactions actuelle 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.
  11. Remplacez la valeur de l'attribut createPayload.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans HubSpot. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera supposé être false.

  12. Remplacez toutes les instances de [ObjectName] dans les trois dernières lignes du code par le nom de l'enregistrement que vous avez créé. Mettez en majuscule le nom pour qu'il corresponde à la casse mixte (camel case) de l'attribut. Par exemple, si le nom de l'enregistrement que vous avez créé est account, votre code doit être :

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

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

  14. Enregistrez votre script.

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

Configurer les 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 de 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 souhaités, utilisez le Custom Create workflow.

Configurer le Workflow Créer une Société

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Société.

  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 texte de la fenêtre É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 souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur null (""). Par exemple, createPayload.entities.properties.city = "".

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

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

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

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

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

  6. Modifiez la valeur de l'attribut createPayload.pinnedRecord sur true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelle de la carte client. Lorsqu'elle est définie sur 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 considéré comme étant false.
  7. Modifiez la valeur de l'attribut createPayload.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans HubSpot. Lorsque la valeur est définie sur false, il ne s’affiche pas. 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 l'élément SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createCompanyJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

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

Configurer le workflow Create Contact

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create 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-clic sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre É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 souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.entities.properties.email = "".

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

    1. Remplacez la valeur de l'attribut createPayload.entities.properties.firstName par le prénom du contact. Par exemple, createPayload.entities.properties.firstName = "Elinor".

    2. Remplacez la valeur de l'attribut createPayload.entities.properties.email par l'adresse courriel du contact. Par exemple, createPayload.entities.properties.email = "elinor.dashwood@classics.com".

    3. Remplacez la valeur de l'attribut createPayload.entities.properties.lastName par le nom du contact. Par exemple, createPayload.entities.properties.lastName = "Dashwood".

    4. Modifiez la valeur de l'attribut createPayload.entities.properties.phone par le numéro DE téléphone du contact. Par exemple, createPayload.entities.properties.phone = "1234567890".

  6. Modifiez la valeur de l'attribut createPayload.pinnedRecord sur true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche aux agents dans la section Interactions actuelle 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. Remplacez la valeur de l'attribut createPayload.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans HubSpot. Lorsque la valeur est définie sur false, il ne s’affiche pas. 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 sur {createContactJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

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

Configurer le Workflow de création de Ticket

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow 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-clic sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre É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 souhaitez 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.

    1. Remplacez la valeur de l'attribut createPayload.entities.properties.subject par l'objet du ticket : la raison de sa création. Par exemple, createPayload.entities.properties.subject = "Query about large book orders". Elle peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

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

    3. Remplacez la valeur de l'attribut createPayload.entities.properties.hs_pipeline_stage par 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. Modifiez la valeur de l'attribut createPayload.pinnedRecord par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la fiche client. Lorsque la valeur 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. Remplacez la valeur de l'attribut createPayload.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans HubSpot. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, la valeur false sera supposée.

  8. Cliquez sur l'action Workflow Execute qui suit l'action SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createTicketJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

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

Configuration du Flux de travail Créer un ticket avec association

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Ticket with Association.

  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 de script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre É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 souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur null (""). Par exemple, createPayload.entities.properties.hs_ticket_priority = "".

  5. Remplacez les valeurs des attributs createPayload.

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

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

    3. Remplacez la valeur de l'attribut createPayload.entities.properties.hs_pipeline_stage par 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 sur true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la fiche client. Lorsque la valeur 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 supposée.
  7. Modifiez la valeur de l'attribut createPayload.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans HubSpot. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false par défaut.

  8. Remplacez les valeurs des attributs item1.

    1. Remplacez la valeur de l'attribut item1.relatedObjectType par celle de l'API pour l'enregistrement auquel vous souhaitez connecter ce Workflow. Par exemple, item1.relatedObjectType = "companies". Ces noms sont sensibles à la casse.

      Record

      API

      		 Liable
      Société companies Oui
      Contact contacts Oui
      Ticket tickets Oui

    2. Remplacez la valeur de l'attribut item1.relatedObjectId par le numéro d'ID de l'enregistrement auquel vous souhaitez connecter ce workflow. 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 sur {createTicketJson}. Veillez à inclure les accolades.

  10. Enregistrez votre script.

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

Épingler les enregistrements

Vous pouvez épingler un enregistrement dans la section Current interaction de la fiche client. Lorsqu'un enregistrement est épinglé, il est lié icon of a check mark in a green box. par défaut, à des fins de mémorialisation des données et d'informations de chronologie. Cela signifie que la mémorialisation des données et les informations de chronologie seront ajoutées à l'enregistrement HubSpot une fois l'interaction terminée. Si l'Agent ne souhaite pas que les informations soient mappées, il peut dissocier l'enregistrement.

  1. Ouvrez l'action SNIPPET Snippet for Create Workflow 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. Make sure that createPayload matches the earlier lines in your workflow.

  4. Enregistrez votre script.

Configurer les enregistrements pour le Screen Pop

Vous pouvez configurer des enregistrements pour qu'ils s'affichent automatiquement sous forme de screen pops dans HubSpot. Cette opération s'effectue en modifiant la charge utile du workflow. Si vous utilisez Microsoft Dynamics CIF v2.0, uniquement un enregistrement peut apparaître comme fenêtre contextuelle. Si vous disposez de plusieurs enregistrements, seul le premier s’affiche. Les agents doivent cliquer sur les autres enregistrements dans la fiche client pour les ouvrir.

Rechercher dans les Flux de travail

Par défaut, les enregistrements à correspondance uniqueClosed Se produit lorsqu’un flux de travail de recherche renvoie un seul enregistrement. apparaissent sous forme de fenêtres contextuelles. Vous pouvez modifier ce comportement en définissant l'attribut screenPop sur false.

Les enregistrements de correspondance Multiple n'apparaissent pas sous forme de fenêtres contextuelles, même si vous définissez l'attribut screenPop sur true.

  1. Ouvrez l'action SNIPPET du Workflow 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 workflow.

    2. Modifier la valeur de l'attribut screenPop :

      • Définissez-le sur true pour afficher l'enregistrement sous forme de fenêtre contextuelle.

      • Définissez-le sur false pour ne pas l'afficher.

  4. Enregistrez votre script.

Dans Créer des Flux de travail

Par défaut, les enregistrements créés n'apparaissent pas sous forme de fenêtres contextuelles. Vous pouvez modifier ce comportement en définissant l'attribut screenPop sur true.

  1. Ouvrez l'action SNIPPET du workflow 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 workflow.

    2. Modifier la valeur de l'attribut screenPop :

      • Définissez-le sur true pour afficher l'enregistrement sous forme de fenêtre contextuelle.

      • Définissez-le sur false pour ne pas l'afficher.

  4. Enregistrez votre script.

Configurer la mise en cache de Workflow

Vous pouvez contrôler si les résultats du workflow Search et Create sont mis en cache. Pour ce faire, modifiez la charge utile du workflow. Lorsque les résultats sont mis en cache, ils apparaissent dans la fiche client dans l'application Agent.

Dans Rechercher des Flux de travail

Par défaut, les résultats du workflow de recherche sont mis en cache. Vous pouvez modifier ce comportement en définissant l'attribut cacheResponse sur false. Les enregistrements renvoyés n'apparaîtront pas dans l'application Agent.

  1. Ouvrez l'action SNIPPET du workflow 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 workflow.

    2. Modifier la valeur de l'attribut cacheResponse :

      • Définissez-le sur true pour mettre en cache les résultats du workflow.

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

  4. Enregistrez votre script.

Dans Créer des Flux de travail

Par défaut, les résultats du Workflow Create sont mis en cache. Vous pouvez modifier ce comportement en définissant l'attribut cacheResponse sur false. Les enregistrements créés n'apparaîtront pas dans l'application Agent.

  1. Ouvrez l'action SNIPPET du Workflow 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 workflow.

    2. Modifier la valeur de l'attribut cacheResponse :

      • Définissez-le sur true pour mettre en cache les résultats du workflow.

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

  4. Enregistrez votre script.