Le module a été renommé de Forms à Flows dans la v2.6.31. Les objets sources HubSpot sont toujours appelés formulaires — le renommage n’affecte que l’entrée de la barre latérale Flowella, le titre de la page et l’URL. Les favoris vers
/{org}/forms continuent de fonctionner : Flowella émet une redirection permanente 308 vers /{org}/flows.Comment l’ouvrir
Allez dans Flows dans la navigation de gauche, ou :/{org}/{waba}/{phone}/flows. La liste est la même. Le scope du canal est utilisé lorsque vous synchronisez un Flow vers Meta.
Ce que la liste affiche
Chaque ligne représente un formulaire HubSpot. Les colonnes comprennent :- Nom du formulaire et un ID de formulaire HubSpot tronqué avec un bouton de copie en un clic.
- Nombre de champs — combien de champs le formulaire comporte, avec un indicateur si certains ne sont pas pris en charge.
- Dernière modification dans HubSpot — extrait du
updatedAtde HubSpot pour que vous puissiez voir quand la définition du formulaire elle-même a changé. - Statut WhatsApp Flow — synchronisé, brouillon ou obsolète (HubSpot a changé depuis la dernière synchronisation).
- Indicateur de dérive — lorsque le formulaire HubSpot a été modifié depuis que le dernier Flow en a été construit, la ligne affiche un libellé ambre Le formulaire HubSpot a changé depuis la construction de ce Flow — synchronisez à nouveau pour le prendre en compte. Déclenchez une nouvelle synchronisation pour l’effacer.
- Créer WhatsApp Flow / Synchroniser WhatsApp Flow — l’action principale. L’étiquette bascule vers Synchroniser lorsqu’un Flow existe déjà et vers Obsolète — Synchronisation nécessaire lorsque le formulaire HubSpot a été modifié depuis la dernière synchronisation.
Synchronisation du catalogue en arrière-plan
Flowella maintient la liste Flows à jour automatiquement, pour que les formulaires HubSpot nouvellement ajoutés ou renommés apparaissent sans que vous cliquiez :- Lorsque vous ouvrez la page, Flowella sert le catalogue mis en cache immédiatement et met en file une nouvelle synchronisation en arrière-plan si le catalogue est plus ancien que 5 minutes.
- Toutes les 20 minutes, un balayage en arrière-plan re-synchronise le catalogue pour chaque organisation dont l’intégration HubSpot est CONNECTÉE, pour que les listes restent à jour même pour les onglets que personne n’a ouverts.
- Pendant qu’une synchronisation en arrière-plan s’exécute, l’en-tête affiche En cours de mise à jour… à côté de l’icône de rafraîchissement. Une fois terminée, le libellé bascule vers Dernière synchronisation il y a 2 minutes (ou l’équivalent en temps relatif). La liste se rafraîchit sur place.
Détail du formulaire
Cliquez sur une ligne pour ouvrir sa page de détail. L’en-tête de détail affiche la même action principale Créer / Synchroniser WhatsApp Flow que la ligne de la liste, pour que vous n’ayez pas à revenir en arrière pour effectuer des modifications. Depuis la page de détail, vous pouvez :- Passer en revue le mappage champ par champ entre le formulaire HubSpot et le WhatsApp Flow.
- Voir les exécutions de synchronisation passées — quand chacune a été lancée, son statut (en file, en cours, réussi, échoué) et toutes les erreurs retournées par Meta.
- Déclencher une nouvelle synchronisation, réessayer une exécution échouée ou annuler une synchronisation encore en cours.
- Ouvrir le Flow correspondant dans Meta Business Suite.
- Vérifier de quelle version du formulaire HubSpot le Flow publié a été construit. Lorsqu’un Flow a été synchronisé, l’en-tête affiche Flow construit à partir du formulaire HubSpot au 12 sept., 14:03. Comparez-le à la valeur actuelle de Dernière modification dans HubSpot pour décider si vous devez re-synchroniser.
Synchroniser un formulaire vers un WhatsApp Flow
Lorsque vous cliquez sur Créer WhatsApp Flow ou Synchroniser WhatsApp Flow, Flowella :- Exécute une vérification préalable — confirme que HubSpot est connecté, que le canal actif est vérifié, que le formulaire comporte au moins un champ pris en charge et que la facturation est active.
- Lit la dernière définition du formulaire depuis HubSpot.
- Génère le JSON WhatsApp Flow équivalent.
- L’upload vers Meta sur le canal que vous avez sélectionné (à portée de canal).
- Enregistre l’exécution de synchronisation sur la page de détail et horodate la valeur Flow construit à partir du formulaire HubSpot au pour que la dérive puisse être détectée lors des modifications ultérieures.
Contrôle du scope de canal
Les Flows sont à l’échelle de l’organisation dans la liste mais à portée de canal lors de la synchronisation — un Flow doit être uploadé pour une combinaison WABA + numéro de téléphone spécifique.
Si vous cliquez sur Synchroniser depuis l’URL à l’échelle de l’organisation et que Flowella ne peut pas décider quel canal utiliser (aucun canal connecté, plusieurs canaux sans scope défini, ou session obsolète inter-organisations), le bouton reste pré-désactivé avec une info-bulle expliquant ce qui manque. Basculez vers le bon canal depuis le sélecteur de canal, ou ouvrez
/{org}/{waba}/{phone}/flows directement.
UX d’erreur de synchronisation
Lorsqu’une synchronisation échoue, Flowella transforme la ligne d’exécution en un unique bouton d’action en contour pour que vous puissiez avancer depuis la même ligne :
La ligne porte également un badge d’erreur adapté à l’utilisateur :
FLOW_SYNC_PREFLIGHT+ erreur Meta#133010(téléphone non enregistré) — le badge affiche le message Meta stocké et une indication d’enregistrement du téléphone, pas un message générique « non prêt ». Terminez l’enregistrement du téléphone dans Réglages → Meta et réessayez.QUEUE_FAILED— la file de synchronisation n’a pas pu prendre en charge le job. Habituellement transitoire ; réessayez. Si cela persiste, la page de statut de la plateforme est le prochain endroit à vérifier (voir Statut et incidents).validation_errorsMeta — le badge résume les champs que Meta a rejetés, pour que vous puissiez ajuster le formulaire HubSpot (ou le mappage des champs) et réessayer sans quitter la ligne.
Les soumissions de Flow s’attachent au contact HubSpot inscrit
Lorsqu’un WhatsApp Flow est envoyé depuis un workflow HubSpot, Flowella transmet désormais l’ID de contact HubSpot inscrit à travers le Flow et l’inclut sous forme dehs_object_id lorsque la soumission est réécrite vers HubSpot. Cela fait que la soumission s’attache au contact exact que HubSpot a inscrit — pas à un enregistrement ressemblant — même lorsque le numéro de téléphone correspond à plusieurs contacts, et cela supprime le dernier cas où la recherche téléphonique HubSpot pouvait retomber sur le mauvais enregistrement.
Si votre organisation possède déjà des Flows publiés, re-synchronisez chaque Flow une fois pour que le nouveau champ caché soit inclus dans le JSON du Flow uploadé vers Meta :
1
Ouvrez la page Flows
Allez dans Flows et ouvrez n’importe quel formulaire dont le WhatsApp Flow a été créé avant ce changement.
2
Déclenchez une nouvelle synchronisation
Cliquez sur Synchroniser WhatsApp Flow sur la ligne (ou sur l’action principale sur la page de détail). Flowella re-upload le JSON du Flow vers Meta avec le champ caché d’ID de contact.
3
Répétez pour chaque formulaire actif
Seuls les formulaires envoyés depuis des workflows HubSpot ont besoin de cela. Les formulaires envoyés en dehors d’un contexte de workflow ne sont pas concernés.
Texte de question dans les blocs de texte enrichi
HubSpot vous permet de placer un élément de texte enrichi au-dessus d’un groupe de champs pour que le texte de la question soit au-dessus de la saisie plutôt qu’à l’intérieur du libellé du champ. Flowella mappe ces blocs dans le WhatsApp Flow aux côtés des entrées :
Le texte enrichi apparaît avant les entrées dans le groupe de champs, pour que les clients voient la question, puis y répondent. Les libellés de champ sont toujours affichés dans l’app, alors gardez-les courts — voir Bonnes pratiques de conception de formulaire.
Si vous avez déjà des formulaires HubSpot qui utilisent du texte enrichi au-dessus des groupes de champs, re-synchronisez-les depuis la page de détail du formulaire. Les anciennes exécutions de synchronisation ne prenaient que les libellés de champ, donc le texte de la question en texte enrichi était absent du Flow publié jusqu’à ce que vous re-synchronisiez.
Mise en forme de l’écran de remerciement
Le même mappage HTML → composant Flow s’applique désormais au texte de remerciement d’un formulaire HubSpot. Les titres, le texte en gras, les espaces insécables et les listes à puces survivent à la synchronisation au lieu d’être réduits à du texte brut, et le pied Terminé est conservé.
Chaque puce est rendue sur une seule ligne, donc le balisage HubSpot pretty-printé (un
<p> imbriqué dans chaque <li>) ne produit plus de lignes de puces orphelines sur WhatsApp. Les titres de plus de 80 caractères retombent toujours en texte corps, comme ailleurs dans le Flow.
Si un formulaire a été synchronisé avant ce changement, son Flow porte toujours le texte de remerciement en texte brut. Ouvrez la page de détail du formulaire et re-synchronisez pour prendre en compte la nouvelle mise en forme.
Données d’exemple
Si vous n’avez pas encore de connexion HubSpot, la page Flows s’affiche avec des lignes illustratives derrière un encart « Données d’exemple ». Connectez HubSpot pour basculer vers vos vrais formulaires.Un formulaire peut être parfaitement synchronisé et pourtant mal se lire sur un téléphone. Les libellés de champ longs sont raccourcis à l’écran, surtout sur iPhone, et le mauvais type de question aggrave la situation. Voir Bonnes pratiques de conception de formulaire avant de créer un formulaire.
Voir aussi
Configuration HubSpot
Connectez le portail depuis lequel Flowella lit les formulaires.
Conception de formulaire
Construisez des formulaires HubSpot qui s’affichent proprement sur chaque appareil.
Actions de workflow
Déclenchez des Flows depuis un workflow HubSpot.
Guides de workflow
Recettes de bout en bout combinant formulaires, modèles et workflows.
Échecs de synchronisation HubSpot
Diagnostiquez les problèmes de synchronisation de formulaire et les soumissions manquantes.
Multi-canal
Les Flows sont synchronisés par canal — comprenez le scope.
Sécurité des données
Comment les soumissions de formulaire sont chiffrées en transit et au repos.