> ## 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.

# Envoyer votre premier WhatsApp Flow à partir d'un formulaire HubSpot

> Transformez un formulaire HubSpot en WhatsApp Flow, ajoutez-le à un modèle, testez-le sur votre téléphone, puis envoyez-le depuis un workflow HubSpot pour que les réponses arrivent dans HubSpot.

Dans ce tutoriel, vous transformez un formulaire marketing HubSpot en WhatsApp Flow, vous l'envoyez sur votre propre téléphone, puis vous l'envoyez depuis un workflow HubSpot. À la fin, un Flow rempli apparaît dans HubSpot comme une soumission du formulaire d'origine.

Comptez environ 50 minutes de travail effectif, d'après les estimations du guide de configuration de Flowella, plus jusqu'à 24 heures pendant que Meta examine votre modèle.

## Avant de commencer

* Lisez [Avant de commencer](https://knowledge.flowella.io/fr/before-you-start.md) et préparez vos accès Meta et HubSpot.
* La vérification de l'entreprise par Meta doit être terminée avant de pouvoir créer un Flow à l'étape 3. Voir [Vérification de l'entreprise](https://knowledge.flowella.io/fr/meta/business-verification.md).
* Munissez-vous de votre propre téléphone avec WhatsApp, sur un numéro personnel plutôt que sur le numéro professionnel que vous connectez.
* Choisissez ou créez un court formulaire marketing HubSpot pour les tests. Incluez un champ e-mail : HubSpot utilise l'adresse e-mail pour rattacher une soumission de formulaire à un contact.
* L'étape 6 nécessite les workflows HubSpot, inclus dans les offres Professional et Enterprise de HubSpot. Sans eux, vous vous arrêtez à l'étape 5.

Si WhatsApp et HubSpot sont déjà connectés, passez directement à l'étape 3.

## Comment les éléments s'articulent

Le diagramme montre l'ordre dans lequel un Flow est créé, approuvé, envoyé et renvoyé vers HubSpot.

```mermaid theme={null}
sequenceDiagram
    actor M as Marketeur
    participant HS as HubSpot
    participant F as Flowella
    participant WA as WhatsApp
    actor C as Client
    M->>HS: Crée le formulaire marketing
    HS-->>F: Le formulaire apparaît sur la page Flows
    M->>F: Create WA Flow
    F->>HS: Lit le formulaire
    F->>WA: Crée ou met à jour le Flow, puis le publie
    M->>F: Create template with this Flow
    F->>WA: Soumet le modèle pour approbation
    HS->>F: Le workflow exécute Send WhatsApp Template
    F->>C: Message de modèle avec bouton Flow
    C->>WA: Ouvre le Flow et le soumet
    WA->>F: Réponses
    F->>HS: Soumission de formulaire sur le contact correspondant
    F-->>C: Écran de remerciement, ou erreur à corriger
    F->>HS: L'événement Form Completed lance les workflows de suivi
```

## Étape 1 : connecter WhatsApp et HubSpot

Environ 16 minutes.

**1. Nommez votre organisation**

Lors de votre première connexion, Flowella vous demande de renseigner **Name your organisation**. Saisissez le nom et sélectionnez **Continue**. Vous ne pouvez pas connecter WhatsApp tant que l'organisation n'a pas de nom.

**2. Connectez WhatsApp**

Accédez à **Settings → WhatsApp (Meta)** et sélectionnez **Connect WhatsApp**. Dans le parcours d'inscription de Meta, choisissez ou créez votre WhatsApp Business Account (WABA), le compte Meta qui contient vos numéros et vos modèles, puis vérifiez votre numéro de téléphone.

**3. Connectez HubSpot**

Accédez à **Settings → HubSpot** et sélectionnez **Connect HubSpot**. Choisissez votre compte HubSpot et approuvez la connexion dans HubSpot.

**Vérifiez que cela fonctionne :** en haut de l'application, les pastilles de statut **WhatsApp** et **HubSpot** affichent toutes deux **Connected**. Sur un petit écran, vérifiez **Settings → WhatsApp (Meta)**, où votre numéro figure sous **Connected WhatsApp numbers**, et **Settings → HubSpot**, qui affiche **Connected**.

Pour plus de détails sur chaque étape, consultez [Configurer Flowella](https://knowledge.flowella.io/fr/onboarding.md).

## Étape 2 : envoyer votre premier message

Environ 2 minutes.

1. Depuis votre téléphone, envoyez un message WhatsApp quelconque à votre numéro professionnel. Cela ouvre la fenêtre de 24 heures, la fenêtre de service client de Meta, pendant laquelle vous pouvez répondre sans modèle.
2. Dans Flowella, ouvrez l'**Inbox** et sélectionnez la nouvelle conversation.
3. Saisissez une réponse dans **Type a message…** et appuyez sur Entrée.

**Vérifiez que cela fonctionne :** la réponse arrive sur votre téléphone. Consultez [Inbox](https://knowledge.flowella.io/fr/app/inbox.md) pour en savoir plus sur les conversations.

## Étape 3 : créer le Flow

Environ 15 minutes.

1. Dans HubSpot, créez ou choisissez votre formulaire marketing de test. Flowella convertit les champs texte sur une ligne, texte multiligne, e-mail, téléphone, nombre, liste déroulante, boutons radio, cases à cocher et date, et transforme les champs fichier en sélecteur de photo. Il ignore les champs qu'il ne peut pas convertir, et un champ obligatoire qu'il ne peut pas convertir bloque la synchronisation.
2. Dans Flowella, ouvrez **Flows**. Flowella actualise la liste des formulaires HubSpot lorsque vous ouvrez la page. Si votre formulaire n'apparaît pas, sélectionnez le bouton d'actualisation en haut de la page.
3. Trouvez votre formulaire et sélectionnez **Create WA Flow** dans la colonne **WhatsApp Flow**. Le bouton affiche **Syncing…** pendant que Flowella crée le Flow et le publie sur votre WABA.

**Vérifiez que cela fonctionne :** la ligne affiche **Created**, ou **Updated** si votre WABA contenait déjà un Flow portant le même nom, et le bouton devient **Sync WA Flow**. Sélectionnez **Open in Meta** pour prévisualiser le Flow.

Le Flow comporte un écran avec les questions de votre formulaire, intitulé du nom du formulaire, suivi d'un écran de remerciement. Flowella n'a pas d'éditeur de Flow : pour modifier les questions plus tard, modifiez le formulaire dans HubSpot, puis sélectionnez **Sync WA Flow**. Voir [Flows](https://knowledge.flowella.io/fr/app/flows.md) et [Bonnes pratiques de conception de formulaires](https://knowledge.flowella.io/fr/app/form-design-best-practices.md).

## Étape 4 : ajouter le Flow à un modèle

Environ 5 minutes, puis l'examen de Meta.

Les contacts ouvrent un Flow à partir d'un bouton **Flow** dans un message de modèle : le Flow a donc besoin d'un modèle. Utilisez l'une ou l'autre option, puis soumettez le modèle.

### Option A : partir de la page Flows

Après la première synchronisation réussie de votre organisation, Flowella affiche **Your form is now a WhatsApp Flow**. Sélectionnez **Create template with this Flow**. Si la boîte de dialogue n'apparaît pas, sélectionnez plutôt **Create template** sur la ligne du formulaire.

L'éditeur de modèles s'ouvre avec un bouton **Flow** déjà relié à votre Flow. Le texte du bouton est **Continue**, que vous pouvez modifier. Rédigez le message, choisissez une **Category** et saisissez un **Template name** en lettres minuscules, chiffres et tirets bas.

### Option B : partir du modèle de démarrage Flowella

1. Dans **Templates**, sélectionnez **New template**, puis **View starters** sous **Flowella Templates**.
2. Trouvez `flowella_start_flow` et sélectionnez **Use this starter**. Son message est `Hi {{1}}, tap below to complete a short form and we will get back to you.` et son bouton Flow indique **Open form**.
3. Dans le champ **WhatsApp Flow** du bouton, choisissez votre Flow. Les Flows sont listés sous le nom du formulaire HubSpot dont ils sont issus.
4. Dans **Body variables**, remplacez la **Fallback value** de `{{1}}`, `Alex`, par une valeur qui convient à tout le monde, comme `there`. Flowella l'envoie lorsqu'un contact n'a pas de prénom.

Le modèle de démarrage utilise la catégorie **Marketing**. Choisissez la catégorie adaptée à votre message avant de le soumettre. Voir [Tarifs et catégories de messages WhatsApp](https://knowledge.flowella.io/fr/account/pricing-and-conversation-categories.md).

### Soumettre le modèle à Meta

1. Sélectionnez **Save draft**.
2. Sélectionnez **Publish Template**, vérifiez la catégorie, puis sélectionnez à nouveau **Publish Template** pour le soumettre à Meta. Si le message contient des variables comme `{{1}}`, attribuez d'abord une **Fallback value** à chacune. Meta l'examine comme exemple de la variable. Voir [Variables de modèle](https://knowledge.flowella.io/fr/app/template-variables.md#valeurs-de-repli).
3. Attendez que le statut passe de **Pending** à **Approved**. Selon Meta, une décision peut prendre jusqu'à 24 heures.

**Vérifiez que cela fonctionne :** le statut du modèle est **Approved**. Si Meta le rejette, consultez [Modèle rejeté](https://knowledge.flowella.io/fr/troubleshooting/template-rejected.md).

## Étape 5 : tester le Flow sur votre téléphone

Environ 3 minutes.

1. Ouvrez votre modèle approuvé et accédez à l'onglet **Send**.
2. Dans **Test Template**, choisissez votre **Country**, saisissez votre **WhatsApp Number** et renseignez les éventuelles variables du modèle.
3. Sélectionnez **Send Test**.
4. Sur votre téléphone, ouvrez le message et appuyez sur le bouton Flow. Remplissez le formulaire avec votre propre adresse e-mail, puis soumettez-le.

**Vérifiez que cela fonctionne :**

* WhatsApp affiche l'écran de remerciement avec le message de remerciement de votre formulaire HubSpot.
* Dans l'**Inbox** de Flowella, la conversation affiche une carte avec vos réponses, marquée **Response sent**. Le titre de la carte est le texte du bouton Flow, ou **Flow response**.
* Dans HubSpot, le formulaire a une nouvelle soumission provenant d'une page nommée d'après le formulaire, par exemple `WhatsApp Flow · Contact us`. HubSpot met à jour les propriétés de contact associées au formulaire.
* La chronologie du contact affiche un événement **Form Completed** avec un lien **View submission**.

Flowella soumet les réponses au formulaire HubSpot d'origine. La soumission et les propriétés du contact apparaissent dans HubSpot comme pour un formulaire rempli sur votre site web.

> [!NOTE]
>
> Ce test coche également **Send a Flow from HubSpot** dans le guide de configuration, car cette étape compte tout Flow rempli.

## Étape 6 : envoyer le Flow depuis un workflow HubSpot

Environ 10 minutes.

> [!NOTE]
>
> Cette étape nécessite les actions de workflow HubSpot, qui exigent une offre HubSpot incluant les workflows (Professional ou Enterprise). Dans Flowella, ouvrez **Settings → HubSpot** et vérifiez que **Custom workflow actions** figure sous **Unlocked**. Si ce n'est pas le cas, vous avez terminé à l'étape 5 : envoyez les Flows depuis Flowella avec un envoi de test ou un [envoi groupé](https://knowledge.flowella.io/fr/app/bulk-send.md).

**1. Préparez un contact de test**

Dans HubSpot, utilisez un contact avec votre propre numéro WhatsApp au format international, comme `+447700900123`, et votre adresse e-mail. Le message envoyé à l'étape 2 a peut-être déjà créé ou associé un contact pour votre numéro. Voir [Format des numéros de téléphone](https://knowledge.flowella.io/fr/hubspot/phone-number-format.md).

**2. Créez un workflow basé sur les contacts**

Les actions de Flowella ne s'exécutent que sur des contacts. Définissez un déclencheur d'inscription que seul votre contact de test remplit pour l'instant, comme une valeur de propriété ou une liste.

**3. Ajoutez Send WhatsApp Template**

Ajoutez l'action Flowella **Send WhatsApp Template**. Dans **Template Name**, choisissez votre modèle de Flow. Seuls les modèles approuvés apparaissent dans la liste. Dans **Contact Phone Number**, sélectionnez la propriété de contact qui contient le numéro WhatsApp. Si votre modèle contient une variable, associez une propriété comme le prénom à **Template Variable 1**. Voir [Send WhatsApp Template](https://knowledge.flowella.io/fr/hubspot/workflow-actions.md#send-whatsapp-template).

**4. Attendez le Flow**

Ajoutez une étape **Delay until event** sur l'événement Flowella **Form Completed**. Filtrez-la par **Form Name** pour qu'elle corresponde au nom de votre formulaire HubSpot, et définissez la durée d'attente, par exemple un jour.

**5. Décidez de la suite**

Pour les contacts qui remplissent le Flow, créez une branche selon les propriétés de contact renseignées par le formulaire, ou créez une tâche. L'événement **Form Completed** enregistre le nom et la source du formulaire, pas les réponses. Pour les contacts qui ne le remplissent pas à temps, envoyez un modèle de relance ou créez une tâche.

**6. Activez le workflow**

Activez le workflow et inscrivez votre contact de test.

**Vérifiez que cela fonctionne :**

* Le modèle arrive sur votre téléphone, et l'historique des workflows du contact indique que l'action **Send WhatsApp Template** est terminée. Flowella termine l'action lorsque WhatsApp signale le premier statut du message, généralement « envoyé ».
* Après avoir rempli le Flow, le contact passe l'étape **Delay until event**, et la soumission apparaît sur le formulaire HubSpot comme à l'étape 5.
* Dans le guide de configuration, **Send a template from HubSpot** est coché.

**Form Completed** ne se déclenche que lorsqu'une personne soumet un WhatsApp Flow via Flowella, jamais pour les soumissions du même formulaire sur votre site web. Pour des workflows complets reposant sur ce modèle, consultez les [guides de workflows](https://knowledge.flowella.io/fr/hubspot/workflows/overview.md).

## Dépannage

> **Create WA Flow est grisé**
>
> Survolez le bouton pour en connaître la raison. Le message le plus courant est « Meta business verification is required before publishing flows. » Le bouton est également indisponible lorsque WhatsApp n'est pas connecté, lorsque le formulaire ne contient aucun champ pris en charge par les WhatsApp Flows, ou lorsque votre offre ne permet pas la synchronisation. Voir [Flows](https://knowledge.flowella.io/fr/app/flows.md) et [Problèmes d'onboarding](https://knowledge.flowella.io/fr/troubleshooting/onboarding.md).

> **La synchronisation échoue**
>
> La ligne affiche un libellé comme **Not ready**. Survolez l'icône d'information à côté pour en connaître la raison. Si un champ HubSpot obligatoire ne peut pas être collecté dans un WhatsApp Flow, rendez le champ facultatif ou changez son type dans HubSpot, puis sélectionnez **Try again**. Voir [Flows](https://knowledge.flowella.io/fr/app/flows.md).

> **Mon formulaire n'apparaît pas sur la page Flows**
>
> Sélectionnez le bouton d'actualisation en haut de **Flows**. Seuls les formulaires marketing HubSpot apparaissent. Si la page affiche **Sample forms**, Flowella ne peut pas encore lire vos formulaires HubSpot : vérifiez la connexion dans **Settings → HubSpot**. Voir [Flows](https://knowledge.flowella.io/fr/app/flows.md).

> **Le modèle n'apparaît pas dans la liste de l'action HubSpot**
>
> Seuls les modèles au statut **Approved** apparaissent. Attendez la décision de Meta, puis rouvrez l'action. Voir [Actions de workflow HubSpot](https://knowledge.flowella.io/fr/hubspot/workflow-actions.md).

> **Le Flow affiche une erreur lorsque je le soumets**
>
> « Missing required field » signifie généralement qu'un champ obligatoire a été ajouté au formulaire HubSpot après la dernière synchronisation. Sélectionnez **Sync WA Flow** sur la page **Flows**, puis renvoyez le Flow. « Could not submit to HubSpot. Try again. » signifie que HubSpot n'a pas accepté la soumission : réessayez et vérifiez que **Settings → HubSpot** affiche **Connected**.

> **La soumission n'est rattachée à aucun contact**
>
> HubSpot rattache les soumissions de formulaire aux contacts via l'adresse e-mail. Ajoutez un champ e-mail au formulaire, ou assurez-vous que le contact a une adresse e-mail dans HubSpot.

> **L'action Send WhatsApp Template échoue**
>
> Ouvrez l'historique des workflows du contact pour voir la raison indiquée par Flowella. Un numéro manquant ou mal formaté échoue avec `CONTACT_PHONE_MISSING` ou `CONTACT_PHONE_INVALID`. Voir [Format des numéros de téléphone](https://knowledge.flowella.io/fr/hubspot/phone-number-format.md) et [Actions de workflow HubSpot](https://knowledge.flowella.io/fr/hubspot/workflow-actions.md).

## Voir aussi

> **[Flows](https://knowledge.flowella.io/fr/app/flows.md)**
>
> Statut de synchronisation, conversion des champs et limites des WhatsApp Flows.

> **[Modèles](https://knowledge.flowella.io/fr/app/templates.md)**
>
> Créez, testez et soumettez des modèles WhatsApp.

> **[Actions de workflow HubSpot](https://knowledge.flowella.io/fr/hubspot/workflow-actions.md)**
>
> Toutes les actions et tous les événements Flowella disponibles dans les workflows HubSpot.

> **[Guides de workflows](https://knowledge.flowella.io/fr/hubspot/workflows/overview.md)**
>
> Des recettes de workflows HubSpot prêtes à l'emploi qui utilisent les Flows.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.