Connecteur Salesforce Knowledge Microsoft Graph
Le connecteur Salesforce Knowledge Graph permet à votre organization d’indexer des articles à partir de Salesforce Knowledge. Après avoir configuré le connecteur, les utilisateurs finaux peuvent rechercher des articles de connaissances à partir de Salesforce dans Microsoft Copilot et à partir de n’importe quel client Recherche Microsoft.
Cette documentation est destinée aux administrateurs Microsoft 365 ou à toute personne qui configure, exécute et surveille un connecteur Salesforce Knowledge Graph.
Remarque
Le connecteur Salesforce Knowledge Graph est en préversion. Si vous souhaitez obtenir un accès anticipé pour l’essayer, inscrivez-vous à l’aide de ce formulaire.
Fonctionnalités
- Indexer les articles Salesforce Knowledge.
- Permettre aux utilisateurs au sein de l’entreprise de poser des questions en langage naturel à l’aide de Copilot et de recevoir des réponses basées sur des articles dans Salesforce. Exemples :
- Quelles sont les étapes à suivre pour traiter un remboursement ?
- Quelle est la procédure d’escalade pour les cas prioritaires ?
- Quelles sont les dernières mises à jour de notre politique de garantie produit ?
- Utilisez la recherche sémantique dans Copilot pour permettre aux utilisateurs de trouver du contenu pertinent en fonction des mots clés, des préférences personnelles et des connexions sociales.
Limitations
- Le connecteur ne prend pas en charge les listes ACL (listes de contrôle d’accès). Toutes les données indexées à l’aide du connecteur Salesforce Knowledge sont visibles par tous les utilisateurs Microsoft 365 de votre locataire, accessibles via Recherche Microsoft ou Copilot.
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 2.0. 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.
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 pour votre connecteur Salesforce Knowledge Microsoft Graph dans le portail d’administration Microsoft 365.
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é.
Vous pouvez maintenant utiliser le centre Administration Microsoft 365 pour terminer le reste du processus de configuration de votre connecteur Salesforce Knowledge Graph.
Prise en main
1. Nom d’affichage
Un nom d’affichage est utilisé pour identifier chaque citation 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 knowledge
Utilisez l’URL de l’instance de connaissances Salesforce de votre organization. Cette URL est l’adresse web spécifique utilisée pour accéder aux services d’API Salesforce Knowledge et interagir avec ceux-ci pour la récupération des données, ce qui ressemble généralement à https://[COMPANY_NAME].my.salesforce.com
3. Type d’authentification
Pour le connecteur Salesforce Knowledge Graph, utilisez OAuth 2.0 pour l’authentification.
Pour vous authentifier, entrez l’ID client et la clé secrète client. L’ID client est un identificateur unique affecté à votre application pour effectuer des demandes à l’API Salesforce Knowledge. La clé secrète client est une clé confidentielle utilisée avec l’ID client pour authentifier votre application en toute sécurité avec l’API Salesforce Knowledge.
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 Knowledge. Vous pouvez cliquer sur le bouton « Créer » pour publier votre connexion et indexer les publications à partir de votre compte Salesforce Knowledge.
Configuration personnalisée
L’installation personnalisée est destinée aux administrateurs qui souhaitent modifier les valeurs par défaut des paramètres. Une fois que vous avez cliqué sur l’option « Configuration personnalisée », trois autres onglets s’affichent : Utilisateurs, Contenu et Synchronisation.
Utilisateurs
Actuellement, les articles du instance Salesforce Knowledge de votre organization sont indexés. Toutes les données indexées à l’aide du connecteur Salesforce Knowledge sont visibles par tous les utilisateurs Microsoft 365 de votre locataire, accessibles via Recherche Microsoft ou Copilot.
Contenu
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 Knowledge, 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é. Les propriétés sélectionnées par défaut sont répertoriées ci-dessous :
| Source, propriété | Étiquette sémantique | Description | Schéma |
|---|---|---|---|
| ArticleId | Requête, récupération | ||
| Numéro d’article | Numéro unique attribué automatiquement à l’article lors de sa création. | Requête, récupération | |
| ArticleType | Type ou catégorie de l’article de connaissances (par exemple, FAQ, Article de support, Guide pratique). | Récupérer | |
| CondensedBody | Inclut le contenu complet ou main corps de l’article | Récupérer, rechercher | |
| CreatedById | Interroger, Récupérer, Rechercher | ||
| CreatedByName | createdBy | Utilisateur qui a initialement créé l’article. | Interroger, Récupérer, Rechercher |
| CreatedDate | createdDateTime | Horodatage de la création initiale de l’article. | Requête, récupération |
| IconUrl | iconUrl | Récupérer | |
| Langue | Langue dans laquelle l’article est écrit. | Récupérer | |
| LastModifiedById | Interroger, Récupérer, Rechercher | ||
| LastModifiedByName | lastModifiedBy | Utilisateur qui a mis à jour l’article en dernier. | Interroger, Récupérer, Rechercher |
| LastModifiedDate | lastModifiedDateTime | Horodatage de la mise à jour la plus récente de l’article. | Requête, récupération |
| LastPublishedDate | Date de la dernière publication de l’article. | Requête, récupération | |
| LastPublishedVersionId | Requête, récupération | ||
| Résumé | Brève vue d’ensemble ou résumé du contenu de l’article. | Recherche | |
| Titre | title | Titre main ou titre de l’article. | Interroger, Récupérer, Rechercher |
| Url | url | Lien vers l’article dans Salesforce Knowledge. | Récupérer |
| UrlName | Nom unique convivial d’URL généré pour l’article. | Requête, récupération |
Synchronisation
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.
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.
Si vous rencontrez des problèmes ou si vous souhaitez fournir des commentaires, contactez Microsoft Graph | Support.