Échecs de synchronisation HubSpot

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

​

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

​

Template send suppressed as duplicate

Si HubSpot indique qu’une action Send WhatsApp Template s’est terminée avec la raison d’erreur DUPLICATE_TEMPLATE_SEND_SUPPRESSED, Flowella a intentionnellement ignoré l’envoi car le même modèle avait déjà été envoyé au même numéro de téléphone dans sa fenêtre de déduplication. Le déclencheur le plus courant est deux contacts HubSpot qui partagent un numéro de téléphone — par exemple un enregistrement personnel et un enregistrement professionnel, ou un foyer avec un seul numéro WhatsApp — qui s’inscrivent au même workflow à quelques secondes d’intervalle. Seul le premier envoi part vers WhatsApp ; le second est supprimé afin que le contact ne reçoive pas deux fois le même message. Auparavant, la seconde action de workflow restait en En attente pendant environ une heure jusqu’au délai d’expiration du callback de HubSpot. Flowella termine désormais le callback immédiatement en échec afin que le contact inscrit passe à l’étape suivante (ou à la branche « action failed ») sans attendre. Comment le distinguer d’un véritable échec :

• Supprimé en tant que doublon — la raison d’erreur est exactement DUPLICATE_TEMPLATE_SEND_SUPPRESSED. Le modèle a bien été envoyé à ce numéro de téléphone, mais via un autre contact inscrit. Aucune action requise.
• Véritable échec d’envoi — l’erreur sera une raison spécifique telle que Template not approved, Phone number invalid, Contact opted out, ou un code d’erreur Meta Graph. Suivez la ligne correspondante dans le tableau ci-dessus.

Si vous devez légitimement envoyer le même modèle deux fois au même numéro (par exemple une re-confirmation après un long délai), espacez les inscriptions au-delà de la fenêtre de déduplication ou utilisez un modèle différent.

​

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é ?