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 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 :

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 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
• Connecter HubSpot

Mis à jour le : 18/06/2026