> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fincome.co/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).

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

![](https://storage.crisp.chat/users/helpdesk/website/-/7/7/0/2/77027aa2db8a2800/c3d602ef-1fba-49dd-a44f-a1b837_d00vif.png)

3. Dans la barre **Quick Find**, tapez `External`.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/e/b/1/7eb17357e1f87400/d00b3d18-e968-43e4-b083-7256b7_1dzvc72.png)

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).

![](https://storage.crisp.chat/users/helpdesk/website/-/8/5/9/1/8591b1c212f4c800/84a862af-5d7c-43b1-882b-957ec9_ai4eiy.png)

###### É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__**

![](https://storage.crisp.chat/users/helpdesk/website/-/7/0/8/8/708849fae2767000/91ae13d1-cfa0-4a93-acac-cc74ae_mwioxj.png)

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.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/0/3/7/5037570e93660c00/97e8c7f8-a35b-4f0a-b66a-c8f92a_r7x7fg.png)

###### É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**.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/b/c/7/bbc792c622fb6000/9e73423e-5676-4bd6-a6ad-e3f7e6_15be6gn.png)
3. Faites défiler jusqu'à la section **OAuth Settings**.
4. Cliquez sur **Consumer Key and Secret**.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/b/4/7/2b47857521a04600/3b07f5a7-78bd-43d1-9543-90557a_3cnife.png)
5. Salesforce peut vous demander de vérifier votre identité via un code envoyé par email — saisissez le code reçu.
6. Copiez les deux valeurs :
| Champs salesforce | Identifiant Fincome |
| ---- |
| **Consumer Key** | `secret_salesforce_client_id` |
| **Consumer Secret** | `secret_salesforce_client_secret` |

||| Traitez le Consumer Secret comme un mot de passe. Ne le partagez jamais publiquement et ne le publiez pas dans un dépôt public.


### 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. **Sept champs** sont à renseigner pour connecter la source et indiquer à Fincome **quelles propriétés Salesforce récupérer** et **comment les rattacher à vos clients**.

**__1. Nom de la source__**
Donnez un nom clair et **unique** à votre source (ex. : *Salesforce – Comptes*). Ce nom sert uniquement à identifier facilement la source dans Fincome.

**__2. Clé client de l'application externe Salesforce__**
Collez le **Consumer Key** (Client ID) récupéré sur votre External Client App à la Phase 1 (Étape 5).

**__3. Secret client de l'application externe Salesforce__**
Collez le **Consumer Secret** (Client Secret) de cette même application. Traitez-le comme un mot de passe.

**__4. ID de l'axe personnalisé sur Fincome à utiliser comme clé de correspondance__**
C'est l'**axe Fincome** avec lequel se fait le matching : celui qui contient l'**identifiant unique de vos clients** côté Fincome. Renseignez le **libellé** de cet axe.
**Exemple :** `Numéro de client` — l'axe qui contient le numéro/identifiant unique de chaque client dans votre référentiel.
C'est cette valeur qui sera comparée au champ Salesforce de l'étape suivante pour apparier chaque client au bon enregistrement Salesforce.

||| Cet axe doit déjà exister dans Fincome, sinon la synchronisation ne fonctionnera pas.

**__5. Champ Salesforce à utiliser comme clé de correspondance__**
C'est le **champ Salesforce** qui contient exactement la **même valeur** que l'axe ci-dessus, pour permettre la correspondance. Indiquez son **nom d'API exact**.
**Exemple :** `Numero_client__c` (ou `Id` si vous faites le matching sur le Record ID Salesforce — voir plus bas).
Fincome relie un client à un compte Salesforce dès que : **valeur de l'axe Fincome (champ 4) = valeur du champ Salesforce (champ 5)**.
L'identifiant utilisé de part et d'autre doit être **unique**, **exhaustif** sur l'ensemble de vos clients, et **strictement identique** entre Salesforce et Fincome (sans espace ni formatage).

**__6. Champs Salesforce (séparés par des virgules) à récupérer__**
Indiquez les **noms d'API exacts** des champs Salesforce à synchroniser, séparés par des virgules. Ils deviendront de nouveaux axes d'analyse dans Fincome.
**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`).

**__7. Préfixe des axes enrichis (facultatif)__**
Définissez un préfixe appliqué aux axes créés à partir des propriétés Salesforce, pour les repérer facilement et éviter les collisions de noms.

* **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`

Si aucun préfixe n'est renseigné et que les noms correspondent à des axes existants, Fincome fusionnera les axes.


### É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.

C'est l'une des valeurs les plus courantes à renseigner dans le champ **« Champ Salesforce à utiliser comme clé de correspondance »** (champ 5 de l'Étape 2) : indiquez alors `Id` côté Salesforce, en face de l'axe Fincome qui stocke ce même Record ID.

### 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.