Trigger Receive Telegram

Descripción

El modulo telegramReceive es un trigger que inicia el workflow cuando se recibe un mensaje en un bot de Telegram. Procesa múltiples tipos de contenido: texto, comandos, fotos, voz, documentos, audio, video, ubicación, contactos, stickers, encuestas, venues y callback queries (botones inline). Para cada tipo de contenido, extrae la información relevante y la estructura de forma uniforme con campos type, chatId, content, from, chat y metadata. También detecta mensajes reenviados, respuestas y entidades del texto.

Cómo configurar (paso a paso)

Para que el bot reciba mensajes hacen falta dos cosas: el token del bot y un webhook registrado en Telegram que apunte a Floogos.

1. Creá el bot en Telegram. Abrí un chat con @BotFather, enviá /newbot, elegí un nombre y un usuario para el bot. Al terminar, BotFather te da el token (formato 123456:ABC-DEF...). Guardalo.

2. Pegá el token en el nodo. En el nodo Trigger Receive Telegram, completá el campo Token del bot con ese token.

3. Generá la URL del webhook. En el mismo nodo, generá la URL Webhook: Floogos crea el endpoint público que recibirá las actualizaciones de Telegram.

4. Registrá el webhook en Telegram. Una sola vez, decile a Telegram que envíe los mensajes a esa URL. Pegá esto en el navegador (o usá curl), reemplazando <TOKEN> y <URL_WEBHOOK>:

   https://api.telegram.org/bot<TOKEN>/setWebhook?url=<URL_WEBHOOK>

   Respuesta esperada: {"ok":true,"result":true,"description":"Webhook was set"}.

5. Verificá. Consultá https://api.telegram.org/bot<TOKEN>/getWebhookInfo: debe mostrar tu url. Escribile al bot desde Telegram — el workflow se dispara.

6. Activá el workflow. Pasalo a estado Activo para que quede escuchando.

El nodo avisa si falta configuración

Si no cargás el token o no generás la URL del webhook, el nodo muestra una advertencia en el editor: sin ambos, el disparador no puede recibir mensajes.

Quitar o cambiar el webhook

Un token solo puede tener un webhook activo a la vez. Para quitarlo: https://api.telegram.org/bot<TOKEN>/deleteWebhook. Si movés el bot a otra URL, volvé a hacer setWebhook.

Para responder al usuario que escribió, agregá después un nodo Telegram y usá {{data.chatId}} como destino (el trigger deja el chatId en la salida).

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
token	text	Si	Token del bot de Telegram (botToken). Se obtiene desde BotFather.
url_webhook	webhook_generator	No	URL del webhook generada automáticamente para recibir actualizaciones de Telegram.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "type": "text",
    "chatId": 123456789,
    "from": { "id": 123456789, "first_name": "Juan", "language_code": "es" },
    "botToken": "123456:ABCdefGHIjklMNO",
    "date": "2026-03-23T10:00:00.000Z",
    "content": "Hola, necesito ayuda",
    "chat": { "id": 123456789, "type": "private", "first_name": "Juan" },
    "metadata": {
      "message_id": 42,
      "update_id": 987654321,
      "is_edited": false
    }
  }
}

Ejemplo de Uso

Caso básico

{
  "label": "Trigger Receive Telegram",
  "token": "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ",
  "url_webhook": {}
}

API Utilizada

Telegram Bot API - Webhook updates. La URL del webhook se registra en https://api.telegram.org/bot{token}/setWebhook.

Notas

• Tipos de mensaje soportados: text, command, photo, voice, document, audio, video, location, venue, contact, sticker, poll, callback_query.
• Para comandos (mensajes que empiezan con /), el tipo se establece como command y se extraen el comando y sus parámetros en metadata.command y metadata.command_params.
• Para fotos, se selecciona automáticamente la versión de mayor resolución.
• El campo content contiene el contenido principal según el tipo: texto del mensaje, file_id para archivos, coordenadas para ubicaciones, etc.
• El botToken se incluye en la salida para que nodos posteriores puedan enviar respuestas al usuario.
• Soporta callback queries (botones inline), devolviendo el callback_query_id en metadata para confirmar la interacción.
• Los metadatos de mensajes reenviados, respuestas y entidades se agregan automáticamente cuando estan presentes.

Nodos Relacionados

• telegramVoiceToText (transcripción de audio de Telegram)
• Webhook (trigger genérico)
• decision (para evaluar el tipo de mensaje)