

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 les API Salesforce. Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultez[Configuration des intégrations dans la console](integration-console-setup-process.md).

**Note**  
Depuis la version Spring '26 de Salesforce (février 2026), la création de nouvelles applications connectées est désactivée par défaut dans toutes les organisations Salesforce. Ce guide utilise les applications client externes (ECA) de Salesforce, qui sont entièrement compatibles avec le connecteur Amazon Quick Salesforce.

## Conditions préalables
<a name="salesforce-integration-prerequisites"></a>

Avant de configurer l'intégration Salesforce, assurez-vous de disposer des éléments suivants :
+ Une organisation Salesforce dotée d'un accès administrateur système.
+ Rôle Amazon Quick Author ou supérieur.
+ L'URL de votre instance Amazon Quick (par exemple,`https://us-east-1.quicksight.aws.amazon.com`).

## Étape 1 : créer une application client externe dans Salesforce
<a name="salesforce-eca-setup"></a>

Créez une application client externe (ECA) dans Salesforce pour activer l'authentification OAuth avec Amazon Quick.

### Accédez au gestionnaire d'applications client externe
<a name="salesforce-eca-navigate"></a>

1. Connectez-vous à votre organisation Salesforce et choisissez **Configuration** (icône en forme de roue dentée en haut à droite).

1. Dans le volet de navigation, développez **Outils de plate-forme** > **Applications > Applications** **clientes externes** **> Gestionnaire d'applications client externe**.

1. Choisissez **Nouvelle application client externe**.

### Renseignez les informations de base
<a name="salesforce-eca-basic-info"></a>

Entrez les informations de base suivantes pour votre application client externe :


**Informations de base sur l'application client externe**  

| Champ | Value | 
| --- | --- | 
| Nom de l'application client externe | Un nom descriptif (par exemple, « Amazon Quick Integration ») | 
| Nom d'API | Auto-generated à partir du nom de l'application | 
| Email de contact | Votre adresse e-mail d'administrateur | 
| État de distribution | Local (par défaut) | 

## Étape 2 : Configuration des paramètres OAuth
<a name="salesforce-oauth-setup"></a>

### Activer OAuth
<a name="salesforce-enable-oauth"></a>

Dans la section **API (Activer les paramètres OAuth)**, sélectionnez **Activer OAuth pour développer le panneau de configuration OAuth**.

### Définir l'URL de rappel
<a name="salesforce-callback-url"></a>

Entrez l'URL de rappel Amazon Quick OAuth dans le champ URL de **rappel** :

`{{<your-quick-instance-url>}}/sn/oauthcallback`

Par exemple : `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`

### Ajouter des étendues OAuth
<a name="salesforce-oauth-scopes"></a>

**Déplacez les étendues suivantes des étendues OAuth **disponibles vers les étendues OAuth** sélectionnées :**
+ Accéder au service d’URL d’identité (identifiant, profil, e-mail, adresse, téléphone)
+ Gérer les données utilisateur via des API (api)
+ Gestion des données utilisateur via des navigateurs Web (Web)
+ Accès complet (complet)
+ Accès aux applications Visualforce (Visualforce)
+ Exécuter des demandes à tout moment (refresh\_token, offline\_access)
+ Accéder à des identifiants utilisateur uniques (openid)
+ Accéder aux autorisations personnalisées (custom\_permissions)
+ Accédez aux ressources de l'API REST Connect (chatter\_api)
+ Accédez aux ressources de l'API REST Analytics (wave\_api)
+ Cartes de l'API REST Access Analytics Ressources de géodonnées (eclair\_api)
+ Gérer les services Pardot (pardot\_api)

### Activer les flux OAuth
<a name="salesforce-oauth-flows"></a>

Sélectionnez les options de flux suivantes :
+ **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**

### Activer les paramètres de sécurité
<a name="salesforce-security-settings"></a>

Sélectionnez les options de sécurité suivantes :
+ **Exiger une clé de preuve pour l'échange de code (PKCE)**
+ **Exiger le secret pour le flux du serveur Web** (sélectionné par défaut)
+ **Exiger un secret pour actualiser le flux de jetons** (sélectionné par défaut)

Choisissez **Create** pour enregistrer l'application client externe.

## Étape 3 : Obtenir les informations d'identification des consommateurs
<a name="salesforce-consumer-details"></a>

1. Après la création, vous êtes sur la page détaillée de l'ECA.

1. Accédez à l'onglet **Paramètres** ou choisissez **Gérer les informations du consommateur**.

1. Il se peut que vous deviez vérifier votre identité (code de vérification par e-mail).

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

**Important**  
Enregistrez ces informations d'identification en toute sécurité. Vous en avez besoin lorsque vous configurez le connecteur dans Amazon Quick.

## Étape 4 : configurer le connecteur Salesforce dans Amazon Quick
<a name="salesforce-integration-setup"></a>

### Naviguez vers Connectors
<a name="salesforce-navigate-connectors"></a>

1. Ouvrez Amazon Quick et choisissez **Connectors**.

1. Choisissez l'onglet **Créer pour votre équipe**.

1. Trouvez et choisissez **Salesforce**.

1. Si vous êtes invité à indiquer qu'un connecteur existe déjà, choisissez **Non, créez-en un nouveau**.

### Renseignez les informations de connexion
<a name="salesforce-connection-details"></a>

Entrez les informations de connexion suivantes :


**Détails de connexion au connecteur Salesforce**  

| Champ | Value | 
| --- | --- | 
| Nom | Un nom descriptif (par exemple, « Salesforce ECA ») | 
| Réseau | Réseau public | 
| Type d'authentification | Application OAuth personnalisée | 
| URL de base | https://{{<your-domain>}}.my.salesforce.com/services/data/v60.0 | 
| Identifiant du client | Clé du consommateur à partir de l'étape 3 | 
| Secret du client | Le secret du consommateur à partir de l'étape 3 | 
| URL du jeton | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/token | 
| URL d'autorisation | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/authorize | 
| URL de redirection | Pre-filled (ne changez pas) | 

Choisissez **Suivant** pour continuer.

## Étape 5 : vérifier et publier
<a name="salesforce-verify-publish"></a>

1. Sur la page **Révision**, vérifiez les actions Salesforce disponibles (jusqu'à 42 actions).

1. Choisissez **Next** pour passer au partage utilisateur.

1. Sélectionnez les utilisateurs ou les groupes qui devraient avoir accès à ce connecteur.

1. Choisissez **Publier** pour publier le connecteur.

Après avoir publié le connecteur, vous pouvez utiliser les actions Salesforce dans le chat, les flux et les automatisations Amazon Quick.

## Actions disponibles
<a name="salesforce-integration-actions"></a>

Après avoir configuré le connecteur, les actions Salesforce suivantes sont disponibles :
+ 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.

**Note**  
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.

## Résolution des problèmes
<a name="salesforce-integration-troubleshooting"></a>

Pour modifier, partager ou supprimer votre connecteur, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).
+ **Erreur « L'URL n'existe plus »** : assurez-vous d'utiliser le bon domaine Salesforce dans l'URL du jeton et dans l'URL d'autorisation. N'utilisez pas d'anciens terminaux.
+ **Échec de la validation OAuth** : vérifiez que PKCE est activé sur l'ECA et que l'URL de rappel correspond exactement à l'URL de votre instance Amazon Quick ajoutée. `/sn/oauthcallback`
+ **Erreur relative aux étendues manquantes** **: revenez à la configuration ECA dans Salesforce et assurez-vous que toutes les étendues OAuth requises figurent dans la liste **Sélectionnées** et qu'elles ne sont pas encore disponibles.**
+ L'**option « Application connectée » est grisée** : elle est attendue après Salesforce Spring '26. Utilisez plutôt une application client externe. Les ECA sont les appareils de remplacement pris en charge.