Partager via

Connecteur Salesforce CRM Microsoft Graph

  • Article

Le connecteur Salesforce Microsoft Graph permet à votre organization d’indexer des contacts, des opportunités, des prospects, des cas et des objets de comptes dans votre instance Salesforce. Après avoir configuré le connecteur et indexé le contenu à partir de Salesforce, les utilisateurs finaux peuvent rechercher ces éléments à partir de n’importe quel client Microsoft Search et Microsoft 365 Copilot.

Cet article est destiné aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Salesforce CRM Microsoft Graph.

Importante

Le connecteur Salesforce Microsoft Graph prend actuellement en charge l’été 19 ou une version ultérieure.

Fonctionnalités

  • Indexer les contacts, les opportunités, les prospects, les cas et les objets de comptes dans votre instance Salesforce
  • Filtrer le contenu de base ce que vous souhaitez indexer
  • Accéder aux données Salesforce CRM à l’aide de la puissance de la recherche sémantique
  • Conserver les listes de contrôle d’accès définies par votre organization
  • Personnaliser votre fréquence d’analyse
  • Créer des agents et des workflows à l’aide de cette connexion et de plug-ins à partir de Microsoft Copilot Studio

Limitations

  • Actuellement, le connecteur Salesforce Microsoft Graph ne prend pas en charge le partage basé sur Apex et basé sur un territoire à l’aide de groupes personnels de Salesforce.
  • Il existe un bogue connu dans l’API Salesforce que le connecteur utilise, où les valeurs par défaut privées à l’échelle de l’organisation pour les prospects ne sont pas respectées actuellement.
  • Si un champ a défini la sécurité au niveau du champ (FLS) pour un profil, le connecteur n’ingère pas ce champ pour les profils de cette organisation Salesforce. Par conséquent, les utilisateurs ne pourront pas rechercher des valeurs pour ces champs ou s’afficher dans les résultats.
  • Dans l’écran gérer le schéma, ces noms de propriétés standard courants sont répertoriés une fois, les options sont Requête, Recherche, Récupérer et Affiner, et s’appliquent à tout ou aucun.
    • Nom
    • Url
    • Description
    • Fax
    • Phone
    • MobilePhone
    • E-mail
    • Type
    • Titre
    • AccountId
    • AccountName
    • AccountUrl
    • AccountOwner
    • AccountOwnerUrl
    • Propriétaire
    • OwnerUrl
    • CreatedBy
    • CreatedByUrl
    • LastModifiedBy
    • LastModifiedByUrl
    • LastModifiedDate
    • ObjectName

Configuration requise

Pour vous connecter à votre instance Salesforce, vous avez besoin de votre URL de instance Salesforce, de l’ID client et de la clé secrète client pour l’authentification OAuth. Les étapes suivantes expliquent comment vous ou votre administrateur Salesforce pouvez obtenir ces informations à partir de votre compte Salesforce :

  • Connectez-vous à votre instance Salesforce et accédez à Configuration

  • Accédez à Applications -> Gestionnaire d’applications.

  • Sélectionnez Nouvelle application connectée.

  • Complétez la section API comme suit :

    • Cochez la case Activer les paramètres Oauth.

    • Spécifiez l’URL de rappel comme suit : Pour M365 Entreprise : https://gcs.office.com/v1.0/admin/oauth/callback, pour M365 Government : https://gcsgcc.office.com/v1.0/admin/oauth/callback

    • Sélectionnez les étendues OAuth requises.

      • Accéder à vos données (API) et les gérer.

      • Effectuez des demandes en votre nom à tout moment (refresh_token, offline_access).

    • Cochez la case Exiger un secret pour le flux de serveur web.

    • Enregistrez l’application.

      La section API de Salesforce instance une fois que l’administrateur a entré toutes les configurations requises répertoriées ci-dessus.

  • Copiez la clé du consommateur et la clé secrète du consommateur. Ces informations sont utilisées comme ID client et clé secrète client lorsque vous configurez les paramètres de connexion de votre connecteur Salesforce Microsoft Graph dans le portail d’administration Microsoft 365.

    Les résultats retournés par la section API dans Salesforce instance une fois que l’administrateur a soumis toutes les configurations requises. La clé de consommateur se trouve en haut de la colonne de gauche et la clé secrète du consommateur se trouve en haut de la colonne de droite.

  • Avant de fermer votre instance Salesforce, procédez comme suit pour vous assurer que les jetons d’actualisation n’expirent pas :

    • Accédez à Applications -> Gestionnaire d’applications.
    • Recherchez l’application que vous avez créée et sélectionnez la liste déroulante à droite. Sélectionnez Gérer.
    • Sélectionnez Modifier les stratégies.
    • Pour la stratégie de jeton d’actualisation, sélectionnez Le jeton d’actualisation est valide jusqu’à ce qu’il soit révoqué.

    Sélectionnez la stratégie de jeton d’actualisation nommée « Le jeton d’actualisation est valide jusqu’à ce qu’il soit révoqué ».

Vous pouvez maintenant utiliser le Centre Administration Microsoft 365 pour terminer le reste du processus de configuration de votre connecteur Microsoft Graph.

Prise en main

Capture d’écran montrant l’écran de création de connexion pour le connecteur Microsoft Graph pour Salesforce CRM.

1. Nom d’affichage

Un nom d’affichage est utilisé pour identifier chaque référence dans Copilot, ce qui permet aux utilisateurs de reconnaître facilement le fichier ou l’élément associé. Le nom d’affichage indique également le contenu approuvé. Le nom d’affichage est également utilisé comme filtre de source de contenu. Une valeur par défaut est présente pour ce champ, mais vous pouvez la personnaliser avec un nom que les utilisateurs de votre organization reconnaître.

2. URL Salesforce CRM

Pour l’URL de l’instance, utilisez https://[domaine].my.salesforce.com où le domaine serait le domaine Salesforce pour votre organization.

3. Type d’authentification

Pour authentifier et synchroniser le contenu de Salesforce CRM, choisissez OAuth 2.0. Entrez l’ID client et la clé secrète client que vous avez obtenus auprès de votre instance Salesforce, puis sélectionnez Autoriser.

La première fois que vous avez tenté de vous connecter avec ces paramètres, vous obtenez une fenêtre contextuelle vous demandant de vous connecter à Salesforce avec votre nom d’utilisateur et votre mot de passe d’administrateur. La capture d’écran ci-dessous montre la fenêtre contextuelle. Entrez vos informations d’identification, puis sélectionnez « Se connecter ».

Fenêtre contextuelle de connexion demandant le nom d’utilisateur et le mot de passe.

Remarque

  • Si la fenêtre contextuelle n’apparaît pas, elle peut être bloquée dans votre navigateur. Vous devez donc autoriser les fenêtres contextuelles et les redirections.
  • Vérifiez que le compte Salesforce utilisé pour se connecter au connecteur Graph est identique à celui de l’utilisateur déjà connecté à Salesforce.
  • Vérifiez que l’utilisateur qui se connecte dispose de toutes les autorisations d’objet nécessaires pour l’organization.

Vérifiez que la connexion a réussi en recherchant une coche verte qui affiche les informations d’identification correctes, comme illustré dans la capture d’écran ci-dessous.

Capture d’écran de la connexion réussie. La bannière verte indiquant « Connexion réussie » se trouve sous le champ de l’URL de votre instance Salesforce.

4. Déployer pour un public limité

Déployez cette connexion sur une base d’utilisateurs limitée si vous souhaitez la valider dans Copilot et d’autres surfaces de recherche avant d’étendre le déploiement à un public plus large. Pour en savoir plus sur le déploiement limité, consultez Déploiement intermédiaire.

À ce stade, vous êtes prêt à créer la connexion pour Salesforce CRM. Vous pouvez cliquer sur Créer pour publier votre connexion et indexer le contenu de votre instance Salesforce.

Pour d’autres paramètres, tels que les autorisations d’accès, lesrègles d’inclusion des données, le schéma, la fréquence d’analyse, etc., nous avons des valeurs par défaut basées sur ce qui fonctionne le mieux avec les données Jira. Vous pouvez voir les valeurs par défaut ci-dessous :

Utilisateurs Description
Autorisations d’accès Uniquement les personnes ayant accès au contenu dans la source de données.
Mapper des identités Identités de source de données mappées à l’aide d’ID de Microsoft Entra.
Contenu Description
Objets Salesforce Tous les objets sont indexés.
Filtrer les données Tous les objets sont indexés. Aucun filtre de temps ou critère SOQL n’est appliqué.
Gérer les propriétés Pour case activée propriétés par défaut et leur schéma, consultez le contenu.
Synchronisation Description
Analyse incrémentielle Fréquence : toutes les 15 minutes
Analyse complète Fréquence : Tous les jours

Si vous souhaitez modifier l’une de ces valeurs, vous devez choisir l’option « Configuration personnalisée ».

Configuration personnalisée

L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut des paramètres répertoriés dans le tableau ci-dessus. Une fois que vous avez cliqué sur l’option « Configuration personnalisée », trois onglets supplémentaires s’affichent : Utilisateurs, Contenu et Synchronisation.

Utilisateurs

Capture d’écran montrant l’onglet Utilisateurs dans lequel vous pouvez configurer des autorisations d’accès et des règles de mappage d’utilisateurs.

Autorisations d’accès

Le connecteur Salesforce CRM prend en charge les autorisations de recherche visibles pour tout le monde ou uniquement pour les personnes ayant accès à cette source de données. Si vous choisissez Tout le monde, les données indexées apparaissent dans les résultats de la recherche pour tous les utilisateurs. Si vous choisissez Uniquement les personnes ayant accès à cette source de données, les données indexées apparaissent dans les résultats de la recherche pour les utilisateurs qui y ont accès. Choisissez celle qui convient le mieux à votre organization.

Mappage des identités

Vous pouvez choisir d’ingérer des Access Control Listes (ACL) à partir de votre instance Salesforce ou d’autoriser tous les membres de votre organization à voir les résultats de la recherche à partir de cette source de données. Les listes de contrôle d’accès peuvent inclure des identités Microsoft Entra (utilisateurs fédérés de Microsoft Entra ID vers Salesforce), des identités non Azure AD (utilisateurs Salesforce natifs qui ont des identités correspondantes dans Microsoft Entra ID), ou les deux.

Remarque

Si vous utilisez un fournisseur d’identité tiers comme Ping ID ou secureAuth, vous devez sélectionner « non Microsoft Entra » comme type d’identité.

Si vous avez choisi d’ingérer une liste de contrôle d’accès à partir de votre instance Salesforce et que vous avez sélectionné « ID non-ME » pour le type d’identité, consultez Mapper vos identités non Microsoft Entra pour obtenir des instructions sur le mappage des identités.

Si vous avez choisi d’ingérer une liste de contrôle d’accès à partir de votre instance Salesforce et que vous avez sélectionné « ME-ID » pour le type d’identité, consultez Mapper vos identités Microsoft Entra pour obtenir des instructions sur le mappage des identités. Pour savoir comment configurer Microsoft Entra’authentification unique pour Salesforce, consultez ce tutoriel.

Remarque

Mises à jour aux groupes qui régissent les autorisations d’accès sont synchronisées uniquement dans des analyses complètes. Les analyses incrémentielles ne prennent pas en charge le traitement des mises à jour des autorisations.

Dans cette vidéo, vous pouvez voir le processus d’authentification auprès de votre instance Salesforce, de synchronisation de vos identités non Microsoft Entra avec vos identités Microsoft Entra et d’application des découpages de sécurité appropriés à vos éléments Salesforce.

Contenu

Choisir des objets Salesforce et filtrer les données

Sélectionnez les objets Salesforce que vous souhaitez que le connecteur analyse et inclue dans les résultats de la recherche. Si l’option Contact est sélectionnée, Compte est également automatiquement sélectionné.

Remarque

Si un champ a défini la sécurité au niveau du champ (FLS) pour un profil, le connecteur n’ingère pas ce champ pour les profils de cette organisation Salesforce. Par conséquent, les utilisateurs ne pourront pas rechercher des valeurs pour ces champs ou s’afficher dans les résultats.

Filtrer les données

Vous pouvez également choisir de filtrer le contenu Salesforce indexé de deux manières :

  • Spécifiez la période de modification de l’élément. Cette option indexe uniquement le contenu Salesforce créé ou modifié au cours de la période sélectionnée sur une base propagée en fonction de l’analyse actuelle.
  • Entrez la requête Salesforce (SOQL) en spécifiant ce que vous souhaitez indexer à l’aide de la clause WHERE .

Capture d’écran des options de filtrage dans le connecteur Salesforce

Conseil

Vous pouvez laisser la clause WHERE vide si vous souhaitez indexer tout le contenu de l’entité particulière

Gérer les propriétés

Ici, vous pouvez ajouter ou supprimer des propriétés disponibles à partir de votre source de données Salesforce CRM, affecter un schéma à la propriété (définir si une propriété peut faire l’objet d’une recherche, s’il est interrogeable, récupérable ou refinable), modifier l’étiquette sémantique et ajouter un alias à la propriété. Bien que cette étape ne soit pas obligatoire, le fait d’avoir des étiquettes de propriétés améliore la pertinence et garantit de meilleurs résultats pour les utilisateurs finaux. Par défaut, certaines des étiquettes comme « Title », « URL », « CreatedBy » et « LastModifiedBy » ont déjà reçu des propriétés sources. Les propriétés sélectionnées par défaut sont répertoriées ci-dessous.

La liste des propriétés que vous sélectionnez ici peut avoir un impact sur la façon dont vous pouvez filtrer, rechercher et afficher vos résultats dans Microsoft 365 Copilot.

Source, propriété Label Description
des auteurs authors Nom des personnes qui ont participé ou collaboré sur l’élément dans la source de données.
CreatedBy createdBy Nom de la personne qui a créé l’élément dans la source de données.
CreatedDate createdDateTime Date et heure de création de l’élément dans la source de données.
Url url L’URL cible de l’élément dans la source de données.
LastModifiedBy lastModifiedBy Nom de la personne qui a récemment modifié l’élément dans la source de données.
LastModifiedDateTime lastModifiedDateTime Date et heure de la dernière modification de l’élément dans la source de données.
Nom title Titre de l’élément que vous souhaitez afficher dans la recherche et d’autres expériences.

Afficher un aperçu des données

Utilisez le bouton d’aperçu des résultats pour vérifier les exemples de valeurs des propriétés sélectionnées et du filtre de requête.

Synchronisation

Capture d’écran montrant l’onglet Synchronisation dans lequel vous pouvez configurer la fréquence d’analyse.

L’intervalle d’actualisation détermine la fréquence à laquelle vos données sont synchronisées entre la source de données et l’index du connecteur Graph. Il existe deux types d’intervalles d’actualisation : l’analyse complète et l’analyse incrémentielle. Pour plus d’informations, consultez paramètres d’actualisation.

Vous pouvez modifier les valeurs par défaut de l’intervalle d’actualisation à partir d’ici si vous le souhaitez.

Conseil

Type de résultat par défaut

  • Le connecteur Salesforce inscrit automatiquement un type de résultat une fois le connecteur publié. Le type de résultat utilise une disposition de résultat générée dynamiquement en fonction des champs sélectionnés à l’étape 3.
  • Vous pouvez gérer le type de résultat en accédant à Types de résultats dans le Centre d’administration Microsoft 365. Le type de résultat par défaut est nommé «ConnectionId Default ». Par exemple, si votre ID de connexion est Salesforce, votre disposition de résultat est nommée : « SalesforceDefault ».
  • En outre, vous pouvez choisir de créer votre propre type de résultat si nécessaire.

Résolution des problèmes

Après avoir publié votre connexion, vous pouvez consulter la status sous l’onglet Sources de données dans le Centre d’administration. Pour savoir comment effectuer des mises à jour et des suppressions, consultez Gérer votre connecteur.

Vous trouverez les étapes de résolution des problèmes courants ici.

Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, contactez Microsoft Graph | Support.