La configuration de l’intégration Salesforce relie votre base de connaissances Document360 à votre console Salesforce. Une fois mis en place, les agents de support peuvent rechercher des articles, obtenir des recommandations et créer du contenu de base de connaissances directement depuis Salesforce. Cet article vous guide à chaque étape du processus de configuration, de l’installation de l’application Document360 sur Salesforce à l’autorisation de la connexion depuis votre portail Document360.
Avant que tu commences
- Vous avez besoin d’un compte Salesforce Lightning. Si vous n’en avez pas, inscrivez-vous pour un essai gratuit sur la page d’inscription Salesforce. Si vous avez déjà un compte, passez directement à l’installation de l’application Document360 sur Salesforce.
- Vous devez être administrateur à la fois dans votre organisation Salesforce et dans votre projet Document360.
- L’intégration Salesforce est un achat complémentaire. Allez dans Paramètres > Extensions dans votre portail Document360 et cliquez sur Acheter maintenant sous la tuile Salesforce avant de commencer.
Comment configurer l’intégration Salesforce
La mise en place de l’intégration comporte cinq étapes. Complétez-les dans l’ordre :
- Créez un compte Salesforce (passez si vous en avez déjà un)
- Installez l’application Document360 sur Salesforce
- Configurer les paramètres du gestionnaire d’applications
- Ajouter une page Visualforce
- Accorder l’accès à l’application aux profils utilisateurs
- Autoriser l’intégration depuis Document360
Créez un compte Salesforce
Si vous avez déjà un compte sur la plateforme Salesforce Lightning, passez cette section.
- Rendez-vous sur la page d’inscription Salesforce.
- Saisissez les informations requises et cliquez sur Lancer mon essai gratuit.
- Visitez la page tarifaire de Salesforce pour choisir et acheter un forfait adapté à vos besoins.
- Vérifiez votre adresse e-mail enregistrée pour un message contenant votre lien de vérification, l’URL du compte et votre nom d’utilisateur. Cliquez sur Vérifier le compte dans l’e-mail.
- Saisissez le code de vérification depuis l’email de suivi et cliquez sur Vérifier.
Le code de vérification arrive dans un e-mail distinct de celui du lien de vérification initial.
Vous êtes redirigé vers la page d’accueil de Salesforce.
Installez l’application Document360 sur Salesforce
- Allez sur l’annonce Document360 sur AppExchange.
- Cliquez sur Essayer.
- Connectez-vous avec votre compte Trailblazer.
- Sélectionnez l’environnement où vous souhaitez installer l’application :
- Installer en Production — installe Document360 dans l’environnement de production de votre projet Salesforce.
- Installer dans Sandbox — installe Document360 dans l’environnement bac à sable de votre projet Salesforce.
- Consultez les détails d’installation et cliquez sur Confirmer et installer.
- Saisissez vos identifiants Salesforce et cliquez sur Connecter.
- Sélectionnez qui devrait avoir accès à l’application Document360 :
- Installation uniquement pour les administrateurs — cela restreint l’accès uniquement aux administrateurs.
- Installer pour tous les utilisateurs — donne accès à tous les utilisateurs de votre organisation.
- Installer pour des profils spécifiques — limite l’accès à certains profils utilisateurs.
Cette sélection détermine quels utilisateurs de votre organisation Salesforce peuvent accéder à l’application Document360. Vous pouvez ajuster l’accès plus tard en mettant à jour les profils utilisateurs.
- Cliquez sur Installer.
- Attendez la fin de l’installation, puis cliquez sur Terminé.
Configurez les paramètres et les politiques du gestionnaire d’applications
Après avoir installé l’application Document360, configurez ses politiques OAuth dans Salesforce pour contrôler qui peut autoriser l’intégration.
- Dans votre configuration Salesforce, naviguez vers Outils de plateforme > Applications > Gestionnaire d’applications dans le panneau de navigation de gauche. Cette étape garantit une autorisation sécurisée et un contrôle d’accès approprié pour les utilisateurs interagissant avec l’intégration Document360.
- Sur la page Gestionnaire d’applications Lightning Experience , trouvez Document360 dans la liste des applications.
- Cliquez sur la flèche vers le bas à la fin de la ligne de l’application Document360 et sélectionnez Gérer.
- Sur la page des détails de l’application connectée à Document360, cliquez sur Modifier les politiques.
- Dans la liste déroulante des utilisateurs autorisés , sélectionnez qui peut autoriser l’application à accéder aux données en leur nom. Il y a deux options :
- Tous les utilisateurs peuvent s’auto-autoriser — tout utilisateur de votre organisation peut autoriser l’application individuellement si nécessaire. Cela convient bien aux organisations ayant différents rôles ou départements qui doivent utiliser l’intégration de manière indépendante.
- Les utilisateurs approuvés par les administrateurs sont pré-autorisés — les utilisateurs administrateurs sont automatiquement autorisés sans passer par le processus d’authentification à chaque fois. C’est utile lorsque l’administrateur est l’utilisateur principal de l’intégration.
Sélectionner les utilisateurs approuvés par les administrateurs comme pré-autorisés est une action unique. Une fois configuré, l’administrateur n’aura plus besoin de s’authentifier manuellement.
Ajoutez une page Visualforce dans la console développeur Salesforce
Vous devez créer une page Visualforce dans votre console développeur Salesforce pour intégrer l’application Document360 dans votre environnement Salesforce.
- Dans le champ Recherche rapide en haut à gauche de votre configuration Salesforce, cherchez Visualforce Pages et sélectionnez-le parmi les résultats.
- Cliquez sur Nouveau.
- Saisissez une étiquette, un nom et une description pour la page.
- Sélectionnez la case Disponible pour l’expérience Lightning, les sites Experience Builder et l’application mobile .
- Collez le code suivant dans la section Balisage Visualforce :
<apex:page standardController="Case"> <apex:canvasApp applicationName="Document360" namespacePrefix="Document360" height="800" width="750px"/> </apex:page>
Vous pouvez modifier les valeurs de hauteur et de largeur dans le balisage pour les adapter à votre mise en page. Par exemple : height="800px" width="750px". Notez la valeur de hauteur que vous définissez ici — vous en aurez besoin lors de l’ajout du composant Visualforce à votre page Affaires.
- Cliquez sur Enregistrer.
Accorder l’accès à l’application aux profils utilisateurs
L’administrateur de l’organisation doit accorder à l’application Document360 l’accès aux profils utilisateurs concernés. Sans cette étape, les utilisateurs verront une erreur de Privilèges Insuffisants lors de l’accès à l’onglet Connaissances.
- Accédez à la page Configuration dans votre environnement Salesforce.
- Dans le panneau de navigation de gauche, allez dans Administration > Utilisateurs > Profils.
- Dans la liste des profils, cliquez sur le profil attribué à l’équipe ou à la personne qui gère la page du dossier et les paramètres d’intégration.
- Sur la page de profil, cliquez sur Modifier.
- Faites défiler jusqu’à la section Accès aux applications connectées .
- Sélectionnez la case à cocher Document360 .
- Cliquez sur Enregistrer.
Répétez cela pour chaque profil nécessitant l’accès à l’application Document360 dans Salesforce.
Autorisez l’intégration Salesforce depuis votre portail Document360
La dernière étape consiste à autoriser la connexion depuis votre portail Document360.
- Rendez-vous sur votre portail Document360.
- Naviguez dans Paramètres dans la barre de navigation de gauche.
- Allez dans Extensions dans le panneau de navigation de gauche.
- Cliquez sur Salesforce sous la section Helpdesk .
Salesforce est un achat complémentaire. Si vous ne l’avez pas encore acheté, cliquez sur Acheter maintenant sur la tuile Salesforce.
- Cliquez sur Connecter.
- Sélectionnez votre type d’autorisation :
- Live — autorise votre projet Salesforce de production.
- Sandbox — autorise votre projet Salesforce en mode bac à sable.
- Dans le panneau Permettre l’accès , cliquez sur Permettre et attendez quelques secondes.
- La tuile Salesforce affiche désormais le statut de projet connecté à Salesforce ainsi que l’URL du compte Salesforce associée à votre projet.
- Cliquez sur Détails sur la tuile Salesforce pour consulter toutes vos informations de configuration.
Pour supprimer l’intégration, cliquez sur l’icône Supprimer sur la tuile Salesforce.
L’intégration Salesforce est maintenant mise en place. Vos agents peuvent désormais consulter votre base de connaissances, obtenir des recommandations d’articles et créer des articles directement depuis la console Salesforce. Ensuite, apprenez à utiliser Document360 dans Salesforce.
Meilleures pratiques
- Terminez les cinq étapes dans l’ordre. Chaque étape dépend de celle qui précède. Sauter la configuration du gestionnaire d’applications, par exemple, peut entraîner des erreurs d’autorisation ultérieurement.
- Testez dans le bac à sable avant de lancer la mise en ligne. Utilisez l’environnement bac à sable pour vérifier que l’intégration fonctionne comme prévu avant de connecter votre projet Salesforce en production.
- Définir l’accès au profil avant d’autoriser. Accordez l’accès à l’application Document360 à tous les profils utilisateurs pertinents avant que les agents n’essaient d’utiliser l’intégration, afin d’éviter les erreurs de privilèges insuffisants.
- Note la hauteur de ta page Visualforce. Lorsque vous ajoutez Document360 à votre page Dossiers, la hauteur doit correspondre ou dépasser la valeur définie dans votre balisage de page Visualforce.
- Utiliser Les utilisateurs approuvés par l’administrateur sont pré-autorisés pour une expérience plus fluide. Si votre administrateur est l’utilisateur principal de l’intégration, ce paramètre supprime le besoin d’invites d’authentification répétées.
- Lors de la mise à niveau de l’intégration, consultez les notes de version de Document360 et Salesforce pour détecter tout changement d’API ou de fonctionnalité, testez dans un environnement de staging, puis confirmez la compatibilité avant de déployer en production.
FAQ
Quelle est l’architecture technique de l’intégration entre Document360 et Salesforce ?
L’intégration utilise des API des deux plateformes pour permettre le transfert de données et la synchronisation entre Document360 et Salesforce.
Comment la gestion des versions des documents est-elle prise en charge lors de la synchronisation ?
L’intégration suit les évolutions dans Document360 et met à jour les enregistrements correspondants dans Salesforce afin de maintenir la précision et la cohérence des données.
Quelles sont les étapes nécessaires pour mettre à jour l’intégration lors de la sortie de nouvelles versions ?
Examinez les notes de version pour tout changement d’API ou de fonctionnalités, testez la mise à jour dans un environnement de staging, puis confirmez la compatibilité avant de déployer en production.