Recherches HubSpot

Vous pouvez configurer votre intégration HubSpot avec des recherches principales et secondaires, qui peuvent identifier un appelant en fonction de son enregistrement de contact ou de son profil d'entreprise. Si la recherche principale ne renvoie aucun résultat, le système tente la recherche secondaire. De plus, vous pouvez configurer les champs d'affichage du compte CRM de l'objet de recherche principal ou secondaire correspondant qui s'affichent dans l'adaptateur d'agent. Enfin, vous pouvez configurer les champs d'affichage de l'enregistrement CRM qui s'affichent dans l'adaptateur d'agent, que l'objet principal ou secondaire ait été mis en correspondance ou non. Les champs d'affichage de l'enregistrement s'appliquent à l'enregistrement CRM ouvert, par exemple un ticket ou une opportunité.

Configurez les champs d'affichage du compte CRM lorsque vous configurez l'objet de recherche principal et configurez l'objet de recherche secondaire. Pour configurer les champs d'affichage de l'enregistrement CRM, consultez Configurer les champs d'affichage de l'enregistrement CRM dans l'adaptateur d'agent.

Avant de commencer

Avant de commencer, intégrez HubSpot à votre instance Contact Center AI Platform (CCAI Platform). Pour en savoir plus, consultez HubSpot.

Configurer l'objet de recherche principal

Vous pouvez configurer l'objet de recherche principal, qui est le premier objet que le système recherche au début d'une session. Vous pouvez également configurer les champs d'affichage du compte CRM qui s'affichent dans l'adaptateur d'agent. La procédure suivante vous explique comment procéder.

Pour configurer l'objet de recherche principal et les champs d'affichage du compte CRM, procédez comme suit :

  1. Dans le portail CCAI Platform, cliquez sur Settings > Developer Settings (Paramètres > Paramètres du développeur). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.

  2. Dans le volet CRM, accédez à la section Account Lookup (Recherche de compte).

  3. Pour configurer l'objet de recherche principal, procédez comme suit :

    1. Développez la section Primary Lookup Object (Objet de recherche principal).

    2. Dans la liste Object Type (Type d'objet), sélectionnez le type d'objet à rechercher.

    3. Dans la liste Phone number lookup fields (Champs de recherche de numéro de téléphone), sélectionnez les champs que le système doit utiliser pour faire correspondre le numéro de téléphone de l'utilisateur final.

    4. Dans la liste Phone number primary field (Champ principal de numéro de téléphone), sélectionnez le champ dans lequel le numéro de téléphone d'un client est stocké lorsque le système crée un compte CRM.

    5. Pour Phone Number Format (Format de numéro de téléphone), sélectionnez le format de numéro de téléphone de la requête.

    6. Facultatif : Pour rechercher des utilisateurs finaux par champ personnalisé pour les sessions SDK, procédez comme suit :

      1. Cochez la case Mobile / Web SDKs: lookup users by custom field for SDK sessions (SDK pour mobile/Web : rechercher des utilisateurs par champ personnalisé pour les sessions SDK).

      2. Dans la liste Custom lookup field in CRM (Champ de recherche personnalisé dans le CRM), sélectionnez le champ de recherche personnalisé.

  4. Pour configurer les champs d'affichage du compte CRM dans l'adaptateur d'agent, procédez comme suit :

    1. Dans la section CRM Account Display Fields (Champs d'affichage du compte CRM), dans la liste Matched account display field (Champ d'affichage du compte correspondant), sélectionnez l'identifiant principal du compte.

    2. Facultatif : Pour afficher un deuxième champ, procédez comme suit :

      1. Cochez la case Display a second field (Afficher un deuxième champ).

      2. Dans la liste Second Display Field (Deuxième champ d'affichage), sélectionnez un deuxième type de champ à afficher.

      3. Pour Second field display position (Position d'affichage du deuxième champ), sélectionnez l'ordre d'affichage des champs dans l'adaptateur d'agent.

  5. Cliquez sur Save (Enregistrer).

Configurer l'objet de recherche secondaire

Vous pouvez configurer l'objet de recherche secondaire, qui sert de solution de repli si la recherche principale ne renvoie aucun résultat. Vous pouvez également configurer les champs d'affichage du compte CRM qui s'affichent dans l'adaptateur d'agent. La procédure suivante vous explique comment procéder.

Pour configurer l'objet de recherche secondaire et les champs d'affichage du compte CRM, procédez comme suit :

  1. Dans le portail CCAI Platform, cliquez sur Settings > Developer Settings (Paramètres > Paramètres du développeur). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.

  2. Dans le volet CRM, accédez à la section Account Lookup (Recherche de compte).

  3. Pour configurer l'objet de recherche secondaire, procédez comme suit :

    1. Cochez la case Secondary Lookup Object (Objet de recherche secondaire).

    2. Dans la liste Phone number lookup fields (Champs de recherche de numéro de téléphone), sélectionnez les champs que le système doit utiliser pour faire correspondre le numéro de téléphone de l'utilisateur final.

    3. Dans la liste Phone number primary field (Champ principal de numéro de téléphone), sélectionnez le champ dans lequel le numéro de téléphone d'un client est stocké lorsque CCAI Platform crée un compte CRM.

    4. Pour Phone Number Format (Format de numéro de téléphone), sélectionnez le format de numéro de téléphone de la requête.

    5. Facultatif : Pour rechercher des utilisateurs finaux par champ personnalisé pour les sessions SDK, procédez comme suit :

      1. Cochez la case Mobile / Web SDKs: lookup users by custom field for SDK sessions (SDK pour mobile/Web : rechercher des utilisateurs par champ personnalisé pour les sessions SDK).

      2. Dans la liste Custom lookup field in CRM (Champ de recherche personnalisé dans le CRM), sélectionnez le champ de recherche personnalisé.

  4. Pour configurer les champs d'affichage du compte CRM dans l'adaptateur d'agent, procédez comme suit :

    1. Dans la section CRM Account Display Fields (Champs d'affichage du compte CRM), dans la liste Matched account display field (Champ d'affichage du compte correspondant), sélectionnez l'identifiant principal du compte.

    2. Facultatif : Pour afficher un deuxième champ, procédez comme suit :

      1. Cochez la case Display a second field (Afficher un deuxième champ).

      2. Dans la liste Second Display Field (Deuxième champ d'affichage), sélectionnez un deuxième type de champ à afficher.

      3. Pour Second field display position (Position d'affichage du deuxième champ), sélectionnez l'ordre d'affichage des champs dans l'adaptateur d'agent.

  5. Cliquez sur Save (Enregistrer).

Configurer les champs d'affichage de l'enregistrement CRM dans l'adaptateur d'agent

Vous pouvez configurer les champs d'affichage de l'enregistrement CRM qui s'affichent dans l'adaptateur d'agent, que l'objet principal ou secondaire ait été mis en correspondance ou non. Pour configurer les champs d'affichage de l'agent CRM qui s'affichent dans l'adaptateur d'agent, consultez Configurer l'objet de recherche principal et Configurer l'objet de recherche secondaire.

Pour configurer les champs d'affichage de l'enregistrement CRM dans l'adaptateur d'agent, procédez comme suit :

  1. Dans le portail CCAI Platform, cliquez sur Settings > Developer Settings (Paramètres > Paramètres du développeur). Si le menu Settings (Paramètres) ne s'affiche pas, cliquez sur Menu.

  2. Dans le volet CRM, accédez à la section CRM Record Display Fields (Champs d'affichage de l'enregistrement CRM).

  3. Dans la liste Matched record display field (Champ d'affichage de l'enregistrement correspondant), sélectionnez l'identifiant principal de l'enregistrement.

  4. Facultatif : Pour afficher un deuxième champ, procédez comme suit :

    1. Cochez la case Display a second field (Afficher un deuxième champ).

    2. Dans la liste Second Display Field (Deuxième champ d'affichage), sélectionnez un deuxième type de champ à afficher.

  5. Facultatif : Pour afficher un troisième champ, procédez comme suit :

    1. Cochez la case Display a third field (Afficher un troisième champ).

    2. Dans la liste Third Display Field (Troisième champ d'affichage), sélectionnez un troisième type de champ à afficher.

  6. Cliquez sur Save (Enregistrer).

Logique en cascade de la recherche

Les informations suivantes expliquent la logique en cascade que CCAI Platform utilise pour les recherches d'objets :

  • Si contact_id est fourni, CCAI Platform effectue d'abord un appel GET direct. Sinon, CCAI Platform recherche les identifiants de téléphone, d'e-mail, de SDK et de SIP à l'aide de la logique OR.

  • Si plusieurs enregistrements correspondants sont trouvés, CCAI Platform sélectionne celui qui a été modifié le plus récemment. Les dates de modification sont déterminées comme suit :

    • Contact utilise lastmodifieddate.

    • Company (Entreprise) utilise hs_lastmodifieddate.