> 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-telegram/question-telegram.md).

# Question Telegram

### Vue d'ensemble

Le composant de question Telegram (identifié dans l’interface comme `telegram_question`) est un nœud d’interaction sortant axé sur la collecte de données et l’engagement. Sa fonction principale est de déclencher une question à l’utilisateur dans le chat Telegram et de maintenir l’automatisation en état d’attente (*veille*) jusqu’à ce qu’une réponse valide se produise. Il prend en charge à la fois la collecte de saisies textuelles traditionnelles et les interactions basées sur des boutons cliquables, en s’adaptant aux règles de mise en page natives de l’application.

### Paramètres de configuration

Le paramétrage du bloc gère les formats d’affichage du message et les règles de persistance des réponses dans le système :

* Type : menu déroulant qui définit la mécanique de saisie du composant :
  * `Texte`: attend une réponse rédigée manuellement par l’utilisateur.
  * `Interactif` (ou `Interactif`): active l’envoi de boutons cliquables intégrés au message.
* Message : champ de texte pour renseigner l’énoncé de la question qui sera envoyé au contact dans le chat.
* Possède une variable (interrupteur à bascule - Toggle Switch) : active le stockage de la réponse donnée par le client dans la mémoire interne du flux.
* Cible de la réponse : liste déroulante facultative pour mapper la donnée reçue directement vers un champ standard du profil du contact dans le CRM (ex : *Nom*, *E-mail*, *Téléphone*).
* buttons\_type \* (\* Obligatoire si Interactif) : menu qui sélectionne le format de rendu des boutons selon les standards de mise en page de Telegram :
  * `Bouton en ligne`: crée des boutons attachés directement sous la bulle du message (*Claviers inline*).
  * `Bouton clavier`: remplace temporairement le clavier par défaut de l’utilisateur dans l’application par des blocs de boutons de réponse rapide (*Claviers de réponse*).
* Sorties multiples (interrupteur à bascule - Toggle Switch) : lorsqu’elle est active, crée une branche physique dans l’éditeur de flux pour chaque bouton ajouté, permettant des chemins personnalisés pour chaque choix.

### Constructeur visuel

L’interface du constructeur adapte ses champs de manière conditionnelle selon l’option choisie dans le paramètre *Type*:

* Disposition modulaire pour le mode interactif : sélectionner la modalité `Interactif` déverrouille le paramètre obligatoire `buttons_type *`. Le panneau s’étend verticalement pour afficher les répéteurs où l’administrateur saisit les libellés textuels de chaque bouton et décide de la disposition physique de la grille de réponses.
* Validation par astérisque : le sélecteur de format des boutons affiche l’indicateur astérisque (`*`), signalant à l’administrateur que le nœud ne sera pas validé ni enregistré de manière incomplète si les boutons natifs ne sont pas créés.

### Opérateurs spéciaux

Les propriétés logiques de ce composant gèrent les callbacks natifs de Telegram et l’interpolation des tags :

* Gestion de callbacks indépendants (`Inline` vs `Reply`): le moteur distingue la logique du clic :
  * En utilisant `Bouton en ligne`, le clic déclenche en arrière-plan un événement de *callback\_query* , tout en gardant l’historique du chat propre.
  * En utilisant `Bouton clavier`, la plateforme interprète le clic comme l’envoi d’un message texte contenant le nom du bouton choisi par l’utilisateur.
* Interpolation de variables : le champ *Message* est entièrement compatible avec la syntaxe des doubles accolades `{{...}}`, permettant de personnaliser la question en fonction des données collectées dans les nœuds précédents (ex. : « Compris, `{{nome}}`! Quel est votre niveau de satisfaction ? »).

### Exemples pratiques

Le tableau ci-dessous montre des scénarios traditionnels d’application de ce composant dans le flux Telegram :

| **Type sélectionné** | **Type de bouton (buttons\_type)** | **Énoncé du message**                                       | **Options / boutons configurés**  | **Cas d’utilisation pratique**                                                                                                                   |
| -------------------- | ---------------------------------- | ----------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Texte`              | *Aucun*                            | "Veuillez saisir votre e-mail professionnel :"              | *Aucun (saisie de texte libre)*   | Capturer l’e-mail du contact par écrit pour qualifier des leads dans un pipeline de vente.                                                       |
| `Interactif`         | `Bouton en ligne`                  | "Souhaitez-vous recevoir les mises à jour de la commande ?" | \[Oui], \[Non]                    | Proposer une confirmation rapide au moyen de boutons inline attachés à la bulle de notification elle-même, générant des clics propres à l’écran. |
| `Interactif`         | `Bouton clavier`                   | "Sélectionnez le service d’assistance :"                    | \[Support], \[Finance], \[Ventes] | Remplacer le clavier par défaut de l’utilisateur dans l’application par de grandes options de menu de triage, facilitant le toucher sur mobile.  |


---

# 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-telegram/question-telegram.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.
