Introduction
Connectez Salesforce pour permettre à l’assistant IA et aux agents d’effectuer des recherches dans les objets Salesforce sélectionnés au moment où une question est posée.
Il s’agit d’un connecteur en temps réel. Aucune donnée Salesforce n’est copiée, indexée ni stockée dans Docebo. Lorsqu’une question est posée, Docebo effectue immédiatement une recherche dans les objets Salesforce que vous avez rendus disponibles, à l’aide du compte Salesforce de la personne qui pose la question.
Fonctionnement des droits pour Salesforce : chaque collègue connecte son propre compte Salesforce lors de sa première question. Chaque recherche est ensuite exécutée sous son identité, si bien que Salesforce applique ses propres règles d’accès et que chaque personne ne voit que les enregistrements auxquels Salesforce lui donne accès. Le compte Salesforce de chaque utilisateur doit disposer du droit API Enabled (voir Paramètres requis).
1. Prérequis dans le système source
Rôle requis
Vous devez avoir accès à un administrateur Salesforce en mesure de créer une application client externe.
Paramètres requis
Toute personne qui posera des questions sur des données Salesforce doit disposer d’un utilisateur Salesforce doté du droit API Enabled. Le profil System Administrator et la plupart des profils standard disposent de ce droit.
Pour le vérifier, ouvrez Profils dans Salesforce, cliquez sur le profil de l’utilisateur, puis recherchez API Enabled parmi ses droits. Un ensemble d’autorisations (permission set) peut également être utilisé.
2. Préparation dans le système source
Créez une application client externe dans Salesforce, puis copiez sa Consumer Key et son Consumer Secret dans Docebo.
Vous avez déjà une application ? Réutilisez-la. Ouvrez-la dans l’External Client App Manager et vérifiez les paramètres des sections Activer OAuth et ajouter l’URL de callback, Exiger le secret et créer l’application et Permettre à vos utilisateurs de se connecter : l’URL de callback, les quatre champs d’application, Require secret for Web Server Flow et Relax IP restrictions. Passez ensuite à la section Copier la Consumer Key et le Consumer Secret.
Ouvrir la page New External Client App
- Dans Docebo, dans l’onglet Autoriser, cliquez sur Ouvrir la page New External Client App. Salesforce s’ouvre dans un nouvel onglet.
- Connectez-vous avec un compte administrateur Salesforce si Salesforce vous le demande.
- Le formulaire New External Client App s’affiche. Laissez cette fenêtre ouverte.
Si le lien n’ouvre pas le formulaire : dans Salesforce, cliquez sur l’icône en forme d’engrenage en haut à droite, puis sur Setup. Saisissez External Client App Manager dans Quick Find, ouvrez-le, puis cliquez sur New External Client App.
Nommer l’application
Sous Informations de base :
- External Client App Name : saisissez un nom, par exemple « Docebo AI knowledge ».
- API Name : Salesforce renseigne ce champ automatiquement.
- E-mail de contact : saisissez votre adresse e-mail.
- Distribution State : conservez la valeur Local.
Ne cliquez pas encore sur Créer.
Activer OAuth et ajouter l’URL de callback
- Faites défiler la page vers le bas et cliquez sur API (Enable OAuth Settings) pour développer cette section.
- Cochez Enable OAuth.
- Collez l’URL de callback dans le champ Callback URL. La correspondance doit être exacte. L’URL suit ce modèle : https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, par exemple https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- Sous OAuth Scopes, sélectionnez chacun des quatre champs d’application ci-dessous dans Available OAuth Scopes et déplacez-le vers Selected OAuth Scopes à l’aide du bouton fléché.
| Champ d’application | Code |
|---|---|
| Gérer les données des utilisateurs via API | api |
| Exécuter des requêtes à tout moment | refresh_token, offline_access |
| Accéder à des identifiants utilisateurs uniques | openid |
| Access the identity URL service | id, profile, email, address, phone |
Exiger le secret et créer l’application
- Faites défiler la page jusqu’à la section Sécurité.
- Cochez Require secret for Web Server Flow et Require secret for Refresh Token Flow.
- Laissez tous les autres paramètres tels quels. Les cases cochées grisées sont définies par Salesforce et ne peuvent pas être modifiées.
- Cliquez sur Créer en bas de la page.
Permettre à vos utilisateurs de se connecter
La page de votre nouvelle application s’affiche alors dans Salesforce.
- Dans l’onglet Policies, cliquez sur Modifier.
- Cliquez sur OAuth Policies pour développer cette section.
- Sous App Authorization, définissez IP Relaxation sur Relax IP restrictions.
- Pour Permitted Users, conservez All users can self-authorize et, pour la politique du jeton d’actualisation, conservez 30 jours.
- Cliquez sur Enregistrer.
Copier la Consumer Key et le Consumer Secret
- Ouvrez l’onglet Paramètres de l’application et cliquez sur Paramètres OAuth pour développer cette section.
- Cliquez sur Consumer Key and Secret. Salesforce ouvre un nouvel onglet.
- Salesforce vous envoie un code de vérification par e-mail. Saisissez-le et cliquez sur Vérifier.
- Cliquez sur Copier à côté de Consumer Key et collez la valeur dans le champ Consumer key de Docebo.
- Cliquez sur Copier à côté de Consumer Secret et collez la valeur dans le champ Consumer secret de Docebo.
3. Actions requises dans Docebo
| Informations à saisir | Où les trouver |
|---|---|
| Consumer key | Salesforce → votre application → Paramètres → Paramètres OAuth → Consumer Key and Secret |
| Consumer secret | Salesforce → votre application → Paramètres → Paramètres OAuth → Consumer Key and Secret |
Autoriser le connecteur
- Accédez à Modules et intégrations → Connecteurs de connaissances → Créer → Salesforce. Ce menu n’est visible que par les Superadmins. Dans l’onglet Aperçu, consultez les éléments qui feront l’objet de recherches, puis sélectionnez Démarrer.
Dans l’onglet Paramétrer, indiquez à Docebo l’organisation Salesforce à utiliser. Ouvrez Salesforce dans un autre onglet du navigateur et connectez-vous, copiez l’adresse complète affichée dans la barre d’adresse, puis collez-la dans Collez votre adresse Salesforce (recommandé). N’importe quelle page Salesforce convient, par exemple la page d’accueil. Cette méthode fonctionne pour toutes les organisations, y compris celles qui bloquent la page de connexion standard. Docebo affiche alors l’adresse à laquelle vos utilisateurs se connecteront. Vous pouvez également choisir Utiliser la page de connexion standard (login.salesforce.com, pour un environnement de production ou une Developer Edition) ou Utiliser la page de connexion de la sandbox (test.salesforce.com). Sélectionnez Continuer.
Dans l’onglet Autoriser, saisissez la Consumer key et le Consumer secret (voir le tableau ci-dessus), puis sélectionnez S’authentifier.
Connectez-vous à Salesforce dans la fenêtre qui s’ouvre et cliquez sur Autoriser. Salesforce indique que l’application est inconnue ou non approuvée ? Une nouvelle application peut mettre quelques minutes à être prête. Patientez un instant, puis cliquez de nouveau sur S’authentifier. Vous renouvelez l’authentification d’un connecteur qui fonctionne déjà ? Laissez les champs Consumer key et Consumer secret vides : les valeurs enregistrées seront utilisées.
Dans l’onglet Objets, sélectionnez les objets Salesforce qui contiennent des connaissances pertinentes, par exemple les requêtes, les comptes ou les articles Knowledge. Utilisez la zone de recherche pour trouver un objet, et sélectionnez Effacer la sélection pour recommencer. Sélectionnez ensuite Enregistrer. Aucune donnée n’est copiée ni indexée. Cette étape définit uniquement les objets qui peuvent être ajoutés aux collections de connaissances.