> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/composants-whatsapp/question-whatsapp.md).

# Question WhatsApp

### Vue d'ensemble

Le **Composant de question WhatsApp** est un nœud d’action axé sur la collecte de données, le tri et la construction de dialogues structurés. Sa fonction principale est d’envoyer une question directement au client et d’attendre une réponse en temps réel. Le flux d’automatisation passe à l’état d’attente (*veille*) dans ce composant jusqu’à ce que l’utilisateur réponde avec une donnée valide, ce qui permet de stocker la réponse fournie et de ramifier l’arbre d’automatisation selon le choix ou le contenu saisi.

### Paramètres de configuration

Le paramétrage du composant définit la structure d’affichage de la question et les règles de stockage des données :

* **Type :** Détermine la mécanique d’interaction de la question envoyée :
  * `Texte`: Envoie un simple message texte et attend une réponse saisie manuellement par le client.<br>
  * `Interactif`: Envoie des formats natifs de boutons ou de listes interactives de l’API WhatsApp.<br>
* \_*Message (* Champ obligatoire) :\_\* Le contenu ou l’énoncé de la question qui sera affiché au client.<br>
* **Possède une variable (clé de bascule - Toggle Switch) :** Lorsqu’elle est activée, elle permet le stockage de la réponse. Peut fonctionner en mode *Fixe* (variable statique de la plateforme) ou *Expression* (expression dynamique).<br>
* \_*Variable (* Obligatoire si activé) :\_\* Définit le nom du conteneur interne (ex : `response`) qui recevra la valeur de la réponse.<br>
* **Cible de la réponse :** Permet de mapper et d’enregistrer la donnée reçue directement dans des champs natifs ou personnalisés du contact, comme `Nom`, `E-mail`, `Adresse`, `NPS`, `CSAT` ou un `custom_field` (champ personnalisé).<br>
* **Ignorer si l’objectif est atteint (clé de bascule - Toggle Switch) :** Si le contact a déjà le champ cible renseigné dans son profil, le composant saute automatiquement la question et passe au nœud suivant sans déranger l’utilisateur.<br>
* **Accepter la réponse :** Filtre de validation des données qui établit ce qu’est une réponse valide. Pour les questions de type *Texte*, limite la saisie à des formats tels que : `Texte`, `Nombre`, `Numéro de téléphone`, `E-mail`, `Localisation` ou `Audio`. Si l’utilisateur envoie quelque chose hors du format (ex. : envoyer une image alors qu’un e-mail est attendu), le système rejette et répète la question.<br>

### Constructeur visuel

L’interface du constructeur s’adapte et s’étend dynamiquement en fonction des propriétés sélectionnées dans le champ *Type*:

#### Configuration pour le type `Interactif`

En basculant le type sur interactif, le composant affiche le champ **Type de réponse** pour définir la disposition des boutons :

* **Option Boutons (Quick Replies) :** Permet de créer des boutons de réponse rapide qui apparaissent sous le message. L’interface limite la création à **au maximum 3 boutons**.<br>
* **Option Liste (List Messages) :** Transforme l’interaction en un menu d’options épuré. Lorsque cette modalité est sélectionnée, le formulaire visuel s’étend et exige les champs obligatoires suivants :
  * `Bouton pour ouvrir la liste *`: Le texte qui apparaîtra sur le bouton principal de clic (ex : "Sélectionner").<br>
  * `Titre de la section *`: L’en-tête de la fenêtre qui regroupe les éléments.<br>
  * `Liste`: Bloc répétiteur où l’administrateur utilise le bouton **+ Ajouter un élément** pour inclure les options nominales de choix (*Bouton*) et les textes d’appui (*Description*). L’interface limite la création à **au maximum 10 éléments de liste**.<br>
* **Sorties multiples :** Clé de bascule qui, si activée, génère un port de sortie physique dans l’éditeur graphique pour chaque bouton ou élément de liste créé, permettant de dessiner des chemins totalement personnalisés pour chaque réponse de l’utilisateur.<br>

### Opérateurs spéciaux

Les propriétés logiques de ce composant gèrent la validation des types de données (*validation des données*) et la gestion de l’état des entrées :

* **Validateur Regex et types natifs :** Lorsqu’il est configuré pour n’accepter que `E-mail` ou `Numéro de téléphone`, le composant exécute un script de validation syntaxique sur la réponse du client. Si la validation échoue, le moteur bloque la progression du flux et répète le message de question.<br>
* **Mappage des métadonnées interactives :** Dans les questions de type `Interactif` structurées comme une liste, le champ *Accepter la réponse* change son périmètre par défaut vers le mode `Données valides`. Le système vérifie que le texte cliqué correspond exactement à l’un des ID structurés dans la liste du constructeur, en ignorant les textes aléatoires saisis par l’utilisateur pendant cette étape du menu.<br>

### Exemples pratiques

Le tableau ci-dessous illustre des scénarios classiques d’application de ce composant pour guider des interactions intelligentes via WhatsApp :

| **Type sélectionné**     | **Configuration du constructeur**                                                                                                                           | **Cible de la réponse / Variable**                                                                                         | **Cas d'utilisation pratique**                                                                                                               |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `Texte`                  | <p><strong>Message :</strong> "Quel est votre e-mail ?"<br><br><br><br><strong>Accepter la réponse :</strong> <code>E-mail</code></p>                       | <p><strong>Cible :</strong> <code>E-mail</code><br><br><br><br><strong>Variable :</strong> <code>email\_cliente</code></p> | Capturer et valider l’e-mail du client. S’il saisit quelque chose sans `@`, le système répète la question jusqu’à recevoir un e-mail valide. |
| `Interactif` *(Boutons)* | <p><strong>Message :</strong> "Êtes-vous déjà client ?"<br><br><br><br><strong>Boutons :</strong> \[Oui], \[Non]</p>                                        | <p><strong>Variable :</strong> <code>ja\_e\_cliente</code><br><br><br><br><strong>Sorties multiples :</strong> Activé</p>  | Créer un menu de triage initial rapide avec 2 boutons, en branchant le flux vers différents chemins selon le clic de l’utilisateur.          |
| `Interactif` *(Liste)*   | <p><strong>Message :</strong> "Choisissez une option de service"<br><br><br><br><strong>Éléments (max. 10) :</strong> \[Support], \[Ventes], \[Finance]</p> | <p><strong>Cible :</strong> <code>custom\_field</code><br><br><br><br><strong>Sorties multiples :</strong> Activé</p>      | Présenter un menu d’options robuste au format liste (Menu d’options) pour orienter le client vers les bons services de l’entreprise.         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/french/flux-dautomatisations/tous-les-composants/composants-whatsapp/question-whatsapp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.