Integración de Telegram Bot para flujos automatizados

Descripción

El modulo Telegram permite enviar mensajes de texto y archivos a chats o grupos de Telegram a traves de la API de Telegram Bot. Incluye funcionalidades avanzadas como indicador de “escribiendo…”, division automática de mensajes largos (mas de 4000 caracteres), reintentos con backoff exponencial ante errores de red o rate limiting, validación de formato Markdown, y fallback automático a texto plano si el formato falla. Es ideal para notificaciones, alertas y comunicación automatizada en workflows.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credenciales del bot de Telegram
chatId	text	Si	ID del chat o grupo de destino
message	textarea	Si	Mensaje a enviar (soporta variables `{{variable}}`)
parse_mode	select	No	Formato del mensaje: Markdown V2, HTML o sin formato
show_typing	boolean	No	Mostrar indicador de “escribiendo…” antes de enviar (por defecto: true)

Credenciales

La credencial debe contener los campos:

botToken: Token del bot de Telegram (obtenido de @BotFather, formato 123456:ABC-DEF...)
chatId: ID del chat por defecto (puede ser sobreescrito por el campo chatId del nodo o por data.chatId)

Para configurar las credenciales, primero crea un bot en Telegram mediante @BotFather y obtiene el token. El chatId se puede obtener enviando un mensaje al bot y consultando la API de Telegram.

Configurar la credencial (paso a paso)

Creá el bot con @BotFather (/newbot) y copiá el token (123456:ABC-DEF...).
Creá la credencial en Floogos. En Credenciales → Nueva, elegí Telegram y pegá el botToken. Opcionalmente un chatId por defecto.
Seleccioná la credencial en el campo Credenciales del bot del nodo Telegram.

Ver también: Credenciales de Telegram.

Responder al usuario que escribió

Cuando el mensaje llega desde el nodo Trigger Receive Telegram, el trigger deja el chat de origen en data.chatId. Para que la respuesta vuelva al mismo usuario, poné {{data.chatId}} en el campo Chat ID (o dejalo vacío: el nodo usa data.chatId automáticamente si está presente). Así no hace falta hardcodear un chat y sirve para cualquier usuario que escriba.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "status": 200,
    "telegram_response": "success",
    "messages_sent": 1
  }
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "cred_telegram_01",
  "chatId": "-1001234567890",
  "message": "Pedido {{orderId}} procesado correctamente",
  "parse_mode": "MarkdownV2",
  "show_typing": true
}

API Utilizada

Enviar mensaje: POST https://api.telegram.org/bot{token}/sendMessage
Enviar documento: POST https://api.telegram.org/bot{token}/sendDocument
Acción de typing: POST https://api.telegram.org/bot{token}/sendChatAction
Documentación: https://core.telegram.org/bots/api

Notas

Los mensajes de mas de 4000 caracteres se dividen automáticamente en múltiples envíos
Si el formato Markdown falla, se reintenta automáticamente en texto plano
Soporta variables dinámicas {{variable}} en el campo de mensaje
Incluye reintentos automáticos (hasta 3) con backoff exponencial para errores 429 y 5xx
El caption de archivos esta limitado a 1024 caracteres por la API de Telegram
El chatId puede venir del data de entrada (data.chatId), de la configuración del nodo, o de las credenciales
El typing_delay por defecto es de 300ms entre chunks de mensaje

Nodos Relacionados

whatsapp (mensajería vía WhatsApp/Twilio)
slack (mensajería vía Slack)