Enrichir ses données avec Salesforce

Connectez Salesforce à Fincome en quelques clics et libérez tout le potentiel de vos données clients. En enrichissant vos axes Fincome avec les propriétés Salesforce, vous bénéficiez d'informations plus détaillées, d'une meilleure segmentation et d'analyses plus puissantes, le tout à partir d'une source CRM unique et unifiée.

Vous améliorez ainsi votre prise de décision grâce à des données enrichies automatiquement et maintenues à jour, pour une lecture plus fine et plus exploitable de votre base clients.

Conditions préalables

Avant de commencer, assurez-vous que les conditions suivantes sont remplies :

  • Vous disposez des autorisations nécessaires dans Salesforce pour :

    • Accéder à Setup et créer une External Client App

    • Consulter les objets CRM Salesforce que vous souhaitez synchroniser (ex. : Comptes)

  • Votre organisation Salesforce autorise l'authentification OAuth 2.0

Guide étape par étape : connecter Salesforce à Fincome

Connecter Salesforce à Fincome nécessite deux phases :

  1. Dans Salesforce – créer une External Client App (ECA) pour obtenir les identifiants OAuth.

  2. Dans Fincome – configurer la source d'enrichissement avec ces identifiants.


Phase 1 – Créer une External Client App dans Salesforce

Étape 1 – Accéder à l'External Client App Manager

  1. Connectez-vous à Salesforce avec un compte administrateur.

  2. Cliquez sur l'icône en forme de roue dentée (en haut à droite) et ouvrez Setup.

  3. Dans la barre Quick Find, tapez External.

  4. Sélectionnez External Client App Manager.

  5. Cliquez sur New External Client App.

Étape 2 – Renseigner les informations de base

Dans la section Basic Information, renseignez :

  • External Client App Name : un nom clair (ex. : Fincome).

  • API Name : généré automatiquement à partir du nom de l'application (ex. : Fincome). Vous pouvez conserver la valeur par défaut.

  • Contact Email : l'email de l'équipe qui gère l'intégration (utilisé par Salesforce pour vous contacter au sujet de l'application).

  • Distribution State : laissez sur Local (l'application n'est utilisée que par votre propre organisation).

Étape 3 – Configurer les paramètres OAuth

Activez API (Enable OAuth Settings), puis renseignez les champs suivants :

1. Callback URL

Indiquez l'URL de redirection fournie par Fincome :

Cette valeur correspond à l'OAUTH_REDIRECT_URL fournie par Fincome. Elle doit être strictement identique, sans espace ni caractère superflu.

2. OAuth Scopes

Ajoutez au minimum les scopes suivants à la liste Selected OAuth Scopes :

  • Manage user data via APIs (api) — permet à Fincome de lire vos données Salesforce via l'API.

  • Perform requests at any time (refresh_token, offline_access) — nécessaire pour que Fincome puisse renouveler son token d'accès sans vous demander de vous reconnecter.

3. Flow Enablement

  • Cochez Enable Authorization Code and Credentials Flow. Il s'agit du flux utilisé par le connecteur Fincome (OAuth 2.0 authorization code grant avec refresh tokens).

4. Security

  • Cochez Require Secret for Refresh Token Flow et Require Secret for Web Server Flow. Cela garantit que le client secret est requis lors de l'échange d'un refresh token, ce qui est le paramètre recommandé pour les intégrations serveur à serveur comme Fincome.

Étape 4 – Créer l'application

  1. Vérifiez votre configuration.

  2. Cliquez sur Create en bas de la page.

Salesforce crée l'External Client App et vous redirige vers sa page de détail.

Étape 5 – Récupérer vos identifiants

Vous devez maintenant copier le Consumer Key et le Consumer Secret que Fincome utilisera pour s'authentifier.

  1. Ouvrez votre application nouvellement créée depuis l'External Client App Manager.

  2. Allez dans l'onglet Settings.

  1. Faites défiler jusqu'à la section OAuth Settings.

  2. Cliquez sur Consumer Key and Secret.

  1. Salesforce peut vous demander de vérifier votre identité via un code envoyé par email — saisissez le code reçu.

  2. Copiez les deux valeurs :

Champ Salesforce
Identifiant Fincome

Consumer Key

secret_salesforce_client_id

Consumer Secret

secret_salesforce_client_secret

triangle-exclamation

Phase 2 – Configurer la source Salesforce dans Fincome

Étape 1 – Accéder aux paramètres

  1. Allez dans Réglages sur Fincome.

  2. Ouvrez l'onglet Sources de données.

  3. Cliquez sur Sources d'enrichissement.

  4. Sélectionnez Connecter une nouvelle source d'enrichissement.

  5. Choisissez Synchroniser une/des propriété(s) Salesforce.

Étape 2 – Configurer la source Salesforce

Une fenêtre de configuration s'ouvre avec les champs suivants :

1. Nom de la source

Donnez un nom clair et unique à votre source (ex. : Salesforce – Comptes). Ce nom permet d'identifier facilement la source dans Fincome.

2. Identifiants Salesforce

Collez les valeurs récupérées depuis votre External Client App :

  • Client ID → le Consumer Key de Salesforce.

  • Client Secret → le Consumer Secret de Salesforce.

3. Propriétés Salesforce à récupérer (séparées par des virgules)

Indiquez les noms d'API exacts des champs Salesforce à synchroniser.

Exemple : Industry, Phone, BillingCity

Comment trouver le nom d'API exact d'un champ :

  1. Dans Salesforce, ouvrez Setup.

  2. Allez dans Object Manager et sélectionnez l'objet (ex. : Account).

  3. Cliquez sur Fields & Relationships.

  4. Copiez la valeur de la colonne Field Name (il s'agit du nom d'API, ex. : Industry ou Custom_Segment__c).

4. Nom de l'axe d'identification Salesforce dans Fincome

Indiquez l'axe Fincome qui contient l'identifiant utilisé pour faire le matching avec Salesforce.

Par défaut, il s'agit du Record ID Salesforce (l'identifiant à 15 ou 18 caractères, ex. : 0015g00000XyZabAAB), mais vous pouvez également utiliser un autre champ Salesforce (par exemple un identifiant client interne), à condition que :

  • l'identifiant soit unique

  • l'identifiant soit exhaustif sur l'ensemble de vos clients

  • la valeur soit strictement identique entre Salesforce et Fincome

L'objectif est d'utiliser un identifiant commun, fiable et cohérent entre toutes les sources utilisées dans Fincome.

triangle-exclamation

5. Préfixe des axes (facultatif)

Définissez un préfixe pour les axes créés à partir des propriétés Salesforce.

  • Sans préfixe personnalisé :

    • Préfixe par défaut : Salesforce_xxxxxx_

    • Exemple : Salesforce_726564_Industry

  • Avec préfixe personnalisé :

    • Préfixe : _Axis

    • Exemple : Salesforce_AxisIndustry

triangle-exclamation

Étape 3 – Finaliser la connexion

  1. Cliquez sur Valider.

  2. Vous êtes redirigé vers Salesforce.

  3. Connectez-vous avec le compte Salesforce à connecter.

  4. Vérifiez et acceptez les autorisations demandées (api, refresh_token).

  5. Cliquez sur Allow.

Vérification finale

Retournez dans Réglages → Sources de données → Sources d'enrichissement et vérifiez que votre source Salesforce apparaît comme active.

*Qu'est-ce qu'un Record ID et où le trouver dans Salesforce

Un Record ID est l'identifiant unique attribué par Salesforce à chaque fiche — ici, un Compte. Il existe sous deux formats :

  • ID à 15 caractères (sensible à la casse) : visible dans l'URL de la fiche.

  • ID à 18 caractères (insensible à la casse) : renvoyé par l'API et les exports. Les deux pointent vers la même fiche.

Fincome peut utiliser cet identifiant pour faire correspondre un client Fincome (via un axe analytique) au bon compte Salesforce, afin de synchroniser correctement les propriétés CRM.

Où trouver le Record ID dans Salesforce (Comptes)

  1. Connectez-vous à Salesforce.

  2. Ouvrez l'onglet Comptes (ou utilisez App Launcher → Comptes).

  3. Cliquez sur le compte concerné pour ouvrir sa fiche.

  4. Regardez la barre d'adresse du navigateur : le Record ID apparaît dans l'URL.

Exemple d'URL : https://your-org.lightning.force.com/lightning/r/Account/0015g00000XyZabAAB/view 👉 Dans cet exemple, 0015g00000XyZabAAB correspond au Record ID.

Autres façons d'obtenir le Record ID

  • Depuis un rapport ou une vue de liste Salesforce, ajoutez la colonne Account ID.

  • Lors d'un export Salesforce (Data Export ou Data Loader), incluez la colonne Id.

  • Via l'API REST Salesforce, le Record ID correspond au champ Id.

Bonnes pratiques pour la synchronisation avec Fincome

  • Vérifiez que le Record ID enregistré dans Fincome est strictement identique à celui de Salesforce (sans espace ni formatage).

  • Privilégiez l'ID à 18 caractères pour éviter les problèmes de sensibilité à la casse lors du matching.

  • Pour des volumes importants, il est recommandé d'exporter les comptes Salesforce avec leurs IDs, puis de mettre à jour les axes Fincome en masse.

⚠️ Si l'identifiant enregistré dans Fincome ne correspond pas à celui de Salesforce, l'enrichissement ne pourra pas fonctionner.

FAQ

Quel type de données Salesforce puis-je enrichir dans Fincome ? Vous pouvez synchroniser tous les champs de compte Salesforce auxquels vous avez accès : secteur, taille, localisation, champs personnalisés (__c), etc.


Que se passe-t-il si l'axe d'identification n'existe pas dans Fincome ? La synchronisation échouera. L'axe doit impérativement être créé en amont.


Que se passe-t-il si le nom d'API d'un champ Salesforce est incorrect ? La synchronisation s'exécute, mais les axes concernés seront remplis avec la valeur None.


Que se passe-t-il si je révoque l'External Client App dans Salesforce ? La synchronisation s'arrêtera immédiatement. Vous devrez reconnecter la source dans Fincome, éventuellement avec de nouveaux identifiants.


À quelle fréquence les données sont-elles mises à jour ? Les données sont mises à jour quotidiennement.

Mis à jour