Telegram

Descripcion

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 automatica de mensajes largos (mas de 4000 caracteres), reintentos con backoff exponencial ante errores de red o rate limiting, validacion de formato Markdown, y fallback automatico a texto plano si el formato falla. Es ideal para notificaciones, alertas y comunicacion automatizada en workflows.

Configuracion

Parametro	Tipo	Requerido	Descripcion
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.

Salida

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

Ejemplo de Uso

Caso basico

{
  "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
• Accion de typing: POST https://api.telegram.org/bot{token}/sendChatAction
• Documentacion: https://core.telegram.org/bots/api

Notas

• Los mensajes de mas de 4000 caracteres se dividen automaticamente en multiples envios
• Si el formato Markdown falla, se reintenta automaticamente en texto plano
• Soporta variables dinamicas {{variable}} en el campo de mensaje
• Incluye reintentos automaticos (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 configuracion del nodo, o de las credenciales
• El typing_delay por defecto es de 300ms entre chunks de mensaje

Nodos Relacionados

• whatsapp (mensajeria via WhatsApp/Twilio)
• slack (mensajeria via Slack)