Documentation

Guide d’intégration HubSpot

Connectez votre compte HubSpot à Clareefai pour importer vos contacts comme promoteurs, renvoyer les parrainages dans votre pipeline et cibler vos campagnes avec les listes que vous utilisez déjà.

Dernière mise à jour : 28 juillet 2026

1. Avant de commencer

Trois éléments sont nécessaires avant de vous connecter :

  • Un compte vendeur Clareefai. Connectez-vous à l’application vendeur Clareefai. Si vous n’avez pas encore de compte, demandez un accès depuis le site Clareefai.
  • L’autorisation d’installer des applications dans HubSpot. Votre utilisateur HubSpot doit être autorisé à installer des applications — généralement un Super administrateur, ou tout utilisateur disposant de cette permission.
  • Des contacts HubSpot avec une adresse e-mail. Clareefai identifie les promoteurs par leur adresse e-mail : les contacts qui n’en ont pas ne peuvent pas être importés.

2. Connecter HubSpot

La connexion prend environ une minute. Rien à configurer, aucune clé d’API à copier, aucun code à installer.

  1. 1

    Ouvrez Import CRM

    Dans l’application vendeur Clareefai, allez dans Promoteurs, puis Import CRM.

  2. 2

    Choisissez HubSpot

    Sélectionnez la carte HubSpot parmi les sources d’import disponibles.

  3. 3

    Autorisez l’accès

    Cliquez sur Se connecter à HubSpot. Vous êtes redirigé vers HubSpot, où vous choisissez le compte à connecter et examinez les autorisations demandées par Clareefai.

  4. 4

    Confirmez

    Après votre approbation, HubSpot vous renvoie vers Clareefai. La page affiche alors Connecté à HubSpot ainsi que votre ID Hub.

Clareefai conserve un jeton d’accès chiffré, rattaché uniquement à votre compte. Les jetons sont renouvelés automatiquement en arrière-plan et ne sont jamais exposés à votre navigateur.

Application vendeur : vendor.clareefai.com

3. Les autorisations expliquées

Clareefai demande deux groupes d’autorisations. Seul le groupe obligatoire est nécessaire pour établir la connexion. Le groupe facultatif active l’écriture vers HubSpot et le ciblage des campagnes — vous pouvez le refuser, la connexion fonctionnera quand même.

Obligatoire pour se connecter

  • oauth

    Autorisation standard utilisée par HubSpot pour établir la connexion.

  • crm.objects.contacts.read

    Lire vos contacts afin que vous puissiez les parcourir, les rechercher et choisir ceux à importer dans Clareefai.

  • crm.schemas.contacts.read

    Lire la définition de vos propriétés de contact — noms et libellés uniquement, jamais les valeurs des enregistrements — pour construire l’étape de mappage des champs.

Facultatif

  • crm.objects.contacts.write

    Créer un contact dans HubSpot lorsque vous envoyez un parrainage. Sans cette autorisation, l’envoi de parrainages est indisponible.

  • crm.objects.deals.write

    Créer le deal associé à un parrainage envoyé. Sans cette autorisation, le contact est bien créé mais aucun deal n’apparaît.

  • crm.lists.read

    Lire vos listes de contacts pour les utiliser comme audience d’enquête. Sans cette autorisation, vos listes HubSpot n’apparaissent pas lors de l’envoi d’une enquête.

Refuser une autorisation facultative ne bloque jamais la connexion — la fonctionnalité correspondante est simplement indisponible. Pour l’accorder plus tard, déconnectez-vous puis reconnectez-vous en l’approuvant sur l’écran d’autorisation HubSpot.

4. Importer des contacts comme promoteurs

L’assistant d’import se déroule en six étapes. Rien n’est enregistré dans Clareefai avant la dernière, vous pouvez donc abandonner à tout moment.

  1. 1

    Source

    Choisissez HubSpot comme source d’import.

  2. 2

    Connexion

    Connectez votre compte HubSpot, ou passez directement à la suite si vous êtes déjà connecté.

  3. 3

    Sélection

    Cliquez sur Récupérer les contacts et continuer pour charger vos contacts dans un tableau consultable. Recherchez ou triez par nom, e-mail, entreprise, poste, étape du cycle de vie ou téléphone, ajustez le nombre de lignes affichées et cochez exactement les contacts souhaités.

  4. 4

    Mappage

    Vos champs HubSpot sont associés automatiquement aux champs Clareefai. Vérifiez ce mappage et ajustez ce que vous souhaitez.

  5. 5

    Vérification

    Contrôlez le nombre d’enregistrements valides et les éventuelles anomalies avant de valider.

  6. 6

    Terminé

    Cliquez sur Enregistrer les contacts. Votre sélection est importée et apparaît dans Promoteurs.

Les contacts que vous ne pourrez pas sélectionner

  • Aucune adresse e-mail. Clareefai identifie les promoteurs par e-mail : ces lignes ne peuvent pas être importées.
  • Déjà importé. Le contact est déjà présent dans Clareefai. C’est ce qui empêche les imports répétés de créer des doublons.

  • Chaque enregistrement importé porte un badge HubSpot dans votre liste de promoteurs : vous savez toujours d’où il vient.

  • Les sélections volumineuses sont importées par lots automatiquement — vous n’avez jamais besoin de les découper vous-même.

  • Une récupération charge jusqu’à 5 000 contacts. Si votre compte en contient davantage, utilisez la recherche pour cibler les personnes qui vous intéressent.

5. Envoyer des parrainages vers HubSpot

Lorsqu’un promoteur vous apporte un parrainage qualifié, vous pouvez l’envoyer directement dans HubSpot afin que votre équipe commerciale le traite dans le pipeline qu’elle utilise déjà.

  1. 1

    Ouvrez le parrainage

    Allez dans Parrainages dans l’application vendeur et ouvrez celui que vous souhaitez envoyer.

  2. 2

    Envoyez vers HubSpot

    Dans le panneau Intégration CRM, cliquez sur Envoyer vers HubSpot.

  3. 3

    Vérifiez le résultat

    Le panneau confirme l’envoi et affiche le nouvel ID Contact et l’ID Deal HubSpot, ce qui vous donne une traçabilité complète du promoteur jusqu’à l’opportunité.

Ce qui est créé dans HubSpot

  • Un contact. Créé avec le prénom, le nom, l’adresse e-mail et l’entreprise de la personne recommandée.
  • Un deal. Nommé d’après la personne recommandée, placé dans votre pipeline par défaut à l’étape Rendez-vous planifié, et associé au contact ci-dessus.

L’envoi est toujours manuel et toujours parrainage par parrainage — Clareefai n’envoie jamais rien automatiquement. Vos enregistrements HubSpot existants ne sont jamais modifiés ni supprimés.

6. Cibler vos enquêtes avec vos listes HubSpot

Réutilisez la segmentation que vous avez déjà construite. Lors de l’envoi d’une enquête de satisfaction ou d’une campagne, vous pouvez cibler vos listes de contacts HubSpot existantes au lieu de reconstruire l’audience.

  1. 1

    Ouvrez une enquête

    Allez dans Enquêtes, ouvrez celle que vous voulez envoyer, puis cliquez sur Envoyer.

  2. 2

    Choisissez Importer depuis le CRM comme source de destinataires

    Vos listes de contacts HubSpot apparaissent, chacune avec son nombre de contacts.

  3. 3

    Sélectionnez vos listes

    Cochez une ou plusieurs listes. Le total de destinataires se met à jour au fur et à mesure : vous savez exactement combien de personnes vous allez toucher.

Cette étape nécessite l’autorisation facultative sur les listes de contacts. Si vous l’avez refusée, aucune liste HubSpot n’apparaîtra ici — déconnectez-vous puis reconnectez-vous en l’approuvant pour activer cette fonctionnalité.

7. Se déconnecter

Vous pouvez déconnecter HubSpot à tout moment, directement depuis Clareefai.

  1. 1

    Ouvrez Import CRM

    Allez dans Promoteurs, puis Import CRM, et sélectionnez HubSpot. L’état connecté affiche votre ID Hub.

  2. 2

    Déconnectez

    Cliquez sur Déconnecter et confirmez.

Ce qui se passe à la déconnexion

  • Vos identifiants HubSpot enregistrés sont supprimés de Clareefai immédiatement.
  • Les contacts déjà importés restent dans Clareefai — ce sont vos données, la déconnexion ne les supprime pas.
  • Les enregistrements déjà envoyés par Clareefai dans HubSpot y restent et ne sont jamais modifiés.
  • Vous pouvez vous reconnecter à tout moment ; les autorisations vous seront redemandées.
  • Vous pouvez aussi retirer Clareefai depuis les paramètres des applications connectées dans HubSpot, avec le même effet.

8. Résolution des problèmes

Clareefai indique que HubSpot n’est pas connecté alors que je l’ai connecté.
La connexion a été supprimée du côté HubSpot — l’application a été désinstallée ou son accès révoqué. Reconnectez-vous depuis Promoteurs, puis Import CRM.
Une fonctionnalité est indisponible, ou une action me demande de me reconnecter.
L’autorisation facultative dont dépend cette fonctionnalité a été refusée lors de l’autorisation. Déconnectez-vous puis reconnectez-vous en l’approuvant sur l’écran HubSpot.
Je ne peux pas sélectionner un contact dans le tableau d’import.
Le contact n’a pas d’adresse e-mail, ou il a déjà été importé dans Clareefai. Les deux cas sont indiqués directement sur la ligne.
Tous mes contacts n’apparaissent pas dans le tableau.
Une récupération charge jusqu’à 5 000 contacts. Si votre compte en contient davantage, utilisez la recherche pour trouver les personnes précises à importer.
L’envoi d’un parrainage vers HubSpot a échoué.
HubSpot refuse la création d’un contact lorsqu’un contact avec la même adresse e-mail existe déjà. Si la personne recommandée est déjà dans votre CRM, ajoutez manuellement les informations du parrainage à cet enregistrement, ou contactez l’assistance et nous vous aiderons.
Le contact du parrainage a été créé, mais aucun deal n’est apparu.
L’autorisation facultative sur les deals n’a pas été accordée, ou HubSpot a refusé le deal. Reconnectez-vous en approuvant l’accès aux deals — le contact existant déjà, créez le deal manuellement si nécessaire.
Puis-je changer le pipeline ou l’étape du deal créé ?
Pas encore. Les deals de parrainage sont toujours créés dans votre pipeline par défaut à l’étape Rendez-vous planifié. Vous pouvez ensuite les déplacer librement dans HubSpot.

9. Assistance

Toujours bloqué, ou vous souhaitez une fonctionnalité que l’intégration ne propose pas encore ? Nous répondons à chaque message et lisons chaque demande.

support@clareefai.comNous contacterPolitique de confidentialité