La plupart des problèmes de connexion HubSpot apparaissent à l'un de trois endroits : l'encadré État de la connexion dans Paramètres, puis Intégrations, la page d'installation, ou l'historique du workflow HubSpot qui a exécuté une étape MemberArea. Cet article les parcourt dans cet ordre.
L'encadré d'état de la connexion
Ouvrez Paramètres, puis Intégrations, et cliquez sur la ligne HubSpot. La boîte de dialogue affiche l'encadré État de la connexion avec un badge pour l'état de la connexion.
| Badge | Ce qu'il signifie | Que faire |
|---|---|---|
| Actif | HubSpot a répondu et l'accès que détient MemberArea est valide | Rien |
| Reconnexion nécessaire | HubSpot n'accepte plus cet accès, par exemple parce que l'application a été retirée dans HubSpot | Cliquez sur Reconnecter dans l'encadré |
| Mauvais portail | L'accès répond pour un autre compte HubSpot que celui enregistré ici | Cliquez sur Reconnecter dans l'encadré |
| Non joignable | HubSpot n'a pas répondu à la vérification | Cliquez sur Vérifier à nouveau dans un instant |
Sous le badge, l'encadré nomme le compte connecté et son ID de portail, puis liste chaque autorisation accordée par le compte. Ces remarques peuvent apparaître en dessous :
- La connexion HubSpot a expiré : HubSpot n'accepte plus l'accès que détient MemberArea. Les contacts ne se synchronisent pas et les étapes MemberArea de vos workflows ne s'exécutent pas tant que vous ne vous reconnectez pas.
- Des autorisations manquent : une autorisation requise est absente, et la remarque nomme chacune d'elles. Certaines parties de la synchronisation restent désactivées jusqu'à ce que vous vous reconnectiez et confirmiez les autorisations demandées.
- Les actions de workflow sont désactivées : l'autorisation facultative d'automatisation n'a pas été accordée, donc les étapes MemberArea n'apparaissent pas dans vos workflows HubSpot. Tout le reste continue de fonctionner.
Chacune de ces remarques a un bouton Reconnecter. HubSpot redemande les autorisations, et vous revenez sur Intégrations.
Le résultat est conservé 15 minutes, c'est pourquoi la ligne en bas de l'encadré affiche généralement l'heure de la dernière vérification. Vérifier à nouveau interroge HubSpot immédiatement. Trois nouvelles vérifications par minute sont autorisées. Ensuite, l'encadré indique Vérifié il y a un instant, le dernier résultat est affiché.
Quand la connexion a été interrompue, la ligne HubSpot dans Intégrations indique Déconnecté, et la boîte de dialogue indique Cette connexion a été interrompue. Reconnectez-la pour garder les données synchronisées. Cliquez sur Reconnecter à cet endroit. Rien de ce qui est déjà arrivé dans HubSpot n'est perdu.
"La connexion du compte a échoué."
Cette remarque rouge apparaît en haut de Intégrations quand vous revenez de HubSpot sans connexion. La ligne en dessous donne la raison :
| Raison | Que faire |
|---|---|
| HubSpot authorisation was cancelled. | La boîte de dialogue HubSpot a été fermée ou refusée. Connectez à nouveau et confirmez-la. |
| HubSpot account … is already connected to another MemberArea business. | Un compte HubSpot appartient à un seul espace de travail. Déconnectez-le d'abord dans l'autre espace de travail. |
| HubSpot did not tell us which account was connected. | Connectez à nouveau et choisissez un compte dans la boîte de dialogue HubSpot. |
| Missing OAuth state or code. | HubSpot vous a renvoyé sans résultat. Connectez à nouveau. |
| HubSpot did not return an access token. | HubSpot n'a pas terminé la connexion. Connectez à nouveau dans un instant. |
Si plus de 15 minutes s'écoulent dans la boîte de dialogue HubSpot, vous arrivez à la place sur la liste de vos espaces de travail et rien n'est connecté. Ouvrez votre espace de travail et connectez à nouveau.
Sur la page d'installation
Ces messages apparaissent quand vous installez l'application depuis un lien d'installation.
"Ce lien d'installation n'est plus valable. Les liens restent ouverts 15 minutes." Plus de 15 minutes se sont écoulées, ou vous avez ouvert la page dans un autre navigateur que celui dans lequel vous avez commencé l'installation. Le lien ne fonctionne que dans le navigateur qui est passé par la boîte de dialogue HubSpot. Ouvrez à nouveau le lien d'installation dans un seul navigateur et terminez-la là.
"Ce compte HubSpot est déjà connecté" : le compte appartient à un espace de travail auquel vous n'avez pas accès. Demandez au propriétaire de cet espace de travail de le déconnecter là-bas.
"HubSpot account … is already connected to another MemberArea workspace." : le compte appartient à un autre de vos espaces de travail. Déconnectez-le d'abord dans cet espace de travail, puis installez à nouveau.
"Confirm that HubSpot account … may be disconnected before this one takes its place." : l'espace de travail choisi a déjà un autre compte HubSpot. Cochez Remplacer le compte actuel pour l'échanger, ou choisissez un autre espace de travail.
"Créez un espace de travail pour terminer l'installation" : votre compte n'a pas encore d'espace de travail. Cliquez sur Créer un espace de travail, puis ouvrez à nouveau le lien d'installation.
Une étape HubSpot d'une automatisation a échoué
Ouvrez l'automatisation et consultez son Historique d'exécution. Une exécution dont une étape HubSpot a échoué indique Échoué et donne la raison :
| Raison | Que faire |
|---|---|
| Aucune connexion HubSpot n'est choisie pour cette étape. Choisissez-en une dans l'éditeur. | Ouvrez l'étape et choisissez la connexion sous Intégration. |
| La connexion HubSpot a expiré. | Cliquez sur Reconnecter dans Paramètres, puis Intégrations. |
| HubSpot n'a pas accepté le contact. | Vérifiez l'adresse e-mail du membre et les autorisations dans État de la connexion. Pour Définir une propriété du contact, vérifiez que la valeur convient à la propriété, par exemple la valeur interne d'une option de liste déroulante. |
| HubSpot n'a pas ajouté le contact à la liste. | Vérifiez que la liste existe toujours dans HubSpot et qu'il s'agit d'une liste statique. |
| HubSpot n'a pas retiré le contact de la liste. | Vérifiez que la liste existe toujours dans HubSpot et qu'il s'agit d'une liste statique. |
Un membre sans adresse e-mail, une étape de liste sans liste choisie ou une étape Définir une propriété du contact sans propriété choisie ne fait pas échouer l'exécution. L'étape se termine avec une remarque indiquant que rien n'a été envoyé, par exemple Aucune propriété HubSpot n'est sélectionnée dans cette étape.
Une étape MemberArea d'un workflow HubSpot a échoué
Quand une action MemberArea ne peut pas faire son travail, l'étape est marquée comme échouée dans le workflow HubSpot, avec un code et une phrase qui dit quoi faire. Le workflow continue avec l'étape suivante, pour qu'un contact ne bloque pas tous ceux qui suivent. Si MemberArea lui-même subit une courte panne, HubSpot réessaie l'étape plus tard.
| Code | Ce qui s'est passé | Que faire |
|---|---|---|
PORTAL_NOT_CONNECTED |
Le compte HubSpot n'est connecté à aucun espace de travail | Connectez HubSpot dans l'espace de travail auquel il appartient, sous Paramètres, puis Intégrations |
WORKSPACE_MISSING |
L'espace de travail derrière le compte HubSpot n'existe plus | Connectez le compte HubSpot à un espace de travail qui existe |
EMAIL_MISSING |
Le contact n'a pas d'adresse e-mail | Ajoutez-en une au contact, ou remplissez Email address dans l'étape |
MEMBER_LIMIT_REACHED |
L'offre a atteint son nombre de membres | Passez à une offre supérieure et exécutez à nouveau l'étape |
MEMBER_NOT_CREATED |
Le membre n'a pas pu être créé | Vérifiez l'adresse e-mail du contact |
COURSE_MISSING |
L'étape n'a pas d'ID de cours | Remplissez Course ID |
COURSE_NOT_FOUND |
Aucun cours avec cet ID dans cet espace de travail | Copiez à nouveau l'ID depuis l'adresse du cours |
COURSE_NOT_PUBLISHED |
Le cours est un brouillon | Publiez le cours |
PRODUCT_MISSING |
L'étape n'a pas d'ID de produit ou d'offre groupée | Remplissez l'ID |
PRODUCT_NOT_FOUND |
Aucun produit ni offre groupée avec cet ID dans cet espace de travail | Copiez à nouveau l'ID depuis l'adresse du produit ou de l'offre groupée |
PRODUCT_NOT_PURCHASABLE |
Create checkout link : le produit est inactif ou n'a pas de prix achetable | Activez le produit et donnez-lui un prix |
PRICE_NOT_FOUND |
Create checkout link : le prix appartient à un autre produit ou n'est plus actif | Laissez Price ID vide pour le prix par défaut, ou choisissez un prix de ce produit |
WORKSPACE_DOMAIN_MISSING |
Create checkout link : l'espace de travail n'a pas d'adresse web | Définissez le domaine dans Paramètres |
GROUP_MISSING |
L'étape n'a pas d'ID de groupe | Remplissez Group ID |
GROUP_NOT_FOUND |
Aucun groupe avec cet ID dans cet espace de travail | Copiez à nouveau l'ID depuis l'adresse du groupe |
GROUP_IS_SYSTEM |
L'étape pointe vers le groupe automatique "Tous les membres" | Choisissez un autre groupe |
GROUP_FULL |
Le groupe a atteint sa limite de membres | Augmentez la limite dans Audience, puis Groupes |
TAG_MISSING |
L'étape n'a pas de tag | Remplissez Tag |
TAG_NOT_FOUND |
Remove tag : aucun tag de ce nom dans cet espace de travail | Vérifiez l'orthographe du nom du tag |
FIELD_MISSING |
L'étape n'a pas de champ membre | Remplissez Member field |
FIELD_NOT_FOUND |
Aucun champ membre de ce nom dans cet espace de travail | Comparez l'orthographe avec Audience, onglet Champs |
FIELD_TYPE_NOT_SUPPORTED |
Le champ est un choix multiple ou un champ de téléversement | Choisissez un champ d'un autre type |
INVALID_VALUE |
La valeur ne convient pas au champ, par exemple du texte dans un champ numérique | Corrigez la valeur ou la propriété HubSpot dont elle provient |
AUTOMATION_MISSING |
L'étape n'a pas d'ID d'automatisation | Remplissez Automation ID |
AUTOMATION_NOT_FOUND |
Aucune automatisation avec cet ID dans cet espace de travail | Copiez à nouveau l'ID depuis l'adresse de l'automatisation |
AUTOMATION_DISABLED |
L'automatisation est désactivée | Activez-la dans Automatisations |
AUTOMATION_NOT_PUBLISHED |
L'automatisation n'a jamais été publiée | Publiez-la |
AUTOMATION_NO_TRIGGER |
L'automatisation n'a pas de déclencheur | Ajoutez le déclencheur Démarré depuis un workflow HubSpot et publiez à nouveau |
L'endroit où trouver les ID est décrit dans Utiliser les actions MemberArea dans un workflow HubSpot.
Une automatisation ne démarre pas depuis HubSpot
Vérifiez ces points dans l'ordre :
- L'automatisation est publiée et activée dans Automatisations.
- La connexion indique Actif dans État de la connexion. Tant qu'elle a besoin d'un Reconnecter, rien n'arrive de HubSpot, et les changements faits entre-temps ne démarrent rien après coup.
- Pour Propriété de contact HubSpot modifiée : seuls la phase du cycle de
vie et le statut du lead sont signalés. Nouvelle valeur doit être la
valeur interne, comme
customer, écrite exactement comme dans HubSpot. - Pour Démarré depuis un workflow HubSpot : consultez l'historique du
workflow HubSpot. Une étape Start automation échouée donne la raison avec
l'un des codes
AUTOMATION_ci-dessus.
Le fonctionnement des déclencheurs est décrit dans Démarrer des automatisations depuis HubSpot.
L'accès est revenu après que je l'ai révoqué
Il n'est jamais parti. L'accès que le membre a payé survit à Revoke access : une commande du produit conserve ce qu'elle a débloqué. Remboursez ou annulez la commande si l'accès doit vraiment disparaître.