For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Última actualización

¿Te fue útil?