Introduction
L’intégration entre Docebo et Salesforce nécessite une procédure d'installation unique et une configuration initiale de la synchronisation des données. La synchronisation se poursuit ensuite sous forme d’une procédure quotidienne ou peut être programmée selon vos besoins.
Cet article vous guidera dans la procédure d’installation et vous fournira les informations nécessaires sur les pré-requis et les exigences de sécurité pour cette intégration.
Veuillez noter que les images et les vidéos montrées dans la Knowledge Base de Docebo sont dans le mode Lightning.
Notes de Pré-Installation
Avant d’installer l’application Salesforce dans Docebo, veuillez noter les points suivants :
- Assurez-vous que l’Admin gérant l’installation de Salesforce dans Docebo est également un Admin dans la base de données utilisateurs de Salesforce : les noms d’utilisateurs DOIVENT être les mêmes dans les deux systèmes. Si vous ne pouvez pas utiliser les mêmes noms d’utilisateurs dans les deux systèmes (dans le cas de SSO fédérés par exemple), nous vous suggérons de créer un Superadmin non-fédéré dans Docebo pour compléter l’installation.
- Le profil de l’Admin qui a paramétré l’installation dans Salesforce et Docebo ne doit jamais être supprimé ou rétrogradé. Si vous supprimez, rétrogradez ou désactivez le profil utilisateur qui a paramétré l’intégration dans l’un ou l’autre des systèmes, l’intégration ne fonctionnera plus. Nous vous suggérons de créer un utilisateur dédié à l’installation de Salesforce dans les deux systèmes. L’utilisateur Docebo doit être un Superadmin actif. L’utilisateur Salesforce doit avoir des autorisations d’installation et un profil avec un minimum d’exigences de sécurité (comme décrit dans le paragraphe Exigences Minimum de Sécurité pour les Utilisateurs de cet article)
- Quand vous intégrez Docebo avec Salesforce, neuf Custom Objects Salesforce sont utilisés pour Docebo. Les données contenues dans ces Custom Objects sont utilisées pour le user provisioning, la synchronisation et les rapports Salesforce. En savoir plus.
- Quand Docebo est intégré à Salesforce, deux onglets Salesforce sont dédiés à Docebo. Un de ces onglets est pour les Superadmins et l’autre est pour les apprenants. Ces onglets sont nommés en fonction de leur objectif : Docebo Admin et Docebo LMS.
Activer l’Application dans Docebo
Activez l'application Salesforce tel que décrit dans l'article de la Knowledge Base Managing Apps & Features. L'application est répertoriée sur l'onglet Third Party Integrations.
Activer votre Installation Salesforce
Après avoir activé l’application Salesforce, accédez au Menu Admin depuis l’icône engrenage, recherchez la section Salesforce et cliquez sur Gérer. Sur la page de Configuration Salesforce, insérez l’URL de votre org Salesforce. Pour récupérer l’URL de votre org Salesforce, connectez-vous à votre compte développeur Salesforce, cliquez sur l’icône Setup dans le coin supérieur droit, allez à la section Settings dans le menu de gauche, sélectionnez Company Settings et enfin l’option My Domain.
Si votre domaine a déjà été configuré, il est affiché dans le champ My Domain Name is. Si vous n’avez pas de nom de domaine, vous pouvez en créer un.
Il est possible d’utiliser le nom de domaine attribué automatiquement par Salesforce à votre org (affiché dans votre navigateur internet) mais nous vous recommandons fortement de le personnaliser. Il est rare de rencontrer des problèmes durant l’intégration (et si cela se produit, Docebo peut quand même vous identifier facilement), mais la personnalisation de votre Nom de Domaine est une bonne façon de gagner quelques minutes dans le processus de résolution de problèmes car il permet à Docebo de vous identifier rapidement par le Nom de Domaine uniquement. Référez-vous à cet article dans la Knowledge Base de Salesforce pour en savoir plus sur la personnalisation de votre nom de domaine.
Entrez le nom de domaine dans la partie dédiée de la page de Configuration Salesforce et copiez le Secret Key généré automatiquement par votre plateforme. Le Secret Key vous sera demandé une nouvelle fois durant la phase d’Activation de l’Installation de Salesforce. Vous pouvez sélectionner l’option Sandbox Mode pour relier votre intégration à l’org sandbox plutôt que l’org de production. Veuillez noter que si vous utilisez une sandbox sans activer cette option ou que l’URL Salesforce n’est pas correcte, la List View de Salesforce ne sera pas chargée pendant la configuration de la synchronisation des utilisateurs. Cliquez sur Activate. Vous serez redirigé vers la page du package d’installation de Salesforce. Veuillez noter que le bouton Activate n’est actif qu’une fois que vous avez inséré l’URL de votre plateforme Salesforce.
Une fois que vous êtes sur Salesforce, sélectionnez les types d’utilisateurs pour lesquels vous souhaitez installer l’application Docebo (dans le doute, sélectionnez Install for All Users) et consultez les composants qui seront installés en cliquant sur View Components dans la section Additional Details. Cliquez sur Install pour continuer. Veuillez noter que le nom de la version de l’application ainsi que son numéro peuvent être différents de ce qui s’affichent dans cet article.
L'installation se poursuit et un message vous informe de la fin de la procédure d’installation. Cliquez sur Done pour revenir à votre org Salesforce. Si l’installation prend plus de temps que prévu, vous serez prévenu par email quand l'installation est complète.
Finaliser votre Installation Salesforce
Quand l'installation de l’application Docebo est complète, vous devez la finaliser. Si vous n’êtes pas automatiquement redirigé vers la section Installed Packages, cliquez sur l’icône Setup dans le coin supérieur droit de la page, allez sur la section Platform Tools dans le menu de gauche et sélectionnez App puis Installed Packages. Assurez-vous que Docebo est listé dans la section Installed Packages. Vous pouvez vérifier ce qui est inclus dans le paquet Docebo que vous venez d’installer en cliquant sur le lien Docebo sous l’élément Package Name et en cliquant sur View Components et View Dependencies.
Configurez la visibilité de Docebo dans Salesforce pour vos utilisateurs de sorte que les utilisateurs ne puissent pas se donner eux-même l’autorisation de se connecter à Docebo mais qu’ils aient besoin de l’autorisation de l’Admin. Toujours dans la section Platform Tools sur la partie gauche du menu, sélectionnez App, puis Connected Apps et Manage Connected Apps. Sélectionnez Docebo dans la liste des applications connectées, puis cliquez sur Edit Policies. Pour l’option Permitted Users, sélectionnez le choix Admin approved users are pre-authorized. Cliquez sur Save. Sur la page suivante, allez sur Profile et déterminez les profils d’utilisateurs autorisés à accéder à la plateforme. Cette dernière étape garantit que vous, en tant qu’Admin et les autres utilisateurs de Salesforce peuvent utiliser l’application.
Allez sur la page Applications, sélectionnez Docebo et entrez l’URL de votre plateforme Docebo, puis collez le Secret Key généré automatiquement par votre plateforme. Une fois l'installation complète, la valeur du Secret Key restera accessible depuis l’onglet Settings de la section Salesforce du Menu Admin. Allez à l’onglet Docebo, cliquez sur Activate pour compléter le processus d’installation.
Vous êtes maintenant connecté à l’application Docebo dans Salesforce, avec l’utilisateur Admin Salesforce qui est également un Superadmin Docebo. Vous pouvez maintenant commencer à configurer la synchronisation entre Salesforce et Docebo.
Pour cela, accédez au Menu Admin depuis l’icône engrenage dans le coin supérieur droit de la page, recherchez la section Salesforce et cliquez sur Gérer. Quand l’installation du package Salesforce est terminée, la page affiche cinq onglets gérant chacun un aspect différent de l’intégration. Vous pouvez maintenant commencer à synchroniser les utilisateurs, les cours et les inscriptions.
Configurer la Visibilité des Onglets
Si vous prévoyez d’utiliser Docebo intégré dans Salesforce, vous devez configurer la visibilité des onglets pour les utilisateurs. Référez-vous à cet article pour plus d’informations à ce sujet.
Changer l’URL de Salesforce Org
Vous pouvez changer l’URL de Salesforce Org à tout moment. Après le processus d'installation, accédez au Menu Admin depuis l’icône engrenage, recherchez la section Salesforce et cliquez sur Gérer. Allez sur l’onglet Settings, entrez la nouvelle URL dans le champ correspondant, cliquez sur Mise à Jour pour confirmer vos changements et commencez le processus d'installation pour nouveau domaine.
A noter : Quand l’URL de Salesforce Org est modifiée, les données ne sont pas supprimées de Docebo ni de Salesforce. L’intégration pointera seulement vers une autre Salesforce Org.
Réinitialiser votre Configuration Salesforce
Réinitialiser votre configuration Salesforce implique de supprimer l’intégration entre Docebo et Salesforce ainsi que les données synchronisées dans Docebo, y compris les champs supplémentaires SFDC_ID et SFDC_type. Vous pourrez ensuite intégrer avec un autre environnement Salesforce ou recommencer l’intégration actuelle.
Afin de réinitialiser votre configuration Salesforce, accédez au Menu Admin depuis l'icône engrenage, recherchez la section Salesforce et cliquez sur Gérer.
Allez sur l’onglet Settings, cliquez sur Réinitialiser. Confirmez votre action dans la fenêtre pop-up et cliquez sur Réinitialiser de nouveau.
Exigences Minimum de Sécurité pour les Utilisateurs
Quand l’installation du paquet Salesforce est terminée, le profil utilisateur Salesforce des utilisateurs exécutant l’installation peut être restreinte. Connectez-vous à Salesforce, allez à la section Administration dans le menu de gauche, sélectionnez Users et Profile. Puis identifiez le profil et cliquez sur Edit. Configurez le profil en fonction des exigences minimales requises pour les utilisateurs gérant l'intégration entre Docebo et Salesforce comme décrit ci-dessous :
- Les profils utilisateurs Salesforce doivent être attribués à l’app Docebo et à tout autre composant du package Docebo
- Dans la section Connected App, Docebo doit être sélectionné
- Dans la section Administrative Permission, les autorisations suivantes doivent être cochées : Apex REST Services, API Enabled et View All Users
- Dans la section Standard Object Permissions, choisissez l’option Read pour les éléments Accounts et Contacts. Il est également possible de choisir Read et View All. Si vous choisissez Read, le profil utilisateur verra uniquement un ensemble de records en raison des Sharing Rules configurées dans Salesforce Org. Si vous choisissez Read et View All, le profil utilisateur aura accès à n'importe quel objet indépendamment des règles de partage configurées dans Salesforce Org.
- Dans la section Custom object permissions, attribuez des permissions Modify All pour tous les objets du modèle de données SFDC v3.