> 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/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/componentes-de-telegram/pregunta-de-telegram.md).

# Pregunta de Telegram

### Visión general

El Componente de Pregunta de Telegram (identificado en la interfaz como `telegram_question`) es un nodo de interacción outbound enfocado en la recopilación de datos y el engagement. Su función principal es lanzar una pregunta al usuario dentro del chat de Telegram y mantener la automatización en estado de espera (*standby*) hasta que ocurra una respuesta válida. Soporta tanto la recopilación de entradas textuales tradicionales como interacciones basadas en botones clicables, adaptándose a las reglas de diseño nativas de la aplicación.

### Parámetros de configuración

La parametrización del bloque gestiona los formatos de visualización del mensaje y las reglas de persistencia de las respuestas en el sistema:

* Tipo: Menú desplegable que define la mecánica de entrada del componente:
  * `Texto`: Espera una respuesta escrita manualmente por el usuario.
  * `Interactivo` (o `Interactivo`): Habilita el envío de botones clicables integrados al mensaje.
* Mensaje: Campo de texto para completar el enunciado de la pregunta que se enviará al contacto en el chat.
* Tiene Variable (Llave de alternancia - Toggle Switch): Habilita el almacenamiento de la respuesta dada por el cliente en la memoria interna del flujo.
* Destino de la Respuesta: Desplegable opcional para mapear el dato recibido directamente a un campo estándar del perfil del contacto en el CRM (ej.: *Nombre*, *Correo electrónico*, *Teléfono*).
* buttons\_type \* (\* Obligatorio si es Interactivo): Menú que selecciona el formato de renderizado de los botones conforme a los patrones de diseño de Telegram:
  * `Botón en línea`: Crea botones adjuntos directamente debajo del globo del mensaje (*Teclados en línea*).
  * `Botón de teclado`: Sustituye temporalmente el teclado predeterminado del usuario en la aplicación por bloques de botones de respuesta rápida (*Teclados de respuesta*).
* Múltiples Salidas (Llave de alternancia - Toggle Switch): Cuando está activa, crea una ramificación física en el editor de flujos para cada botón añadido, permitiendo caminos personalizados para cada elección.

### Constructor visual

La interfaz del constructor adapta sus campos de forma condicional según la opción elegida en el parámetro *Tipo*:

* Diseño modular para modo interactivo: Seleccionar la modalidad `Interactivo` desbloquea el parámetro obligatorio `buttons_type *`. El panel se expande verticalmente para mostrar los repetidores donde el administrador inserta las etiquetas de texto de cada botón y decide el diseño físico de la cuadrícula de respuestas.
* Validación por asterisco: El selector de formato de botones trae el indicativo de asterisco (`*`), señalando al administrador que el nodo no será validado ni guardado de forma incompleta si los botones nativos no se crean.

### Operadores especiales

Las propiedades lógicas de este componente tratan con callbacks nativos de Telegram e interpolación de etiquetas:

* Manejo de callbacks independientes (`Inline` vs `Reply`): El motor diferencia la lógica de clic:
  * Al usar `Botón en línea`, el clic dispara un evento de *callback\_query* en segundo plano, manteniendo limpio el historial del chat.
  * Al usar `Botón de teclado`, la plataforma interpreta el clic como el envío de un mensaje de texto que contiene el nombre del botón elegido por el usuario.
* Interpolación de Variables: El campo *Mensaje* es totalmente compatible con la sintaxis de llaves dobles `{{...}}`, permitiendo personalizar la pregunta con base en datos recopilados en nodos anteriores (ej.: "Entendido, `{{nombre}}`! ¿Cuál es tu nivel de satisfacción?").

### Ejemplos prácticos

La tabla a continuación muestra escenarios tradicionales de aplicación de este componente en el flujo de Telegram:

| **Tipo seleccionado** | **Tipo de Botón (buttons\_type)** | **Enunciado del Mensaje**                               | **Opciones / Botones Configurados** | **Caso de uso práctico**                                                                                                           |
| --------------------- | --------------------------------- | ------------------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `Texto`               | *Ninguno*                         | "Por favor, escribe tu correo electrónico corporativo:" | *Ninguno (Entrada de texto libre)*  | Capturar el correo electrónico del contacto de forma escrita para validar leads en un embudo de ventas.                            |
| `Interactivo`         | `Botón en línea`                  | "¿Desea recibir las actualizaciones del pedido?"        | \[Sí], \[No]                        | Ofrecer una confirmación rápida mediante botones inline adjuntos al propio globo de aviso, generando clics limpios en la pantalla. |
| `Interactivo`         | `Botón de teclado`                | "Seleccione el área de atención:"                       | \[Soporte], \[Finanzas], \[Ventas]  | Cambiar el teclado predeterminado del usuario en la app por opciones grandes de menú de triaje, facilitando el toque en el móvil.  |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/componentes-de-telegram/pregunta-de-telegram.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.