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

Il vous faut :

• un accès admin Salesforce (pour installer et autoriser l'application Katalyz) ;
• une org Salesforce avec l'accès aux appels Apex (Apex callouts) activé — c'est le seul prérequis strict.

Procédure d'installation complète

⚠️ Point critique — les deux côtés doivent utiliser le même email. Le compte admin Salesforce qui installe l'intégration et le compte Katalyz correspondant doivent partager exactement la même adresse email. Sans cela, les deux orgs ne peuvent pas être appariées.

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

1. Allez dans Paramètres → Intégrations.
2. Repérez la carte Salesforce dans la liste, cliquez sur Installer.

   
   

   Si le bouton Installer de la carte Salesforce est grisé, c'est que Salesforce n'est pas ouvert sur votre espace de travail — contactez le support.

3. Vous êtes redirigé vers Salesforce pour l'OAuth — connectez-vous avec un compte admin et autorisez la connexion.
4. À ce stade, Katalyz récupère l'Org ID de votre Salesforce et le relie à 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. Affecter le permission set

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

1. Setup → Permission Sets → Katalyz
2. Cliquez sur Manage assignments (gérer les affectations)
3. Add assignment → sélectionnez les utilisateurs concernés → Suivant → 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 :
4. • API key — la clé propre au client (demandez-la à votre contact Katalyz ; une par client)
   • Tenant — l'identifiant de tenant fourni par Katalyz

5. Ajouter le composant Katalyz à la page Opportunity (Lightning)

Pour que la liste des Espaces Katalyz s'affiche sur chaque opportunité :

1. Setup → Object Manager → Opportunity → Lightning Record Pages
2. Ouvrez Opportunity Record Page → Edit
3. Dans le champ de recherche de composants, tapez Katalyz Dealrooms List
4. Glissez-déposez le composant à l'emplacement souhaité sur la page → Enregistrer
5. Activation → Assign as Org Default (pour que le composant s'affiche 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 de l'opportunité :

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 l'appariement, créez un Espace Katalyz 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 finalise 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 également autoriser Salesforce depuis son propre profil pour que l'intégration fonctionne pleinement pour lui — ses propres actions (créer un Espace depuis une opportunité, mettre à jour un champ, synchronisation retour) s'authentifient alors avec ses propres permissions Salesforce.

1. Chaque utilisateur ouvre son profil.
2. Il clique sur Sign in with Salesforce (se connecter avec Salesforce) et autorise la connexion.
3. À partir de là, ses actions utilisent son propre token Salesforce.

Sans cette étape, l'intégration au niveau de l'organisation reste saine, mais les actions individuelles de cet utilisateur ne se synchronisent pas. Voir Mon CRM ne se synchronise pas pour le modèle complet à deux niveaux.

Les accès demandés par Katalyz

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

Après la connexion

Le mappage des champs pour Salesforce utilise la même interface que celle de HubSpot — même surface « Champs synchronisés », même parcours. La seule différence : il n'y a pas d'action « Import from CRM » côté Salesforce (contrairement à HubSpot). Voir Mappage et synchronisation des champs CRM pour l'interface ; tout ce qui y est décrit vaut aussi pour Salesforce.

Déconnecter

Paramètres → Intégrations → Salesforce → Désinstaller. Une intégration connectée porte une pastille verte sur sa carte.

Articles associés

• Salesforce : synchroniser les Espaces avec les opportunités, comptes et contacts
• Connecter HubSpot

Mis à jour le : 26/10/2026