Création d’une configuration CRM pour HubSpot

Il s’agit de la première étape d’intégration de HubSpot avec Agent Workspace (Agent).

Cette page explique comment créer une configuration CRMClosed systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de soutien et les historiques de cas. pour HubSpot. Cela se fait dans NiCE CXone. La configuration connecte HubSpot à NiCE CXone Agent Workspace (Agent). Elle permet aux deux de partager les données au moyen de la mémorisation des données et du mappage dynamique de données.

Lorsqu'un jeton d'authentification CRM expire, il faut 9 à 15 secondes pour en générer un nouveau. Cela signifie que la mémorisation des données et le mappage dynamique des données peuvent prendre de 9 à 15 secondes à exécuter, en particulier lors de la première interaction de la journée.

Effectuez chacune de ces tâches dans l'ordre indiqué.

Création d’une nouvelle configuration CRM dans NiCE CXone

Autorisations requises : Configurations Créer

Fournissez à NiCE CXone les informations nécessaires pour la connexion à HubSpot.

Si le compte utilisateur HubSpot qui a créé la configuration CRM est supprimé ou désactivé, la configuration CRM sera également supprimée. Évitez cela en créant un compte utilisateur dans HubSpot, spécifiquement destiné à la configuration de NiCE CXone. Il s'agit de l'utilisateur du système. Il est recommandé d'accorder à l'utilisateur du système des privilèges d'administrateur. Si vous ne souhaitez pas accorder à l'utilisateur du système des privilèges d'administrateur, vous devez lui attribuer :

  • Accès en lecture à tous les enregistrements et champs de l'entité HubSpot.

  • Accès en lecture/Écriture à tous les enregistrements d'entité HubSpot qui seront consultés ou mis à jour dans les flux de travail que vous avez configurés, y compris les flux de travail de recherche, les flux de travail de création et la mémorialisation des données.

Les flux de travail que vous configurez plus loin dans ce processus utilisent les rôles et autorisations de l'utilisateur du système. Lorsque des enregistrements sont créés ou mis à jour, ils utilisent le nom et le fuseau horaire de l'utilisateur du système.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Intégrations d’agents Icône d’engrenage orange avec trois flèches à l’intérieur > Configurations.
  2. Cliquez sur nouvelle configuration CRM.
  3. Dans la liste déroulante Sélectionner une région, sélectionnez la région à laquelle vous souhaitez que cette configuration CRM soit connectée : AMERICAS, Asie-Pacifique ou EMEA.

    Vous ne pouvez pas modifier cette région ultérieurement. Si vous souhaitez déplacer une configuration CRM d'une région à une autre, vous devez créer une nouvelle configuration CRM. Cela implique de réauthentifier, de recréer les mappages de mémorialisation des données et de données dynamiques, et de reconfigurer les actions WORKFLOW EXECUTE et AGENT WORKFLOW CONFIGURATION dans votre script Studio.

  4. Sélectionnez HubSpot dans la liste déroulante Type d'Intégration.
  5. Entrée un Nom de la configuration. Vous pouvez rédiger une Description.
  6. Cliquez sur Authentifier.
  7. Dans la fenêtre contextuelle Authentification, sélectionnez l’un des comptes authentifiés figurant dans la liste, si vous les avez.

    Chaque compte HubSpot doit être utilisé pour authentifier une seule configuration CRM. Ne réutilisez pas les comptes.

    Si vous avez des comptes répertoriés, mais que vous souhaitez en créer un nouveau, faites défiler jusqu'à la fin de la liste déroulante et cliquez sur Add a new account. Si vous n'avez aucun compte répertorié, cliquez sur New authentication. Configurez les champs qui apparaissent :

    1. Pour changer le nom de l'authentification, modifiez Your authentication name.
    2. Pour pouvoir gérer les paramètres de cette intégration dans HubSpot, saisissez votre Developer API key. Pour le trouver, ouvrez votre compte développeur HubSpot et accédez au tableau de bord Applications. Cliquez sur Get HubSpot API key en haut. Dans la fenêtre contextuelle qui apparaît, cliquez sur Afficher la clé. Copiez et collez la clé dans le champ Developer API key.
    3. Saisissez votre Private app access token. Pour le trouver, ouvrez HubSpot et accédez à l'application privée Box with arrow indicating navigation to external site. que vous avez créée pour Agent Workspace (Agent). Sur la page des détails de cette application, cliquez sur Afficher le jeton. Copiez et collez le jeton dans le champ Private app access token.
    4. Cliquez sur Créer.
    5. Si vous ne l'avez pas déjà fait, connectez-vous à HubSpot avec le compte utilisateur du système que vous avez créé spécifiquement pour la configuration de NiCE CXone. Si vous êtes déjà connecté à HubSpot, assurez-vous d'être connecté avec le compte utilisateur du système.
    6. Si une fenêtre de HubSpot apparaît pour demander d'autoriser NiCE à se connecter à votre compte HubSpot, cliquez sur Autoriser.

  8. Cliquez sur Prochain.
  9. Dans le champ external_screenpop_domain_hs, entrez votre sous-domaine HubSpot. Pour le trouver, ouvrez votre instance de HubSpot et copiez-collez l’URL qui se trouve dans la barre d’adresse de votre navigateur. Vous avez uniquement besoin de l’URL jusqu’à .com. Par exemple : https://ven12345.hubspot.com.
  10. Dans le champ account_id, entrez votre Hub ID. Il doit s'agir de l'identifiant Hub d'un compte d’administrateur.
  11. Cliquez sur Terminer. Un message indiquant que l'authentification est active s'affiche dans le coin inférieur droit.
  12. Cliquez sur enregistrer dans le coin supérieur droit d’Intégrations d’agents.

Créer des mappages de mémorisation des données

Autorisations requises : Configurations - Modifier ; Mémorisation des données - Créer

Les mappages de mémorialisation des données permettent aux données issues de Agent Workspace (Agent) d'être automatiquement renseignées dans les enregistrements HubSpot. Dans ces mappages, vous sélectionnez le champ de données NiCE CXone à mapper à chaque champ d'enregistrement HubSpot. Par exemple, si vous mappez le champ de données Nom du client NiCE CXone au champ d'enregistrement nom HubSpot, nom affiche la valeur de Nom du client. Seul le texte est mappé ; les pièces jointes, les images et les notes ne peuvent pas être mappées. Actuellement, vous pouvez configurer des mappages de données pour les types d'entité CRM standard.

Pour les interactions vocales, la mémorialisation des données a lieu lorsque l'appel se termine et que l'agent termine la période de ACWClosed état qui permet à un agent de remplir les exigences de travail après avoir terminé une interaction., si cela est configuré. Pour les interactions numériquesClosed Tout canal, contact ou compétence associé à Digital Experience (DX)., cela se produit lorsque l'agent transfère l'interaction ou lorsqu'il choisit annuler l'assignation & Fermer pour lui-même. Si le contactClosed La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels. met fin à l'interaction en premier, la mémorialisation des données ne se produit pas pour les statuts, les dispositions, les notes et les balises. Cependant, toutes les autres mémorialisations de données configurées seront mappées à l'enregistrement du CRM.

  1. Si vous ne l’avez pas déjà fait, ouvrez une configuration CRM pour HubSpot. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Intégrations d’agents icon: an orange gear with three arrows inside. > Configurations. Sélectionnez une configuration CRM dans la liste.
  2. Cliquez sur l'onglet Mémorisation des données.
  3. Cliquez sur nouveau mappage de données.
  4. Entrez un nom pour le mappage. Vous pouvez aussi entrer une Description si vous le souhaitez.
  5. Dans la liste déroulante sélectionner le type d’Entité, sélectionnez le type d’enregistrement HubSpot pour lequel vous souhaitez créer des mappages de champs.

  6. Cliquez sur ajouter l’Entité.
  7. Dans la liste déroulante Champ CRM Externe qui s'affiche, sélectionnez le champ d'enregistrement HubSpot à partir duquel vous souhaitez recevoir des données de Agent Workspace (Agent).

    Si vous souhaitez mapper la transcription complète d'une interaction, sélectionnez un champ d'enregistrement avec une mise en forme appropriée et une limite de caractères suffisamment grande. Si le champ ne répond pas à ces exigences, seule une partie de la transcription s'affiche, ou aucune, selon le CRM.

  8. Dans la liste déroulante Sélectionner un canal, sélectionnez le type de données NiCE CXone que vous souhaitez mapper au champ d'enregistrement HubSpot que vous avez sélectionné.

    Nous vous recommandons de créer deux mappages distincts pour la voix et digital channels sur chaque nouveau canal que vous créez. Cela permet d'éviter des mappages de données inutiles pour les enregistrements d'une interaction. Les actions Studio peuvent ensuite être ajoutées aux mappages voix ou numériques.

  9. Dans la liste déroulante NiCE CXone Data, sélectionnez le champ de données NiCE CXone que vous souhaitez mapper au champ d'enregistrement HubSpot que vous avez sélectionné.

    If you selected Script Variable in the Select Channel drop-down, enter the script variable in the CXone Data field. You must enter it in lowercase, even if you used camel case in the script to define the variable.

  10. Pour ajouter d’autres champs de données, cliquez sur Ajouter un champ.
  11. Pour configurer les mappages d’un autre type d’enregistrement HubSpot, sélectionnez un type d’enregistrement différent dans la liste déroulante sélectionner le type d’Entité et cliquez sur Ajouter une entité.
  12. Cliquez sur enregistrer en haut de la page. Le mappage de données actif s’affiche dans l’onglet Mémorisation des données.

    Dans la tâche suivante de ce processus, sélectionnez ce mappage des données dans l'action AGENT WORKFLOW CONFIGURATION de votre script Studio. Elle apparaît lorsque vous sélectionnez Mémorialisation des données dans la liste déroulante Actions de l'assistant de l'action.

Créer des mappages dynamiques de mappage des données

Autorisations requises : Configurations - Modifier ; Données dynamiques - Créer

Les mappages de données dynamiques vous permettent de choisir quels champs d'enregistrement HubSpot apparaissent dans Agent Workspace (Agent). Vous pouvez configurer des mappages de données dynamiques pour les types d'enregistrement standard HubSpot récupérés par les flux de travail de recherche. Vous pouvez également les configurer pour les enregistrements personnalisés créés par les flux de travail de création personnalisée. Pour chaque type d'enregistrement, vous pouvez ajouter jusqu'à dix champs de type chaîne. Vous pouvez ajouter jusqu'à trois champs dont le type de données n'est pas chaîne.

  1. Si vous ne l'avez pas déjà fait, ouvrez une configuration CRM pour HubSpot. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Intégrations d’agents icon: an orange gear with three arrows inside. > Configurations. Sélectionnez une configuration CRM dans la liste.
  2. Cliquez sur l’onglet Données dynamiques.
  3. Cliquez sur nouveau mappage de données.
  4. Entrez un nom pour le mappage. Vous pouvez aussi entrer une Description si vous le souhaitez.
  5. Dans la liste déroulante Type d’entité, sélectionnez le type d’enregistrement HubSpot contenant les champs que vous souhaitez afficher dans Agent Workspace (Agent).

  6. Cliquez sur ajouter l’Entité.
  7. Dans la liste déroulante Champ CRM Externe qui apparaît, sélectionnez le champ d'enregistrement HubSpot que vous souhaitez afficher aux agents.

  8. Pour ajouter d’autres champs d’enregistrement HubSpot, cliquez sur Ajouter un champ. Vous pouvez ajouter jusqu’à cinq champs par type d’enregistrement.
  9. Cliquez sur enregistrer en haut de la page. Le mappage de données dynamiques actif s’affiche dans l’onglet Données dynamiques.

    Dans la tâche suivante de ce processus, sélectionnez ce mappage des données dynamiques dans l'action AGENT WORKFLOW CONFIGURATION de votre script Studio. Il apparaît lorsque vous sélectionnez Search dans la liste déroulante Actions de l'assistant de l'action.

L’étape suivante d’intégration de HubSpot avec Agent Workspace (Agent) consiste à modifier votre Studio script.