# Introduction
Source: https://docs.cashmyrr.com/hubspot-tools/enrich-contact/index

Enrichissez automatiquement les numéros de téléphone et les adresses e-mail de vos contacts HubSpot grâce à plusieurs services d'enrichissement.

## Présentation

**Enrich Contact** est une application HubSpot qui enrichit les fiches contacts de votre CRM en retrouvant automatiquement les numéros de téléphone et les adresses e-mail manquants ou incomplets.

L'application interroge plusieurs services d'enrichissement en cascade — dans un ordre de priorité que vous définissez — et met à jour les propriétés du contact dès qu'une donnée est trouvée.

## Cas d'usage

* **Compléter une base de contacts incomplète** : un contact importé sans téléphone ni e-mail peut être enrichi en un clic depuis sa fiche HubSpot.
* **Enrichissement en masse** : déclenchez l'enrichissement sur des listes entières de contacts via les propriétés de statut, sans intervention manuelle.
* **Vérification d'e-mails** : retrouvez ou validez l'adresse e-mail professionnelle d'un contact à partir de son nom et de son entreprise.
* **Prospection commerciale** : alimentez vos séquences de prospection avec des données de contact fraîches et vérifiées.

## Comment ça fonctionne

### Services d'enrichissement

L'application s'appuie sur plusieurs fournisseurs de données spécialisés. Vous configurez vos clés API dans les paramètres de l'application, et les services sont interrogés dans l'ordre de priorité jusqu'à ce qu'un résultat soit trouvé.

**Pour le téléphone :**

| Priorité | Service                               | Description                                      |
| -------- | ------------------------------------- | ------------------------------------------------ |
| 1        | [FullEnrich](https://fullenrich.com/) | Agrégateur multi-sources, couverture mondiale    |
| 2        | [Kaspr](https://www.kaspr.io/fr/)     | Spécialiste du téléphone professionnel B2B       |
| 3        | [Zeliq](https://www.zeliq.com/fr)     | Données de contact enrichies pour la prospection |
| 4        | [AirScale](https://airscale.io/)      | Enrichissement multi-providers, fallback final   |

**Pour l'e-mail :**

| Priorité | Service                               | Description                                        |
| -------- | ------------------------------------- | -------------------------------------------------- |
| 1        | [FullEnrich](https://fullenrich.com/) | Clé partagée avec l'enrichissement téléphone       |
| 2        | [Enrow](https://enrow.io/)            | Recherche et vérification d'e-mails professionnels |
| 3        | [Icypeas](https://www.icypeas.com/)   | Enrichissement e-mail à haute précision            |
| 4        | [AirScale](https://airscale.io/)      | Clé partagée avec l'enrichissement téléphone       |

<Info>
  Les clés API **FullEnrich** et **AirScale** sont partagées entre l'enrichissement téléphone et l'enrichissement e-mail. Une seule clé suffit pour les deux usages dans chaque cas.
</Info>

### Flux d'enrichissement

```
Contact HubSpot
       │
       ▼
 Déclenchement (carte CRM ou propriété de statut)
       │
       ▼
 Service 1 interrogé ──► Trouvé ? ──► Propriété mise à jour dans HubSpot
       │ Non
       ▼
 Service 2 interrogé ──► Trouvé ? ──► Propriété mise à jour dans HubSpot
       │ Non
       ▼
 Service 3 interrogé ──► Trouvé ? ──► Propriété mise à jour dans HubSpot
       │ Non
       ▼
    Échec enregistré
```

Dès qu'un service retourne un résultat, les services suivants ne sont pas interrogés. La fiche HubSpot est automatiquement rafraîchie avec les nouvelles données.

### Propriétés CRM créées

L'application crée automatiquement les propriétés suivantes sur l'objet **Contact** dans votre HubSpot :

| Propriété                       | Nom interne                   | Usage                                   |
| ------------------------------- | ----------------------------- | --------------------------------------- |
| Statut enrichissement téléphone | `enrich_contact_phone_status` | Statut de la dernière demande téléphone |
| Statut enrichissement e-mail    | `enrich_contact_email_status` | Statut de la dernière demande e-mail    |

Ces propriétés sont également utilisées pour déclencher l'enrichissement en masse via des listes ou des workflows HubSpot.

### Propriétés lues et écrites

Par défaut, l'application lit le LinkedIn URL et l'e-mail du contact pour interroger les services, et écrit les résultats dans les propriétés HubSpot standard :

| Donnée       | Propriété par défaut | Sens               |
| ------------ | -------------------- | ------------------ |
| LinkedIn URL | `hs_linkedin_url`    | Lecture + écriture |
| E-mail       | `email`              | Lecture + écriture |
| Téléphone    | `phone`              | Écriture           |

<Info>
  L'écriture du LinkedIn URL n'est effectuée que lorsque **FullEnrich** retourne un profil LinkedIn et que le contact n'en avait pas déjà un — l'application enrichit alors la propriété en même temps que le téléphone ou l'e-mail.
</Info>

Si votre portail HubSpot utilise des propriétés personnalisées (par exemple `linkedin_profile` au lieu de `hs_linkedin_url`), vous pouvez les remapper depuis la page de paramètres — voir la section *Property Mapping* du [démarrage rapide](/hubspot-tools/enrich-contact/quickstart#2-configuration-des-cl%C3%A9s-api).

### Prérequis sur le contact

Pour qu'un enrichissement puisse s'exécuter, le contact doit être **associé à une entreprise (Company)** dans HubSpot. L'application utilise le domaine et le nom de l'entreprise pour augmenter la précision des recherches. Si aucune entreprise n'est associée, les boutons d'enrichissement sont désactivés sur la carte CRM.

### Suivi en temps réel

La carte CRM affiche le statut de chaque enrichissement en direct :

* **Running...** — enrichissement en cours
* **Enriched (Service)** — données trouvées par le service indiqué
* **Failed** — aucun service n'a trouvé de résultat
* **Not requested** — aucune demande effectuée pour ce contact

Un historique des tentatives par service est accessible directement depuis la carte via le lien *View last enrichment events*. Pour chaque fournisseur, le panneau affiche son statut, l'horodatage, ainsi que la requête envoyée et la réponse brute reçue — pratique pour déboguer un échec ou auditer la qualité de chaque fournisseur.

## Architecture technique

L'application est composée de trois éléments :

1. **Cartes CRM HubSpot** — interfaces React embarquées dans la fiche contact (vue aperçu et sidebar) pour déclencher l'enrichissement et suivre son avancement.
2. **Page de paramètres HubSpot** — interface de configuration des clés API par service d'enrichissement.
3. **Backend** — serveur Node.js qui orchestre les appels aux différents services d'enrichissement et met à jour les propriétés du contact via l'API HubSpot.

Les webhooks HubSpot permettent au backend d'écouter les changements de propriétés et de déclencher l'enrichissement automatiquement en mode bulk.


# Utilisation
Source: https://docs.cashmyrr.com/hubspot-tools/enrich-contact/quickstart

Installez et configurez Enrich Contact dans votre HubSpot en quelques minutes.

## 1. Installation

Connectez l'application à votre portail HubSpot en cliquant sur le bouton ci-dessous. Vous serez redirigé vers HubSpot pour autoriser les permissions nécessaires.

<Card title="Installer Enrich Contact" icon="plug" href="https://hub.cashmyrr.com/tools/enrich-contact">
  Autoriser Enrich Contact sur votre portail HubSpot
</Card>

### Permissions requises

Lors de l'installation, HubSpot vous demande d'autoriser les accès suivants :

| Permission                   | Utilisation                                            |
| ---------------------------- | ------------------------------------------------------ |
| `crm.objects.contacts.read`  | Lire les propriétés du contact à enrichir              |
| `crm.objects.contacts.write` | Mettre à jour le téléphone, l'e-mail et les statuts    |
| `crm.schemas.contacts.write` | Créer les propriétés de statut sur l'objet Contact     |
| `crm.objects.companies.read` | Lire l'entreprise associée pour améliorer la précision |
| `oauth`                      | Authentification sécurisée                             |

***

## 2. Configuration des clés API

Une fois l'application installée, rendez-vous dans **Paramètres → Intégrations → Applications connectées → Enrich Contact → Paramètres** pour configurer vos clés API.

<img alt="Page de paramètres Enrich Contact — configuration des clés API" />

Renseignez les clés API pour chacun des services que vous souhaitez activer :

**Enrichissement téléphone** (ordre de priorité) :

1. FullEnrich
2. Kaspr
3. Zeliq
4. AirScale

**Enrichissement e-mail** (ordre de priorité) :

1. FullEnrich *(clé partagée avec le téléphone)*
2. Enrow
3. Icypeas
4. AirScale *(clé partagée avec le téléphone)*

<Info>
  Vous n'êtes pas obligé de configurer tous les services. L'application utilisera uniquement les services pour lesquels une clé API est renseignée.
</Info>

### Property Mapping (optionnel)

Par défaut, l'application lit et écrit les données dans les propriétés HubSpot standard. Si votre portail utilise des propriétés personnalisées, vous pouvez les remapper depuis la même page de paramètres.

<img alt="Section Property Mapping de la page de paramètres Enrich Contact avec les champs LinkedIn URL Property, Email Property et Phone Property" />

| Champ                 | Propriété par défaut | Rôle                                                                                                                    |
| --------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| LinkedIn URL Property | `hs_linkedin_url`    | Lecture + écriture du profil LinkedIn (écriture uniquement si FullEnrich retourne un profil que le contact n'avait pas) |
| Email Property        | `email`              | Lecture + écriture de l'e-mail                                                                                          |
| Phone Property        | `phone`              | Écriture du téléphone                                                                                                   |

Laissez un champ vide pour conserver la valeur par défaut. Les valeurs déjà configurées sont indiquées par la mention **(Configured)** ; les modifications non enregistrées par **(Modified \*)**.

### Enregistrer

Cliquez sur **Save All Changes** pour enregistrer en une seule fois les clés API et les éventuels mappings de propriétés modifiés.

***

## 3. Les cartes CRM

L'application ajoute deux cartes CRM directement sur les fiches contacts HubSpot.

### Carte Sidebar

La carte apparaît dans le panneau latéral de la fiche contact. Elle permet de lancer un enrichissement téléphone ou e-mail en un clic et d'en suivre l'avancement.

<img alt="Carte Enrich Contact dans la sidebar d'une fiche contact HubSpot" />

### Carte Aperçu (Preview)

La même carte est également disponible dans la vue d'aperçu rapide d'un contact, accessible sans ouvrir la fiche complète.

<img alt="Carte Enrich Contact dans la vue aperçu d'une fiche contact HubSpot" />

### Ajouter les cartes à vos vues

Si les cartes n'apparaissent pas, vous devez les ajouter manuellement depuis l'éditeur de vue HubSpot :

1. Ouvrez une fiche contact
2. Cliquez sur **Personnaliser** (icône de crayon en haut à droite)
3. Recherchez **Enrich Contact** dans la liste des cartes disponibles
4. Faites-la glisser dans la sidebar ou la zone d'aperçu
5. Enregistrez la vue

***

## 4. Enrichissement contact par contact

Depuis la fiche d'un contact, utilisez la carte Enrich Contact :

1. Cliquez sur **Enrich Phone** pour lancer l'enrichissement téléphone
2. Cliquez sur **Enrich Email** pour lancer l'enrichissement e-mail
3. Le statut s'affiche en temps réel : **Running...** puis **Enriched** ou **Failed**

<Warning>
  Le contact doit être **associé à une entreprise (Company)** dans HubSpot. Sans entreprise associée, les boutons **Enrich Phone** et **Enrich Email** sont désactivés et la carte affiche l'avertissement *"This contact must be associated with a company to be enriched."*
</Warning>

<Tip>
  HubSpot est automatiquement rafraîchi dès qu'une propriété est trouvée : le numéro de téléphone ou l'adresse e-mail apparaît immédiatement sur la fiche sans recharger la page.
</Tip>

Cliquez sur **View last enrichment events** pour consulter le détail des tentatives par service. Le panneau affiche, pour chaque fournisseur, son statut (*Not used*, *Not found*, *Found*), l'horodatage de la tentative ainsi que la **requête envoyée et la réponse brute reçue** — utile pour déboguer un échec ou comparer la qualité des fournisseurs.

<img alt="Panneau Last Enrichment Events History montrant le statut de chaque service, les payloads de requête et de réponse" />

***

## 5. Enrichissement en masse (Bulk)

Pour enrichir un grand nombre de contacts à la fois, utilisez les **propriétés de statut** créées par l'application et les outils natifs de HubSpot (listes, workflows, imports).

### Comment ça fonctionne

L'application écoute les changements sur deux propriétés du contact :

| Propriété                       | Nom interne                   | Valeur déclenchante |
| ------------------------------- | ----------------------------- | ------------------- |
| Statut enrichissement téléphone | `enrich_contact_phone_status` | `Request Scraping`  |
| Statut enrichissement e-mail    | `enrich_contact_email_status` | `Request Scraping`  |

Dès que l'une de ces propriétés est définie sur **`Request Scraping`**, l'enrichissement correspondant est déclenché automatiquement via webhook.

### Déclencher un enrichissement en masse

<Steps>
  <Step title="Créez une liste de contacts dans HubSpot">
    Filtrez vos contacts selon vos critères (ex. : sans numéro de téléphone, dans une liste d'import, etc.).
  </Step>

  <Step title="Modifiez la propriété de statut en masse">
    Depuis la liste, sélectionnez tous les contacts et utilisez **Actions → Modifier les propriétés** pour définir `enrich_contact_phone_status` ou `enrich_contact_email_status` sur la valeur **`Request Scraping`**.
  </Step>

  <Step title="L'enrichissement se déclenche automatiquement">
    Le webhook reçoit les événements de changement de propriété et démarre l'enrichissement pour chaque contact. Les propriétés `phone` et `email` sont mises à jour dès qu'une donnée est trouvée.
  </Step>
</Steps>

<img alt="Démarrer un enrichissement en masse pour e-mail" />

<Warning>
  Pour éviter les doublons, un enrichissement en cours pour un contact donné (dans les 5 dernières minutes) ne sera pas relancé, même si la propriété est de nouveau définie sur `Request Scraping`.
</Warning>

### Via un workflow HubSpot

Vous pouvez également automatiser l'enrichissement via un **Workflow HubSpot** :

1. Créez un workflow basé sur les contacts
2. Définissez votre déclencheur (import, création de contact, changement de propriété…)
3. Ajoutez une action **Modifier une propriété** : définissez `enrich_contact_phone_status` ou `enrich_contact_email_status` sur `Request Scraping`
4. Activez le workflow

L'enrichissement sera déclenché automatiquement pour chaque contact entrant dans le workflow.