integration-service
latest
false
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. Les packages de connecteurs disponibles dans Integration Service sont traduits à l'aide d'un moteur de traduction. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.
UiPath logo, featuring letters U and I in white

Guide de l'utilisateur d'Integration Service

Dernière mise à jour 15 mai 2025

Installation et configuration du package géré Salesforce Flow Agents

Ce guide décrit la configuration Salesforce essentielle requise pour utiliser le connecteur Integration Service Salesforce Agentforce & Flows.

Prérequis

Avant de commencer, assurez-vous que les points suivants sont respectés :

  • Vous disposez d'un accès au profil d'administrateur système avec l'API activée.
  • Votre édition Salesforce est Enterprise, Unlimited ou Developer Edition.

Vous pouvez utiliser votre org. Salesforce actuelle ou configurer une nouvelle édition Agentforce Developer en suivant les instructions d'installation sur la page des outils de développement Salesforce Agentforce .

Installation et configuration du package géré Salesforce Flow Agents

Remarque : cette étape est requise pour l'intégration avec les flux Salesforce. Pour l'intégration avec Salesforce Agentforce, ignorez complètement cette étape et passez directement à Création d'une application connectée dans Salesforce (Creating a connected app in Salesforce).

Accéder et installer la liste AppExchange

Suivez ces étapes pour installer le package géré UiPath-SF-Flow-Agents-Integration :

  1. Dans un navigateur Web, accédez à la page Web suivante : Salesforce AppExchange.
    Important : Pour la version préliminaire actuelle du connecteur Salesforce Agentforce & Flows, utilisez l'URL suivante pour accéder au package : https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0=04tPa000000bkIPIAY, en remplaçant <yourSalesforceDomain> par le domaine de votre organisation.
  2. Dans la barre de recherche, saisissez : UiPath-SF-Flow-Agents-Integration.
  3. Sélectionnez la liste de l'application, puis sélectionnez Obtenir maintenant (Get It Now).
  4. Connectez-vous à l'aide de vos informations d'identification Salesforce pour poursuivre l'installation.
  5. Choisissez votre environnement d’installation :
    1. Production : pour les environnements Salesforce opérationnels.
    2. Sandbox : pour les tests avant l'utilisation en production.

      Remarque: lorsque le connecteur UiPath est en prévisualisation, la sélection de l'environnement n'est pas disponible.

  6. Sélectionnez Installer pour les administrateurs uniquement (Install for Admins Only).

    Cette sélection accorde l'accès au package uniquement aux administrateurs système. Vous pouvez également choisir de rendre le package géré disponible pour un utilisateur spécifique disposant des autorisations appropriées.

  7. Cochez la case confirmant l'installation d'une application non-Salesforce.
  8. Sélectionnez Installer ( Install).
  9. Après une installation réussie, sélectionnez Terminé (Done).
  10. Vérifiez l'installation en vérifiant la liste des packages installés pour « UiPath-SF-flow-agents-Integration ».
    Figure 1. La fenêtre Packages installés (Installed Packages) dans Salesforce
    docs image

Attribution d'ensembles d'autorisations

Pour accorder les autorisations nécessaires aux utilisateurs ayant accès au package géré :

  1. Accédez à Configuration (Setup) > Utilisateurs (Users) > Ensemble d'autorisations (Permission Set).
  2. Localisez l'Administrateur par défaut d'Agentforce.
  3. Sélectionnez Gérer les affectations (Manage Assignments).
  4. Sélectionnez Ajouter des affectations (Add Assignments).
  5. Sélectionnez les utilisateurs requis.
  6. Sélectionnez Suivant (Next), puis Attribuer (Assign).

Création d'une application connectée dans Salesforce

Création d'une application connectée

  1. Ouvrez le Gestionnaire d'applications (App Manager), sélectionnez l'icône en forme d'engrenage en haut à droite de la fenêtre et sélectionnez Configuration (Setup).
  2. Dans la case Recherche rapide (Quick Find) située sur la barre latérale gauche, saisissez et sélectionnez Gestionnaire d'applications (App Manager).

    La liste des applications déjà disponibles dans votre organisation Salesforce s'affiche.

  3. Sélectionnez le bouton Nouvelle application connectée (New Connected App) dans le coin supérieur droit de la fenêtre.
    Figure 2. Création d'une nouvelle application connectée
    docs image

  4. Sélectionnez Créer une application connectée (Create a Connected App), puis Continuer (Continue).
    Graphique 3. Fenêtre Créer une application connectée (Create a Connected App)
    docs image

  5. Remplissez la section Informations de base (Basic Information) pour la nouvelle application connectée :
    1. Indiquez un nom. Par exemple, UiPath Salesforce Agentforce Flows Connector.
    2. Nom de l'API (API name) : ce champ est rempli automatiquement en fonction du nom d'application fourni.
    3. Fournir un e-mail de contact : saisissez votre adresse e-mail pour toute communication d’assistance.
  6. Pour activer les paramètres OAuth pour la nouvelle application, faites défiler jusqu'à la section API (Activer les paramètres OAuth) .
    1. Cochez la case Activer les paramètres OAuth .
    2. Spécifiez l' URL de rappel en fournissant l'URL de rappel du connecteur : https://cloud.uipath.com/provisioning_/callback.
    3. Ajoutez les étendues OAuth requises :
      • Pour les flux Salesforce :
        • Accès complet (full)
        • Effectuer des requêtes à tout moment (refresh_token, offline_access)
      • Pour Salesforce Agentforce :
        • Accéder aux services de chatbot (chatbot_api)
        • Accéder à la plate-forme API Salesforce (sfap_api)
        • Accès complet (full)
        • Gérer les données des utilisateurs via les API (api)
        • Effectuer des requêtes à tout moment (refresh_token, offline_access)
  7. Gérer les paramètres de sécurité de l'application connectée :
    1. Activez les cases à cocher suivantes :
      1. Flux d'informations d'identification du client (Client Credentials Flow) : Une fois activé, sélectionnez OK dans la fenêtre contextuelle suivante pour confirmer que toute personne disposant de la clé de consommateur et de la clé secrète du consommateur peut accéder à votre organisation au nom de l'utilisateur sélectionné.
      2. Émettre des jetons d'accès basés sur un jeton Web JSON (JWT) pour les utilisateurs nommés : si vous avez l'intention d'utiliser le code d'autorisation OAuth 2.0 pour l'authentification avec le connecteur Integration Service, ne cochez pas cette case.
    2. Désactivez les cases à cocher suivantes :
      1. Exige une clé de preuve pour l'échange de code (PKCE) pour les flux d'autorisation pris en charge
      2. Exiger une clé secrète pour le flux du serveur Web
      3. Nécessiter une clé secrète pour le flux de jeton d'actualisation
        Figure 4. Paramètres de l’API de l’application connectée
        docs image

  8. Sélectionnez Enregistrer (Save) pour enregistrer l'application. Le message suivant s'affiche : « Les modifications peuvent prendre jusqu'à 10 minutes pour prendre effet. La suppression d'une organisation parente supprime également toutes les applications connectées avec les paramètres OAuth activés. »

Récupération de l'ID et de la clé secrète du client

  1. Revenez au gestionnaire d'applications.
  2. Recherchez votre application (UiPath Salesforce Agentforce Flows Connector), sélectionnez la flèche déroulante sur la droite et sélectionnez Afficher (View).
    Figure 5. Afficher les détails de l'application
    docs image

  3. Sélectionnez Gérer les détails du consommateur.
  4. Si vous y êtes invité, terminez les étapes de vérification de la sécurité. Salesforce peut demander l'envoi d'un code de vérification à votre adresse e-mail enregistrée. Entrez le code lorsque vous y êtes invité.
  5. Les informations d’identification suivantes s’affichent :
    • Clé du consommateur (Consumer Key ) : représente l'ID client.
    • Secret du consommateur (Consumer Secret ) - Représente le secret du client.
    Important : copiez et stockez en toute sécurité les deux valeurs. Ces informations d'identification sont requises pour configurer le connecteur Integration Service.

Configuration de l'application connectée pour le JWT et le flux d'informations d'identification du client

  1. Accédez à Configuration (Setup) > Gérer les applications connectées (Manage Connected Apps).
  2. Recherchez et sélectionnez votre application connectée (UiPath Salesforce Agentforce Flows Connector).
  3. Sélectionnez Modifier les politiques (Edit Policies):
    1. Sous Flux d'informations d'identification du client (Client Credentials Flow), configurez le champ Exécuter en tant qu'utilisateur (Run as user). Le connecteur emprunte l'identité de cet utilisateur pour appeler les API pour les flux et les agents.
      Remarque : Il s'agit du compte de service du connecteur. Assurez-vous de choisir un utilisateur qui dispose des autorisations requises (accès à l'API uniquement ou utilisation de l'API activée).
    2. Sous Paramètres de jeton d'accès basés sur JWT pour les utilisateurs nommés:
      • Cochez la case Émettre des jetons d’accès basés sur un jeton Web JSON (JWT) .
      • Définissez le Délai d'expiration du jeton (Token Timeout) sur 30 minutes.
        Image 6. Paramètres de jeton d'accès basés sur JWT pour les utilisateurs nommés
        docs image

  4. Sélectionnez Enregistrer (Save).

Activation de l'accès du connecteur UiPath à vos agents Agentforce personnalisés

Remarque : cette étape n'est pas requise pour l'agent AgentForce (par défaut).

Pour chaque agent personnalisé, procédez comme suit :

  1. Accédez à Configuration et recherchez « agent ».
  2. Sélectionnez Agents Agentforce.
  3. Dans la section Accorder aux utilisateurs l'accès à l'agent Agentforce (Par défaut) Agent (Get Users Access to the Agentforce (Default) Agent ), sélectionnez le nom de votre agent personnalisé (par exemple, Mon agent de service Agentforce (My Agentforce Service Agent)).
    Figure 7. Octroi d'accès aux utilisateurs à l'agent Agentforce
    docs image

  4. Sélectionnez l'onglet Connexions (Connections ), puis sélectionnez Ajouter (Add).
    Figure 8. Configuration des connexions pour votre agent Agentforce personnalisé
    docs image

  5. Dans la fenêtre Ajouter une connexion (Add Connection) :
    1. Définissez le champ Connexion (Connection) sur API.
    2. Indiquez un nom d'intégration, tel que UiPath Connector.
    3. Sous Application connectée (Connected App), sélectionnez l'application connectée que vous avez précédemment créée (UiPath Salesforce AgentForce Flows Connector).
      Figure 9. Connecteur de flux AgentForce UiPath Salesforce
      docs image

    4. Enregistrez la connexion.

Votre connecteur UiPath peut désormais accéder à votre agent Salesforce personnalisé. Assurez-vous que l’agent que vous souhaitez appeler est activé.

Ensuite, configurez le connecteur Salesforce AgentForce & Flows dans Integration Service. Accédez à l'authentification Salesforce Agentforce & Flows pour créer une connexion.

Problèmes courants et dépannage

La section suivante répertorie les problèmes courants que vous pouvez rencontrer lors de la configuration du package géré par Salesforce Flow Agents ou d’une application connectée, et découvrez comment les résoudre.

Problème : l'installation du package géré échoue en raison de dépendances manquantes

  1. Assurez-vous que toutes les fonctionnalités Salesforce requises (telles que l'accès aux API et Einkins AI) sont activées.
  2. Vérifiez les dépendances du package dans les journaux d'installation.

Problème : les utilisateurs ne peuvent pas accéder à certaines fonctionnalités

  • Vérifiez que les profils et les ensembles d'autorisations corrects ont été attribués à l'utilisateur du compte de service et aux utilisateurs finaux de l'agent.
  • Assurez-vous d’avoir activé l’agent.

Problème : le système externe ne parvient pas à se connecter à Salesforce

  • Vérifiez les paramètres de l'API et assurez-vous que l'authentification OAuth est configurée pour l'application connectée.

Surveillance et vérification de l'état d'exécution des flux lancés automatiquement via le connecteur UiPath

Suivez ces étapes pour accéder à l'objet de journal d'exécution de flux personnalisé dans Salesforce :

  1. Accédez au lanceur d'applications (l'icône de grille dans le coin supérieur gauche).
  2. Recherchez Exécution de flux (Flow Execution) dans la barre de recherche.
  3. Sélectionnez l'onglet Exécution de flux (Flow Execution) ou le nom d'objet qui apparaît dans les résultats de la recherche.
    Cette action ouvre la vue de la liste des enregistrements d'exécution de flux. Un nouvel enregistrement est créé pour chaque flux déclenché via le connecteur UiPath.
    Figure 10. Enregistrements d'exécution de flux
    docs image

  4. Sélectionnez un nom d'exécution de flux particulier pour afficher les détails de cette exécution.
    Figure 11. Détails de l'exécution du flux
    docs image

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2025 UiPath Tous droits réservés.
OSZAR »