Passer au contenu principal
La plupart des problèmes liés à HubSpot peuvent être classés dans l’une des trois catégories suivantes : l’intégration est déconnectée, un mappage de champ est erroné, ou une action de flux de travail est mal configurée. Cette page les aborde dans l’ordre. Pour la configuration initiale, voir HubSpot setup. Pour les actions de workflow, voir Actions de workflow.

1. Vérifiez la connexion

1

Ouvrez Paramètres → HubSpot

Depuis l’application Flowella, allez dans Réglages → HubSpot.
2

Lire le badge d'état

Un badge Connecté vert signifie que le jeton OAuth est valide. Une bannière rouge Reconnect signifie que le jeton a été révoqué ou a expiré.
3

Reconnectez si nécessaire

Cliquez sur Reconnect et recommencez HubSpot OAuth. Réessayez ensuite l’action qui a échoué.
Causes courantes d’une mauvaise connexion HubSpot :
  • L’utilisateur HubSpot qui a autorisé Flowella a été supprimé du portail.
  • HubSpot a effectué une rotation du jeton car il n’a pas été utilisé récemment.
  • Un super administrateur a désactivé l’intégration de Flowella dans les paramètres de l’application de HubSpot.

2. Les soumissions de formulaires n’apparaissent pas dans HubSpot

Si un contact remplit un WhatsApp Flow mais que vous ne voyez pas la soumission dans le HubSpot :

Mauvaise correspondance des champs

Le flux peut inclure un champ qui ne correspond pas à une propriété HubSpot d’un type compatible. Ouvrez le formulaire sur la page Forms et vérifiez la correspondance de chaque champ.

Le champ requis est vide

Si un champ du formulaire HubSpot est obligatoire et que le WhatsApp Flow permet à l’utilisateur de l’ignorer, la soumission sera rejetée par le HubSpot. Rendez le champ facultatif dans HubSpot ou obligatoire dans le flux.

Format du numéro de téléphone

HubSpot est strict sur le format du numéro de téléphone. Voir Phone number format - la plupart des problèmes de “contact manquant” se résument au format E.164 par rapport au format national.

La recherche a lieu après l’exécution de l’action du flux de travail.

Si votre workflow HubSpot s’exécute immédiatement après la soumission du formulaire, des conditions de course peuvent entraîner le déclenchement du workflow avant que Flowella n’ait fini d’écrire le contact. Ajoutez un court délai (1-2 minutes) au début du workflow, ou déclenchez le changement de propriété du contact au lieu de la soumission du formulaire.

3. Les actions du workflow sont bloquées ou échouent

Si un workflow HubSpot qui inclut une action Flowella est bloqué :

Ouvrez l’historique des actions du workflow

Dans HubSpot, trouvez le contact, faites défiler jusqu’à Historique du workflow, et cliquez sur l’action qui a échoué. HubSpot affiche la réponse renvoyée par Flowella pour chaque action.

Réponses aux erreurs courantes

ErreurQue faire ?
Channel not foundLe flux de travail pointe vers un canal qui n’existe plus. Modifiez l’action et choisissez un canal actuel. Voir Multicanal.
Template not approvedLe modèle référencé a changé de statut pour devenir REJECTED, PAUSED, ou DISABLED. Voir Modèle rejeté.
Contact opted outLe contact s’est retiré de ce canal. Honorez l’opt-out - ne le contournez pas.
Phone number invalidLe téléphone du contact n’est pas en E.164. Voir Format du numéro de téléphone.
Subscription requiredVotre plan Flowella n’inclut pas cette action, ou votre abonnement a expiré. Voir Facturation.

L’action existe mais ne fait rien

Si le flux de travail s’exécute sans erreur mais qu’aucun message n’arrive, vérifiez à nouveau :
  • L’action est activée (pas en pause).
  • Le destinataire est inscrit dans le flux de travail à la bonne étape.
  • Les critères d’inscription de HubSpot correspondent toujours au contact.

4. Confusion sur la direction de la synchronisation

La synchronisation de Flowella est bidirectionnelle mais partielle :
  • Les soumissions WhatsApp Flow → écrivent les propriétés du contact dans HubSpot.
  • Les actions de workflow de HubSpot → envoient des messages et des modèles de WhatsApp.
  • Réponses WhatsApp entrantes → enregistrement dans la chronologie du contact (ne met pas automatiquement à jour les propriétés).
Si vous attendez une réponse WhatsApp de forme libre pour mettre à jour une propriété, cela nécessite une étape supplémentaire de votre côté - un flux de travail HubSpot qui surveille l’événement de conversation et analyse la réponse, ou une intégration personnalisée via l’API.

Toujours bloqué ?

Saisissez les éléments suivants avant de contacter le support :
  • L’horodatage de la dernière synchronisation dans Paramètres → HubSpot.
  • Le message d’erreur exact (ou la capture d’écran) renvoyé par Flowella ou HubSpot
  • L’ID du contact et l’ID du flux de travail concernés