Configuration de Salesforce pour le connecteur Agentforce & Flows

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 organisation Salesforce actuelle ou configurer une nouvelle Agentforce Developer Edition 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 Salesforce Flows. Pour l'intégration avec Salesforce Agentforce, ignorez entièrement cette étape et passez directement à Configurer une application connectée dans 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 votre domaine d'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 l'application maintenant.

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 une 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. 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. Une fois l’installation réussie, sélectionnez Terminé.

10. Vérifiez l'installation en consultant la liste des packages installés pour « UiPath-SF-flow-agents-Integration ».

    Figure 1. La fenêtre Packages installés dans Salesforce

    

Attribution d'ensembles d'autorisations

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

1. Accédez à Configuration > Utilisateurs > Ensemble d'autorisations.
2. Localisez l'administrateur par défaut d'Agentforce.
3. Sélectionnez Gérer les affectations.
4. Sélectionnez Ajouter des affectations.
5. Sélectionnez les utilisateurs requis.
6. Sélectionnez Suivant, puis Attribuer.

Configuration d'une application connectée dans Salesforce

Création d'une application connectée

1. Ouvrez App Manager, sélectionnez l'icône en forme d'engrenage dans le coin supérieur droit de la fenêtre et sélectionnez Setup.

2. Dans la case Recherche rapide située sur la barre latérale de gauche, saisissez et sélectionnez App Manager. La liste des applications déjà disponibles dans votre organisation Salesforce s'affiche.

3. Sélectionnez le bouton Nouvelle application connectée dans le coin supérieur droit de la fenêtre.

   Image 2. Créer une nouvelle application connectée

   

4. Sélectionnez Créer une application connectée, puis Continuer.

   Graphique 3. Fenêtre Créer une application connectée

   

5. Remplissez la section Informations de base de 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: une fois activé, sélectionnez OK dans la fenêtre contextuelle suivante pour confirmer que toute personne disposant de la clé du consommateur et du secret du consommateur peut accéder à votre organisation au nom de l’utilisateur sélectionné.
      2. Émettre des jetons d’accès Web JSON (JWT) pour les utilisateurs nommés : si vous avez l’intention d’utiliser le code d’autorisation OAuth 2.0 pour vous authentifier 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

         

8. Sélectionnez Enregistrer pour enregistrer l’application. Le message suivant s’affiche : « Les modifications peuvent prendre jusqu’à 10 minutes pour être appliquées. 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 à App Manager.

2. Recherchez votre application (UiPath Salesforce Agentforce & Flows Connector), sélectionnez la flèche déroulante à droite et sélectionnez Afficher.

   Image 5. Afficher les détails de l’application

   

3. Sélectionnez Gérer les informations 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 : représente l’ID du client.
   • Consommateur secret : représente le client secret. Important : copiez et stockez les deux valeurs en toute sécurité. 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 > Gérer les applications connectées.
2. Recherchez et sélectionnez votre application connectée (UiPath Salesforce Agentforce Flows Connector).
3. Sélectionnez Modifier les politiques:
   1. Sous Flux d’informations d’identification client, configurez le champ Exécuter en tant qu’utilisateur. Le connecteur emprunte l’identité de cet utilisateur pour invoquer 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.
   2. Sous Paramètres du jeton d'accès basé sur JWT pour les utilisateurs nommés:

      • Cochez la case Émettre un jeton Web JSON (JWT) basé sur JWT .

      • Définissez le Délai d'expiration du jeton sur une valeur de 30 minutes.

        Figure 6. Paramètres du jeton d’accès basé sur JWT pour les utilisateurs nommés

        

4. Sélectionnez Enregistrer.

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

Remarque :

Cette étape n'est pas nécessaire pour l'agent AgentForce (Default).

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

1. Accédez à Configuration et recherchez « agent ».

2. Sélectionnez Agentforce.

3. Dans la section Accorder aux utilisateurs l'accès à l'agent Agentforce (Default) Agent) , sélectionnez le nom de votre agent personnalisé (par exemple, My Agentforce Service Agent).

   Image 7. Accorder aux utilisateurs l’accès à l’agent Agentforce

   

4. Sélectionnez l'onglet Connexions , puis sélectionnez Ajouter.

   Figure 8. Configurer les connexions de votre agent Agentforce personnalisé

   

5. Dans la fenêtre Ajouter une connexion :

   1. Définissez le champ Connexion sur API.

   2. Indiquez un nom d'intégration, tel que UiPath Connector.

   3. Sous Application connectée, sélectionnez l'application connectée que vous avez précédemment créée (UiPath Salesforce AgentForce Flows Connector).

      Image 9. Connecteur UiPath Salesforce AgentForce Flows

      

   4. Enregistrez la connexion.

Configuration des paramètres de site distant

1. Dans App Manager, sélectionnez l'icône en forme d'engrenage dans le coin supérieur droit de la fenêtre et sélectionnez Setup.
2. Dans la case Recherche rapide située sur la barre latérale de gauche, saisissez Paramètres du site distant.
3. Sous Sécurité, sélectionnez Paramètres du site distant.
4. Sélectionnez Nouveau site distant pour créer un nouveau site.
5. Configurez le nouveau site en fournissant les informations suivantes :
   • Nom du site distant: saisissez une chaîne alphanumérique, sans espaces, comme UiPathRemoteSite.
   • URL du site distant: saisissez l'URL de base, par exemple : https://cloud.uipath.com.
   • Description: saisissez une description, par exemple : « URL de base de l’intégration UiPath pour l’invocation de flux ». Ce champ est facultatif.
   • Actif: assurez-vous que la case est cochée.
6. Sélectionnez Enregistrer pour confirmer et activer ces paramètres.

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

Configurez ensuite 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 en forme de grille dans le coin supérieur gauche).

2. Recherchez Exécution de flux dans la barre de recherche.

3. Sélectionnez l'onglet 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.

   Image 10. Enregistrements d'exécution de flux

   

4. Sélectionnez un nom d'exécution de flux particulier pour afficher les détails de cette exécution.

   Image 11. Détails de l'exécution du flux