

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Intégration de Salesforce
<a name="salesforce-integration"></a>

Grâce au connecteur d'action Salesforce d'Amazon Quick, vous pouvez effectuer des actions au sein des organisations Salesforce, notamment gérer des enregistrements, interroger des données et interagir avec Salesforce APIs. Ce connecteur d'action prend uniquement en charge l'exécution des tâches et nécessite le niveau Amazon Quick Pro ou supérieur.

## Actions possibles
<a name="salesforce-integration-capabilities"></a>

Grâce à l'intégration de Salesforce, vous pouvez effectuer des actions au sein de vos organisations Salesforce via le connecteur d'actions.

**Connecteur Action**  
Créez, mettez à jour et interrogez des objets Salesforce tels que des prospects, des comptes, des contacts et des opportunités.

**Note**  
L'intégration de Salesforce ne prend pas en charge l'accès aux données ni la création de bases de connaissances. Il est spécialement conçu pour l'exécution de tâches et les interactions d'API avec les objets Salesforce.

## Avant de commencer
<a name="salesforce-integration-prerequisites"></a>

Avant de configurer l'intégration de Salesforce, assurez-vous de disposer des éléments suivants :
+ Organisation Salesforce dotée des autorisations appropriées.
+ Identifiants d'accès à l'application connectée ou à l'API Salesforce.
+ Amazon Quick Author ou version ultérieure.
+ Accès administratif pour configurer les OAuth applications (si vous utilisez l'authentification utilisateur).

## Étape 1 : configurer l'application connectée Salesforce
<a name="salesforce-connected-app-setup"></a>

**Note**  
Créez une application connectée dans Salesforce. Ne créez pas d'application cliente externe. Les applications clientes externes ne sont pas compatibles avec cette intégration.

Créez une application connectée dans Salesforce pour activer OAuth l'authentification avec Amazon Quick.

1. Connectez-vous à votre compte Salesforce et accédez à la page de configuration à l'aide de l'icône de configuration en haut à droite.

1. Dans la barre de recherche rapide, entrez**Apps**, puis procédez comme suit :
   + Sélectionnez **des applications clientes externes**
   + Sélectionnez **Réglages**
   + Sous Paramètres, créez une nouvelle application connectée

1. Choisissez **Nouvelle application connectée**.

1. Choisissez **Créer une application connectée**.

1. Dans la section Informations de base, entrez les informations obligatoires suivantes :
   + **Nom de l'application connectée** : nom descriptif de votre application connectée.
   + **Nom de l'API** : nom d'API unique pour votre application.
   + **Adresse e-mail de contact** - Votre adresse e-mail de contact.

1. Dans la section OAuth Paramètres, cochez les cases suivantes :
   + **Activer OAuth les paramètres**
   +  **Exiger une clé de preuve pour l'extension PKCE (Proof Key for Code Exchange) pour les flux d'autorisation pris en charge** *(recommandé)* 

      Activez cette option pour ajouter une couche de sécurité supplémentaire au flux de code d'autorisation.
   + **Exiger un secret pour le flux du serveur Web**
   + **Exiger un secret pour actualiser le flux de jetons**
   + **Activer le flux d'informations d'identification du client**
   + **Activer le code d'autorisation et le flux d'informations d'identification**
   + **Activer le flux d'échange de jetons**
   + **Exiger un secret pour le flux d'échange de jetons**

1. Ajoutez les OAuth étendues obligatoires suivantes :
   + `api`- Accédez à Salesforce APIs
   + `refresh_token`- Maintenir l'accès lorsque l'utilisateur est hors ligne
   + `offline_access`- Exécuter les demandes à tout moment
   + `full`- Accès complet à toutes les données
   + `web`- Accès via le Web
   + `visualforce`- Accédez aux pages Visualforce
   + `custom_permissions`- Accédez à des autorisations personnalisées
   + `chatter_api`- Accédez à l'API Chatter
   + `wave_api`- Accédez à l'API Analytics
   + `eclair_api`- Accédez à l'API Einstein Analytics
   + `pardot_api`- Accédez à l'API Pardot
   + `id`- Accédez aux informations d'identité
   + `email`- Accéder à l'adresse e-mail
   + `profile`- Accédez aux informations de base du profil
   + `address`- Informations d'adresse d'accès
   + `phone`- Numéro de téléphone d'accès
   + `open_id`- Accédez à OpenID Connect

1. Entrez l'URL de rappel au format suivant : `<quicksuite-url>/sn/oauthcallback`

1. Choisissez **Enregistrer**.

## Étape 2 : Configuration des informations du consommateur et de l'utilisateur d'exécution
<a name="salesforce-consumer-details"></a>

Configurez les informations du client et configurez un utilisateur d'exécution pour le flux d'informations d'identification du client.

1. Sur la page Gérer les applications connectées, choisissez **Gérer les informations du consommateur**. Il se peut que vous deviez vérifier votre identité.

1. Copiez la **clé du consommateur (ID client)** et le **secret du consommateur (secret du client)**.

1. Cliquez sur **Appliquer**.

1. Choisissez **Initial Access Token**, puis **OK**.

1. Configurez l'utilisateur d'exécution :

   1. Sur la page détaillée de l'application connectée, choisissez **Modifier** dans la colonne Action.

   1. Sous OAuth Politiques > Politique d'actualisation du jeton, sélectionnez **Expirer immédiatement le jeton d'actualisation**.

   1. Sous Flux d'informations d'identification du client, pour Exécuter en tant que, choisissez l'utilisateur auquel attribuer le flux d'informations d'identification du client.

   1. Choisissez **Enregistrer**.

## Étape 3 : configurer le connecteur d'action Salesforce
<a name="salesforce-integration-setup"></a>

Après avoir préparé les informations d'identification de votre application connectée Salesforce, créez le connecteur d'action Salesforce dans Amazon Quick.

L'intégration de Salesforce prend uniquement en charge l'exécution d'actions. L'accès aux données et la création de bases de connaissances ne sont pas disponibles pour les systèmes Salesforce.

1. Dans la console Amazon Quick, choisissez **Integrations.**

1. Choisissez **Salesforce** parmi les options d'intégration, puis cliquez sur le bouton Ajouter (plus « \$1 »).

1. Renseignez les détails de l'intégration :
   + **Nom : nom** descriptif de votre connecteur d'action Salesforce.
   + **Description** (facultatif) - Objectif du connecteur d'action.

1. Choisissez votre type de connexion :
   + **Authentification OAuth basée sur l'authentification utilisateur** pour un accès utilisateur individuel.
   + Authentification du **service : Service-to-service authentification** pour l'accès aux applications.

1. Renseignez les paramètres de connexion en fonction de la méthode d'authentification que vous avez sélectionnée (utilisateur ou service) :

   1. Pour **Authentification utilisateur (OAuth)**, configurez les champs suivants :
     + **URL de base : URL** de l'instance Salesforce (par exemple, https://your-domain.salesforce.com).
     + **ID client** : clé utilisateur de l'application connectée Salesforce.
     + **Secret du client : secret** du consommateur de l'application connectée Salesforce.
     + **URL du jeton** : point de terminaison OAuth du jeton Salesforce.
     + **URL d'authentification** : point de terminaison OAuth d'autorisation Salesforce.
     + **URL de OAuth redirection** : URI de redirection configurée dans votre application connectée.

1. Sélectionnez **Créer et continuer**.

1. Choisissez les utilisateurs avec lesquels partager l'intégration.

1. Cliquez sur **Suivant**.

## Étape 4 : associer le connecteur d'action aux groupes d'automatisation
<a name="salesforce-automation-group-setup"></a>

Pour utiliser les actions Salesforce dans les automatisations, vous devez associer le connecteur d'actions à vos groupes d'automatisation.

1. Accédez aux paramètres de votre groupe d'automatisation.

1. Associez le connecteur d'action Salesforce au groupe d'automatisation qui utilisera ces actions.

1. Créez une nouvelle automatisation pour le groupe d'automatisation afin d'accéder aux actions Salesforce dans vos flux de travail.

## Actions de tâche disponibles
<a name="salesforce-integration-actions"></a>

Après avoir créé votre intégration Salesforce, vous pouvez consulter les actions disponibles pour interagir avec les objets Salesforce. Les actions courantes de Salesforce incluent :
+ Opérations de création, de lecture, de mise à jour et de suppression (CRUD) sur des objets standard et personnalisés.
+ Interrogez les données Salesforce à l'aide du langage SOQL (Salesforce Object Query Language).
+ Gérez les prospects, les comptes, les contacts et les opportunités.
+ Exécutez les méthodes Apex et la logique personnalisée.
+ Gérez les cas, les tâches et les activités.
+ Accédez aux rapports et aux tableaux de bord.

## Partagez des intégrations
<a name="salesforce-integration-sharing"></a>

Vous pouvez partager les connecteurs d'action Salesforce avec d'autres utilisateurs de votre organisation. Procédez comme suit :

1. Après avoir créé l'intégration, choisissez **Partager l'intégration**.

1. Sélectionnez les utilisateurs ou les groupes avec lesquels partager l'intégration.

1. Définissez les autorisations appropriées pour l'accès partagé.

1. Confirmez les paramètres de partage.

Les utilisateurs partagés peuvent utiliser l'intégration Salesforce pour effectuer des actions au sein de l'organisation Salesforce connectée, sous réserve des autorisations configurées dans la configuration d'authentification d'origine.

## Gérer les connecteurs d'action Salesforce
<a name="salesforce-integration-management"></a>

Après avoir créé votre connecteur d'action Salesforce, vous pouvez le gérer à l'aide des options suivantes :
+ **Modifier le connecteur d'action :** mettez à jour les paramètres d'authentification ou la configuration de l'instance Salesforce.
+ **Partager le connecteur d'action** : mettez le connecteur d'action à la disposition des autres utilisateurs de votre organisation.
+ **Surveiller l'utilisation** : consultez l'activité du connecteur d'action et les statistiques d'utilisation des API.
+ **Réviser les actions** : consultez la liste complète des actions Salesforce disponibles.
+ **Supprimer le connecteur d'action** : supprimez le connecteur d'action et révoquez l'authentification associée.