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

# Mensaje de Telegram

### 1. Visión General

El Componente de Envío de Mensajes de Telegram (identificado en la interfaz como `telegram_message`) es un nodo de acción outbound enfocado en la transmisión de contenido. Su función principal es inyectar correos electrónicos, alertas, textos informativos o archivos de medios directamente en el chat privado del usuario que interactúa con el bot de Telegram. Se utiliza para guiar conversaciones de forma lineal, entregar materiales de marketing o emitir avisos de transacciones sin retener al usuario en validaciones de respuesta.

### 2. Parámetros de Configuración

La parametrización del bloque establece las directrices del formato y el contenido del globo de mensaje que recibirá el cliente:

* Tipo de mensaje: Menú desplegable utilizado para elegir la categoría de payload que el robot transmitirá. Las opciones mapeadas incluyen:
  * `Texto`: Mensajes compuestos puramente por cadenas de texto plano, con compatibilidad con formatos simples de emojis y enlaces.
  * `Audio`: Envío de archivos de sonido o mensajes de voz en formatos compatibles con Telegram.
  * `Imagen`: Envío de medios gráficos, banners corporativos o fotos promocionales (PNG, JPG).
  * `Video`: Compartición de archivos audiovisuales reproducibles de forma nativa en el reproductor de la aplicación (MP4).
* Mensaje (\* Campo Obligatorio si Texto): El cuerpo principal del texto que se enviará al cliente en el chat.
* URL del archivo (\* Obligatorio para medios): Disponible cuando se seleccionan las opciones `Imagen`, `Audio` o `Video`. Permite pegar la dirección pública HTTP/HTTPS del archivo o realizar la carga mediante el botón de Upload.

### 3. Constructor Visual

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

* Diseño de Texto Simplificado: Al trabajar en el modo `Texto`, la interfaz aísla solo el cuadro de escritura *Mensaje*, exigiendo el llenado de contenido (`*`) para que el nodo pueda guardarse.
* Diseño de Medios Avanzado: Al cambiar al modo `Imagen`, el cuadro de texto largo es reemplazado por el campo *URL del archivo* y el botón morado de Upload, que permite arrastrar archivos directamente desde el ordenador del administrador del flujo a los servidores de la plataforma.

### 4. Operadores Especiales

Las propiedades lógicas de este componente gestionan la interpolación de cadenas dinámicas y el procesamiento de entrega asíncrona:

* Interpolación de Tags por Llaves Dobles: El campo *Mensaje* es totalmente compatible con la inserción de metadatos guardados en el contacto utilizando la sintaxis `{{...}}`. Esto permite personalizar avisos activos de forma individualizada (ej.: "Tu factura vence mañana, `{{nombre}}`!").
* Procesamiento Asíncrono sin Estado de Standby: A diferencia del nodo de pregunta de Telegram, este componente no genera pausa de ejecución en el recorrido. El motor de la plataforma envía la solicitud de publicación a los servidores de la API de Telegram y libera el contacto inmediatamente hacia el siguiente bloque conectado al nodo.

### 5. Ejemplos Prácticos

La tabla siguiente demuestra escenarios clásicos de aplicación de este componente para alimentar flujos de conversación en Telegram:

| **Tipo de Mensaje Seleccionado** | **URL del Archivo / Upload** | **Contenido Configurado (Mensaje)**                                                                                  | **Caso de Uso Práctico**                                                                                                    |
| -------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `Texto`                          | *Ninguno*                    | "¡Bienvenido al canal oficial de soporte! 🤖"                                                                        | Disparar un saludo inicial instantáneo en cuanto el contacto activa el bot mediante un gatillo receptivo.                   |
| `Imagen`                         | *Carga de comprobante.png*   | *Ninguno*                                                                                                            | Mostrar un infográfico explicativo con el paso a paso de un producto justo después de que el lead elija una opción de menú. |
| `Texto`                          | *Ninguno*                    | "Espere un momento, `{{nombre}}`. Estamos transfiriendo su atención a la cola del sector de `{{sector_elegido}}`..." | Mostrar un aviso de transición dinámico antes de activar el componente de transferencia humana.                             |


---

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