Générer Salesforce OAuth Tokens

Pour connecter Salesforce à une base DE connaissances, vous devez soit fournir vos identifiants Salesforce à NiCE Services Professionnel, soit les saisir vous-même dans Knowledge Hub. Cette page décrit comment créer et configurer une application connectée dans Salesforce, puis saisir les détails de connexion Salesforce dans Knowledge Hub et authentifier la connexion à cet endroit. Après avoir authentifié la connexion, Knowledge Hub génère automatiquement les jetons requis en arrière-plan.

Effectuez chacune de ces tâches dans l'ordre indiqué.

Créer et configurer une Application connectée dans Salesforce

Créer une Application connectée

Au printemps 2026, Salesforce ne vous permettra plus de créer des applications connectées. Vous pourrez continuer à utiliser les applications connectées existantes, mais vous devrez contacter le Soutien Salesforce pour en créer de nouvelles. Consultez l'annonce Salesforce Icon of a square with an arrow pointing out from the top right corner pour plus d'informations.

  1. Connectez-vous à Salesforce en utilisant un compte doté de privilèges de niveau administrateur.

  2. Cliquez sur Setup Icon of gray gear with a lightning bolt in the center en haut à droite.

  3. Utilisez la zone Quick Find pour rechercher App Manager et sélectionnez-le dans les résultats.

  4. Cliquez sur New Connected App.

  5. Dans la fenêtre contextuelle qui s'affiche, sélectionnez Créer une Application connectée, puis cliquez sur continuer.

  6. Si un message indique que la Page ne peut pas être affichée car votre navigateur bloque les cookies inter-domaines, cliquez sur afficher cette Page en version SalesforceClassic.

  7. Entrée d'un nom de l'Application connectée. Le nom de l'API est généré automatiquement ; il s'agit du nom de l'Application connectée sans espaces.

  8. Dans courriel de contact, entrez une adresse courriel valide à laquelle vous avez accès.

  9. Sous API (Activer les Paramètres OAuth), sélectionnez Activer les Paramètres OAuth et configurez les champs qui s'affichent.

    1. Dans URL de Rappel, entrez http://localhost:8000.

    2. Dans Selected OAuth Scopes, sélectionnez les champs d'application suivants et cliquez sur AddIcon of black right-pointing triangle :

      • Gérer les données utilisateur via les API (API)

      • Exécuter les requêtes à tout moment (refresh_token, offline_access)

  10. Assurez-vous que les paramètres suivants sont sélectionnés :

    • Nécessite un secret pour le Flux serveur Web

    • Nécessite un secret pour le Flux de jeton d'actualisation

    • Activer le Flux d'informations d'identification du client

    • Activer le Flux Code d'autorisation et Identifiants

    • Activer le Flux d'échange de jeton

    • Secret requis pour le Flux d'échange de jetons

    • Activer la rotation du jeton de rafraîchissement

  11. Cliquez sur enregistrer.

Copier et stocker la Clé consommateur et le secret consommateur

Après avoir créé et configuré l'application connectée dans Salesforce, le système génère les identifiants requis pour l'intégration avec Knowledge Hub. Dans Salesforce, ceux-ci sont désignés comme la Clé Consommateur et le Secret Consommateur. Dans Knowledge Hub, vous devez saisir ces valeurs respectivement en tant que Id client et Secret client.

  1. Dans Salesforce, utilisez la zone Recherche rapide pour rechercher App Manager, puis cliquez sur App Manager.

  2. Dans l'App Manager de Lightning Experience, recherchez l'application connectée que vous avez créée. Cliquez sur Actions Icon of downward-pointing triangle in a rounded square button > Voir dans la ligne correspondant à cette application connectée.

  3. Sous API (Activer les Paramètres OAuth), cliquez sur Gérer les Détails du consommateur.

  4. En cas d’invite, authentifiez-vous en utilisant le code qui vous a été envoyé par e-mail.

  5. Copiez la Clé Consommateur et le secret Consommateur et stockez-les dans un emplacement sécurisé. Vous utilisez ensuite ces valeurs ultérieurement comme Id client et Secret client dans Knowledge Hub.

Configurer les paramètres de l'Application connectée

Ensuite, configurez certains des paramètres de l'application connectée que vous avez créée.

  1. Depuis Gérer les informations du consommateur dans Salesforce, cliquez sur Retour à Gérer les Applications connectées.

  2. Cliquez sur Gérer en haut.

  3. Cliquez sur Modifier les Politiques.

  4. Sous Politiques OAuth, configurez les champs suivants :

    1. Dans la liste déroulante Permitted Users, sélectionnez Admin approved users are pre-authorized.

    2. Dans Refresh Token Policy, sélectionnez Expire refresh token if not used for, puis entrez 2 et sélectionnez Heure(s).

    3. Sélectionnez Activer le Flux d'échange de jeton.

  5. Sous Paramètres d'approvisionnement des utilisateurs, sélectionnez Activer l'approvisionnement des utilisateurs.

  6. Cliquez sur enregistrer.

Attribuer le Profil Admin à l'Application connectée

Ensuite, attribuez le profil Administrateur Système à l'application connectée.

  1. Revenez à l'application connectée, faites défiler jusqu'à la Section Profiles et cliquez sur Manage Profiles.

  2. Cochez la case à côté de System Administrator.

  3. Cliquez sur enregistrer.

Configuration des Paramètres OAuth

Suivant, configurez vos paramètres OAuth dans Salesforce.

  1. Dans Salesforce, cliquez sur Setup Icon of gray gear with a lightning bolt in the center en haut à droite.

  2. Utilisez le champ Quick Find pour rechercher OAuth, puis cliquez sur OAuth et Paramètres OpenID Connect.

  3. Activer les paramètres suivants :

    • Autoriser OAuth les Flux Nom d’utilisateur-Mot DE passe

    • Autoriser OAuth les Flux User-Agent

    • Autoriser les Flux de code d'autorisation et d'Identifiants

Obtenir le nom de l'Objet

Enfin, récupérez le nom de l'objet à partir de Salesforce. C'est le dernier identifiant que vous devez fournir à Knowledge Hub.

  1. Connectez-vous à Salesforce.

  2. Cliquez sur Setup en haut à droite.

  3. Utilisez la zone Trouver rapide pour rechercher Object Manager, puis cliquez sur Object Manager.

  4. Trouvez l'objet dont le nom API est Knowledge_kav.

Configurer et Authentifier Salesforce dans Knowledge Hub

  1. Dans NiCE CXone, cliquez sur le sélecteur d'applications Icon of three-by-three grid of white squares on a blue background et sélectionnez Général > AI Studio > Knowledge Hub.

  2. Cliquez sur Edit Sourceicon of a gray pencil and paper. dans la ligne de la source de connaissances pour laquelle vous souhaitez fournir des identifiants.

  3. Sur la page Source Configuration, entrée les détails pour les champs suivants,

    1. Source de connaissances

    2. Id client

    3. Secret client

    4. Instance URL

    5. Nom d'objet

  4. Après avoir entré tous les Salesforce champs requis, le bouton Authentifier est activé. Sélectionnez Authentifier pour ouvrir la session sur Salesforce et effectuer la vérification.

  5. Dans la fenêtre de connexion Salesforce, entrez le nom d’utilisateur et le mot DE passe du compte associé à l’id client et au secret client.

  6. Terminez l'étape de vérification d'identité. Salesforce envoie un code de vérification à l'adresse courriel ou au numéro DE téléphone enregistré.

  7. Une fois l'authentification terminée avec succès, Knowledge Hub génère automatiquement les jetons requis en arrière-plan.

  8. Lorsque l'authentification est terminée, les champs de configuration deviennent en lecture seule. Si la création de la source ou la synchronisation échoue, vous pouvez à nouveau modifier la configuration.

  9. Sélectionnez Suivant.

Sélectionnez les métadonnées pour l'ingestion

Après l'authentification, sélectionnez les champs Salesforce que Knowledge Hub doit ingérer. Vous pouvez choisir à la fois des champs de métadonnées et des champs de corps d'article. Certains champs sont requis par défaut et ne peuvent pas être supprimés. Les champs disponibles peuvent varier en fonction de votre configuration Salesforce.

  1. Dans Article Meta Champs de données, sélectionnez les champs à ingérer en tant que métadonnées.

  2. Dans Champ(s) Corps de l'article, sélectionnez le ou les champs contenant le corps de l'article.

    Ne sélectionnez pas le même champ à la fois dans la liste champ de métadonnées et dans la liste champ de corps de l'article. Conservez les champs obligatoires par défaut sélectionnés. Ces champs ne peuvent pas être supprimés.

  3. Cliquez sur enregistrer.

Réauthentifier la Salesforce Source

Si l'authentification de Salesforce est révoquée, expire ou cesse de fonctionner, mettez à jour les détails de connexion si nécessaire, puis authentifiez-vous à nouveau depuis la même page de configuration. une fois l'authentification réussie, poursuivez avec la sélection des métadonnées.