# Enrichir ses données avec HubSpot

Connectez HubSpot à 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 HubSpot, 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 pour consulter les objets HubSpot CRM suivants :
  * **Entreprises**
* Une connexion **OAuth** est activée sur HubSpot
* Votre compte **Fincome est actif**
* L'accès à l'entité **Clients** est activé dans Fincome

### Guide étape par étape : connecter HubSpot à 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) HubSpot**.

#### Étape 2 – Configurer la source HubSpot

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. : *HubSpot – Entreprises*).\
Ce nom permet d'identifier facilement la source dans Fincome.

**2. Propriétés HubSpot à récupérer (séparées par des virgules)**

Indiquez les **libellés exacts** des propriétés HubSpot à synchroniser.

**Exemple :**\
`Secteur d'activité, Numéro de téléphone, Ville`

**Comment trouver le libellé exact d'une propriété :**

1. Allez dans **Paramètres HubSpot**
2. Ouvrez **Gestion des données → Propriétés**
3. Sélectionnez l'objet **Entreprise**
4. Cliquez sur la propriété souhaitée
5. Copiez le champ **Libellé de la propriété**

**3. Nom de l'axe d'identification HubSpot dans Fincome**

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

Par défaut, il s'agit du **Record ID HubSpot\***, mais vous pouvez également utiliser **une autre propriété HubSpot** (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 HubSpot et Fincome

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

{% hint style="danger" %}
Cet axe doit déjà exister dans Fincome, sinon la synchronisation ne fonctionnera pas.
{% endhint %}

**4. Préfixe des axes (facultatif)**

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

* **Sans préfixe personnalisé** :
  * Préfixe par défaut : `HubSpot_xxxxxx_`
  * Exemple : `HubSpot_726564_Secteur d'activité`
* **Avec préfixe personnalisé** :
  * Préfixe : `_Axis`
  * Exemple : `HubSpot_AxisSecteur d'activité`

{% hint style="danger" %}
Si aucun préfixe n'est renseigné et que les noms correspondent à des axes existants, Fincome fusionnera les axes.
{% endhint %}

#### Étape 3 – Finaliser la connexion

6. Cliquez sur **Valider**.
7. Vous êtes redirigé vers HubSpot.
8. Sélectionnez le compte HubSpot à connecter.
9. Acceptez les autorisations demandées.
10. Cliquez sur **Connecter l'application**.

### Vérification finale

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

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

Un **Record ID** (également appelé *HubSpot Record ID* ou *Object ID*) est l'identifiant unique attribué par HubSpot à chaque fiche CRM — ici, une **Entreprise**.

Fincome peut utiliser cet identifiant pour faire correspondre un client Fincome (via un axe analytique) à la bonne entreprise HubSpot, afin de synchroniser correctement les propriétés CRM.

**Où trouver le Record ID dans HubSpot (Entreprises)**

1. Connectez-vous à HubSpot.
2. Ouvrez le menu **Contacts → Entreprises**.
3. Cliquez sur l'entreprise concernée pour ouvrir sa fiche.
4. Regardez la barre d'adresse du navigateur : le Record ID apparaît dans l'URL.

**Exemple d'URL :**\
`https://app.HubSpot.com/contacts/XXXX/record/XXXX/1234567890`\
👉 Dans cet exemple, `1234567890` correspond au **Record ID**.

**Autres façons d'obtenir le Record ID**

* Depuis la fiche entreprise, ouvrez **Modifier les propriétés** et recherchez la propriété `Record ID`.
* Lors d'un export HubSpot (Contacts → Entreprises → Export), incluez la colonne **Object ID** ou **Company ID**.
* Via l'API HubSpot (CRM Objects API v3), 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 HubSpot (sans espace ni formatage).
* La propriété `hs_object_id` utilisée par HubSpot dans les API correspond au même identifiant.
* Pour des volumes importants, il est recommandé d'exporter les entreprises HubSpot avec leurs Object IDs, puis de mettre à jour les axes Fincome en masse.

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

#### FAQ

→ **Quel type de données HubSpot puis-je enrichir dans Fincome ?**\
Vous pouvez synchroniser toutes les propriétés d'entreprise HubSpot auxquelles vous avez accès : secteur, taille, localisation, attributs personnalisés, etc.

***

→ **Puis-je modifier les propriétés après la configuration ?**\
Oui, mais les anciennes données ne seront pas resynchronisées. Pour un changement structurel, il est recommandé de créer un nouveau connecteur.

***

→ **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 libellé d'une propriété HubSpot est incorrect ?**\
La synchronisation s'exécute, mais les axes concernés seront remplis avec la valeur `None`.

***

→ **Mes données Fincome existantes sont-elles impactées ?**\
Non, sauf en cas de fusion volontaire d'axes portant exactement le même nom.

***

→ **À quelle fréquence les données sont-elles mises à jour ?**\
La fréquence dépend de votre forfait Fincome et de la configuration de synchronisation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.fincome.co/guide/enrichir-sa-donnee-avec-les-crm/enrichir-ses-donnees-avec-hubspot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.