> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Échecs de synchronisation HubSpot
> Diagnostiquez les soumissions de formulaires manquantes, les actions de flux de travail bloquées et les mises à jour de contact qui n'atteignent pas 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](/fr/hubspot/setup). Pour les actions de workflow, voir [Actions de workflow](/fr/hubspot/workflow-actions).
## 1. Vérifiez la connexion
Depuis l'application Flowella, allez dans **Réglages → HubSpot**.
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é.
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](/fr/app/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](/fr/hubspot/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
| Erreur | Que faire ? |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Channel not found` | Le flux de travail pointe vers un canal qui n'existe plus. Modifiez l'action et choisissez un canal actuel. Voir [Multicanal](/fr/essentials/multi-channel). |
| `Template not approved` | Le modèle référencé a changé de statut pour devenir `REJECTED`, `PAUSED`, ou `DISABLED`. Voir [Modèle rejeté](/fr/troubleshooting/template-rejected). |
| `Contact opted out` | Le contact s'est retiré de ce canal. Honorez l'opt-out - ne le contournez pas. |
| `Phone number invalid` | Le téléphone du contact n'est pas en E.164. Voir [Format du numéro de téléphone](/fr/hubspot/phone-number-format). |
| `Subscription required` | Votre plan Flowella n'inclut pas cette action, ou votre abonnement a expiré. Voir [Facturation](/fr/account/billing). |
### 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](/fr/api-reference/introduction).
## Toujours bloqué ?
Saisissez les éléments suivants avant de contacter le [support](https://flowella.io/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