> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connecter Salesforce

Connectez votre org Salesforce à Katalyz pour synchroniser les Espaces, les deals (opportunités), les comptes, les contacts et l'activité.

> ⚠️ Nécessite le rôle d'organisation **Admin**.

## Avant de commencer

Vous aurez besoin de :
* **Un accès admin Salesforce** (pour installer et autoriser l'application Katalyz).
* Une org Salesforce avec **l'accès aux Apex callouts** activé — c'est le seul prérequis strict.

## Procédure complète

> ⚠️ **Très important — la même adresse email doit être utilisée des deux côtés.** Le compte **admin Salesforce** qui installe l'intégration et le compte **Katalyz** correspondant doivent partager **exactement la même adresse email**. Sans ça, l'appairage des deux orgs ne se fait pas.

### 1. Activer l'intégration côté Katalyz

1. Allez dans **Paramètres → Intégrations**.
2. Trouvez **Salesforce** dans la liste, cliquez sur **Connecter**.
3. Vous êtes redirigé vers Salesforce pour l'OAuth ; connectez-vous avec un compte admin et autorisez la connexion.
4. À ce moment-là, Katalyz récupère **l'Org ID Salesforce** de votre instance et la rattache à votre espace de travail.

### 2. Installer le package Salesforce

Installez le package managé Katalyz dans votre org Salesforce :

* URL d'installation : `https://login.salesforce.com/packaging/installPackage.apexp?p0=04tJ7000000szEFIAY`
* **Clé du package** : `katalyzsalesforce`
* Choisissez **Install for all users** (installer pour tous les utilisateurs).

### 3. Assigner le permission set

Une fois le package installé, attribuez le permission set **Katalyz** aux utilisateurs qui doivent interagir avec l'intégration :

1. **Setup → Permission Sets → Katalyz**
2. Cliquez sur **Manage assignments**
3. **Add assignment** → sélectionnez les utilisateurs concernés → **Next** → **Assign**

### 4. Renseigner les Custom Settings

L'intégration a besoin de votre **clé d'API Katalyz** et de votre **tenant** :

1. **Setup → Custom Settings → Katalyz Org Credentials settings**
2. Cliquez sur **Manage**, puis **New**
3. Saisissez :
* **API key** — clé propre à votre client (demandez-la à votre référent Katalyz, elle est unique par client)
* **Tenant** — identifiant de tenant fourni par Katalyz

### 5. Ajouter le composant Katalyz à la page Opportunité (Lightning)

Pour que la liste des Espaces Katalyz apparaisse sur chaque opportunité :

1. **Setup → Object Manager → Opportunity → Lightning Record Pages**
2. Ouvrez **Opportunity Record Page** → **Edit**
3. Dans la barre de recherche du composant, tapez **Katalyz Dealrooms List**
4. **Drag-and-drop** le composant à l'emplacement souhaité sur la page → **Save**
5. **Activation** → **Assign as Org Default** (pour activer le composant par défaut sur toutes les opportunités)

### 6. Ajouter la Related List « Katalyz Dealroom Activities »

Pour faire remonter l'activité Katalyz dans la timeline des opportunités :

1. **Setup → Object Manager → Opportunity → Page Layouts**
2. Ouvrez le layout actif → section **Related Lists**
3. Ajoutez **Katalyz Dealroom Activities** → enregistrez

### 7. Activer le `client_id` en créant un premier Espace

Pour finaliser le rattachement, créez un Espace **depuis Salesforce** (depuis n'importe quelle opportunité, via le composant Katalyz que vous venez d'ajouter). Cette première création active le `client_id` côté Katalyz et termine la liaison.

### 8. Connexion au niveau utilisateur

Une fois l'intégration Salesforce activée au niveau de l'espace de travail, **chaque utilisateur doit aussi autoriser Salesforce depuis son propre profil** pour que l'intégration fonctionne pleinement pour lui — ses propres actions (création d'Espace depuis une opportunité, mise à jour de champ, sync rétroactive) s'authentifient alors avec ses propres droits Salesforce.

1. Chaque utilisateur ouvre **son profil**.
2. Il clique sur **Sign in with Salesforce** et autorise la connexion.
3. À partir de là, ses actions utilisent son propre jeton Salesforce.

Sans cette étape, l'intégration au niveau organisation reste saine mais les actions individuelles de cet utilisateur ne se synchronisent pas. Voir [Mon CRM ne se synchronise pas](https://katalyz.crisp.help/fr/article/mon-crm-ne-se-synchronise-pas-hubspot-salesforce-ay4ac0/) pour le détail des deux niveaux.

## Ce à quoi Katalyz demande l'accès

L'écran OAuth de Salesforce liste les scopes exacts demandés par Katalyz :

| Scope | Pourquoi Katalyz le demande |
| ---- |
| `api` | Permet à Katalyz d'utiliser les API Salesforce pour lire et mettre à jour les enregistrements CRM — Comptes, Contacts, Opportunités, Tâches, champs personnalisés, fichiers et les métadonnées CRM associées nécessaires à la synchronisation. |
| `refresh_token` | Permet à Katalyz de rafraîchir l'accès sans demander à l'utilisateur de se reconnecter à chaque expiration de jeton, pour que les jobs de sync en arrière-plan continuent à tourner. |

## Après la connexion

Le mapping des champs pour Salesforce utilise **la même interface que le mapping des champs HubSpot** — même surface « Champs synchronisés », même workflow. La seule différence : il n'y a **pas d'action « Importer depuis le CRM »** côté Salesforce (contrairement à HubSpot). Voir [Mapping et synchronisation des champs CRM](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/) pour l'interface ; tout ce qui y est décrit s'applique également à Salesforce.

## Se déconnecter

**Paramètres → Intégrations → Salesforce → Déconnecter**.

## Articles connexes
* [Salesforce : synchroniser Espaces avec opportunités, comptes et contacts](https://katalyz.crisp.help/fr/article/salesforce-synchroniser-espaces-avec-opportunites-comptes-et-contacts-d3q49w/)
* [Connecter HubSpot](https://katalyz.crisp.help/fr/article/connecter-hubspot-ihvxea/)