Trigger Receive Telegram

Descripcion

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

Configuracion

Parametros

Parametro	Tipo	Requerido	Descripcion
token	text	Si	Token del bot de Telegram (botToken). Se obtiene desde BotFather.
url_webhook	webhook_generator	No	URL del webhook generada automaticamente 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 basico

{
  "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 parametros en metadata.command y metadata.command_params.
Para fotos, se selecciona automaticamente la version de mayor resolucion.
El campo content contiene el contenido principal segun 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 interaccion.
Los metadatos de mensajes reenviados, respuestas y entidades se agregan automaticamente cuando estan presentes.

Nodos Relacionados

telegramVoiceToText (transcripcion de audio de Telegram)
Webhook (trigger generico)
decision (para evaluar el tipo de mensaje)