Créez une configuration CRM pour HubSpot

Cette page explique comment créer une configuration CRM pour HubSpot. Ceci est terminé dans NiCE CXone. La configuration connecte HubSpot à NiCE CXone Agent Workspace (Browser Extension) (Agent Integrated). 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émorialisation des données et le mappage des données dynamiques peuvent nécessiter 9 à 15 secondes pour s'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 donner :

  • 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 tard 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'applications Icon of three-by-three grid of white squares on a blue background 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 le menu déroulant Sélectionner une région, sélectionnez la région à laquelle vous souhaitez connecter cette configuration CRM : AMERICAS, APAC (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 inclut la réauthentification, la recréation de la mémorialisation des données et des mappages de données dynamiques, ainsi que la reconfiguration des 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 configuration CRM. Ne réutilisez pas les comptes.

    Si des comptes sont déjà 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 aucun compte n'est répertorié, cliquez sur New authentication. Configurez les champs qui apparaissent :

    1. Pour modifier le nom de l'authentification, modifiez Your authentication name.
    2. Pour pouvoir gérer les paramètres de cette intégration dans HubSpot, entrez 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 de la page. Dans la fenêtre contextuelle qui apparaît, cliquez sur Show key. Copiez et collez la clé dans le champ Developer API key.
    3. Entrez 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 la configuration de Agent Workspace (Browser Extension) (Agent Integrated). Sur la page de détails de cette application, cliquez sur Show token. Copiez et collez le jeton dans le champ Private app access token.
    4. Cliquez sur Create.
    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 vous demander d'autoriser NiCE à se connecter à votre compte HubSpot, cliquez sur Allow.

  8. Cliquez sur Prochain.
  9. Dans le champ external_screenpop_domain_hs, entrée 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 Save dans le coin supérieur droit de Intégrations d’agents.

Créer des mappages de Mémorialisation 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 de Agent Workspace (Browser Extension) (Agent Integrated) d'être inséré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 Name HubSpot, Name 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 son temps de ACWClosed State that allows an agent to complete work requirements after finishing an interaction., si cela est configuré. Pour les interactions numériquesClosed Any channel, contact, or skill associated with Digital Experience (DX)., elle a lieu lorsque l'agent transfère l'interaction ou lorsqu'il annule l'assignation et la ferme lui-même. Si le contactClosed The person interacting with an agent, IVR, or bot in your contact center. termine l'interaction en premier, la mémorialisation des données n'a pas lieu pour les statuts, les dispositions, les notes et les balises. Toutefois, toutes les autres mémorialisations de données configurées seront mappées sur l'enregistrement 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'applications Icon of three-by-three grid of white squares on a blue background 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 Agent Workspace (Browser Extension) (Agent Integrated).

    Si vous souhaitez mapper la transcription complète d'une interaction, sélectionnez un champ d'enregistrement avec un formatage approprié et une limite de caractères suffisamment grande. Si le champ ne répond pas à ces exigences, seule une partie de la transcription est affichée, voire 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 les mappages de données inutiles pour les enregistrements dans une interaction. Les actions Studio peuvent ensuite être ajoutées aux mappages vocaux 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é.

    Si vous avez sélectionné Variable de script dans la liste déroulante Sélectionner un canal, entrez la variable de script dans le champ CXone Data. Vous devez l’entrer en lettres minuscules, même si vous utilisez la notation camelCase dans le script pour définir la variable.

  10. Pour ajouter d'autres champs de données, cliquez sur Ajouter un champ.
  11. Pour configurer les mappages pour 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 de Mappage des données Dynamiques

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 (Browser Extension) (Agent Integrated). 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 avec un type de données autre que 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'applications Icon of three-by-three grid of white squares on a blue background 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 sélectionner le type d’Entité, sélectionnez le type d’enregistrement HubSpot comportant les champs que vous souhaitez afficher dans Agent Workspace (Browser Extension) (Agent Integrated).

  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 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. Elle apparaît lorsque vous sélectionnez Rechercher dans la liste déroulante Actions de l'assistant de l'action.

L'étape suivante de l'intégration de HubSpot à Agent Workspace (Browser Extension) (Agent Integrated) consiste à modifier votre script Studio.