Connecter HubSpot
Le connecteur HubSpot vérifie les adresses email de vos contacts et écrit le résultat sur chaque fiche, sous forme de propriétés. Le principe commun à tous les connecteurs est décrit dans Connecteurs : principe.
1. Créer une clé de service HubSpot
Il faut être super administrateur du compte HubSpot, ou avoir la permission Accès aux outils de développement.
- Dans HubSpot, ouvrez Développement.
- Dans le menu de gauche, Clés → Clés de service, puis Créer une clé de service.
- Nommez-la, par exemple
YesWeCheck, et cochez ces droits :
| Droit | Sert à |
|---|---|
crm.objects.contacts.read | Lire les contacts et leur adresse |
crm.objects.contacts.write | Écrire le résultat sur les contacts |
crm.lists.read | Lister vos listes et leurs membres |
crm.lists.write | Créer et remplir la liste YWC – invalides |
crm.schemas.contacts.read | Vérifier les propriétés YesWeCheck |
crm.schemas.contacts.write | Créer les propriétés YesWeCheck |
Le droit communication_preferences.statuses.batch.write n'est utile que si vous activez l'option Désinscrire les adresses invalides.
- Copiez la clé (elle commence par
pat-).
La liste des droits est aussi affichée, copiable d'un clic, dans le formulaire de connexion de l'espace client. Un jeton de private app HubSpot existant est accepté de la même façon, s'il porte ces droits. HubSpot cesse de prendre en charge ces jetons en septembre 2027 : d'ici là, remplacez-le par une clé de service et reconnectez HubSpot.
Une clé dédiée vous permet de couper l'accès de YesWeCheck sans toucher à vos autres intégrations. HubSpot recommande de la renouveler tous les six mois (bouton Faire pivoter) : reconnectez ensuite HubSpot avec la nouvelle clé.
2. Connecter
Dans l'espace client : Intégrer → Connecteurs → HubSpot, collez la clé, puis Tester et connecter. Le nom de votre compte HubSpot s'affiche quand la clé est acceptée. Une clé refusée, ou à laquelle il manque un droit, n'est pas enregistrée ; le message indique les droits à cocher.
3. Nettoyer une liste
Choisissez une liste de contacts (statique ou active) ou Tous les contacts, puis Lancer le nettoyage. Trois étapes :
- YesWeCheck lit les contacts dans HubSpot.
- Les adresses sont vérifiées comme un traitement par lots : vous suivez la progression dans Traitement par lot, où le lot porte le badge HubSpot.
- À la fin, les résultats sont écrits dans HubSpot. Une notification vous en donne le bilan.
Un seul traitement par lots peut tourner à la fois dans une organisation : un nettoyage attend la fin d'un lot en cours.
Ce qui est écrit dans HubSpot
Au premier nettoyage, YesWeCheck crée le groupe de propriétés YesWeCheck et quatre propriétés de contact s'ils n'existent pas :
| Propriété (nom interne) | Libellé | Type HubSpot | Contenu |
|---|---|---|---|
ywc_status | YWC – Statut | Liste déroulante | Valide, Risqué, Invalide ou Inconnu (valeurs internes valid, risky, invalid, unknown) |
ywc_score | YWC – Score | Nombre | 0 à 100 |
ywc_reason | YWC – Motif | Liste déroulante | Motif (voir la liste des motifs), vide si rien à signaler |
ywc_last_check | YWC – Dernière vérification | Date | Jour de la vérification |
Pour exclure les adresses à risque de vos envois, créez dans HubSpot une liste active filtrée sur YWC – Statut (par exemple « est l'une des valeurs : Invalide ») et excluez-la de vos emails marketing. Les propriétés servent aussi dans vos workflows et vos vues.
Options
| Option | Par défaut | Effet dans HubSpot |
|---|---|---|
| Regrouper les adresses invalides | Désactivée | Ajoute les contacts invalid à la liste statique YWC – invalides |
| Désinscrire les adresses invalides | Désactivée | Désinscrit les contacts invalid de tous les types d'abonnement email. Une désinscription ne s'annule pas sans nouveau consentement du contact |
| Ignorer les contacts déjà désinscrits | Activée | Les contacts désinscrits de tous les emails ne sont ni vérifiés ni facturés |
Vérifier un contact
Sur la page du connecteur, Vérifier un contact : saisissez l'adresse d'un contact HubSpot. Elle est vérifiée, SMTP compris, le verdict s'affiche et les propriétés sont écrites sur sa fiche. Les options de regroupement et de désinscription s'appliquent comme pour un nettoyage. Une adresse absente de HubSpot n'est pas vérifiée et ne coûte aucun crédit.
Vérifier automatiquement les nouveaux contacts
Activez Vérifier automatiquement les nouveaux contacts, choisissez les listes à surveiller (ou Tous les nouveaux contacts) et un plafond journalier.
YesWeCheck consulte ces listes toutes les 5 minutes : chaque contact qui y entre est vérifié, SMTP compris, et ses propriétés sont remplies. Les contacts déjà présents au moment de l'activation ne sont pas concernés : nettoyez la liste pour eux. Le plafond journalier borne la consommation de crédits ; au-delà, les nouveaux contacts du jour ne sont pas vérifiés.
Rien n'est installé dans HubSpot pour cette option : la désactiver, ou déconnecter HubSpot, l'arrête aussitôt.
Déconnecter
Déconnecter efface la clé chez YesWeCheck et arrête la vérification automatique. Les propriétés ywc_* déjà écrites restent sur vos contacts ; supprimez-les dans HubSpot si vous n'en voulez plus.
Pour couper l'accès immédiatement, côté HubSpot, supprimez la clé de service dédiée.
Dépannage
| Message | Cause | Que faire |
|---|---|---|
| « Clé refusée par l'outil » | Clé incomplète, supprimée, expirée ou remplacée après une rotation | Copiez la clé en cours dans HubSpot et reconnectez |
| « La clé est valide mais n'a pas tous les droits nécessaires » | Un droit n'a pas été coché | Modifiez la clé dans HubSpot (Modifier), cochez les droits listés, puis reconnectez |
| « L'outil limite temporairement les appels » | Quota d'appels HubSpot atteint | Le traitement reprend seul ; sinon réessayez plus tard |
| « Un traitement par lot est déjà en cours » | Un autre lot tourne dans l'organisation | Attendez sa fin |
| « Aucun contact HubSpot ne porte cette adresse » | Vérification d'un contact : adresse absente de HubSpot | Vérifiez l'orthographe ; aucun crédit n'est débité |
| Connexion À reconnecter | HubSpot refuse la clé enregistrée | Saisissez une clé valide sur la page du connecteur |