Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cashmyrr.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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éServiceDescription
1FullEnrichAgrégateur multi-sources, couverture mondiale
2KasprSpécialiste du téléphone professionnel B2B
3ZeliqDonnées de contact enrichies pour la prospection
4AirScaleEnrichissement multi-providers, fallback final
Pour l’e-mail :
PrioritéServiceDescription
1FullEnrichClé partagée avec l’enrichissement téléphone
2EnrowRecherche et vérification d’e-mails professionnels
3IcypeasEnrichissement e-mail à haute précision
4AirScaleClé partagée avec l’enrichissement téléphone
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.

​
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 interneUsage
Statut enrichissement téléphoneenrich_contact_phone_statusStatut de la dernière demande téléphone
Statut enrichissement e-mailenrich_contact_email_statusStatut 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éePropriété par défautSens
LinkedIn URLhs_linkedin_urlLecture + écriture
E-mailemailLecture + écriture
TéléphonephoneÉcriture
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.
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.

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