Saltar a contenido

Trigger: Telegram (telegram_trigger)

Este trigger inicia una automatización cuando el sistema recibe mensajes desde Telegram a través de un bot.

Requisitos previos

  • Tener un bot de Telegram creado con @BotFather.
  • Tener a mano el Bot Token (se trata como secreto).


Cómo configurarlo (recomendado: usando el formulario)

La mayoría de usuarios debería usar la pestaña Form.

Paso 0) Abrir la parametrización

  • En el canvas de automatizaciones, hacé doble click sobre el nodo Telegram.

Paso 1) Configurar el Bot Token (con credenciales)

En Bot Token vas a ver un selector de credenciales.

  • Si ya existe una credencial: seleccionála de la lista.
  • Si no existe: elegí Create new credential y cargá el campo Bot Token.
  • Si querés cambiarla: elegí la credencial y usá el botón Edit.

Por qué se usa “Credential” y no pegar el token

  • El token queda almacenado como credencial segura y reutilizable.
  • Evita exponer secretos en la configuración del nodo.

Qué hace este trigger (a nivel usuario)

  • Cuando llega un mensaje al bot configurado, se dispara la automatización.
  • El trigger solo requiere el bot token; el resto del enrutamiento/recepción de mensajes lo gestiona la plataforma.

Si el bot token es inválido o no está configurado, el trigger no podrá recibir mensajes.


Troubleshooting (problemas comunes)

  • No dispara cuando mando un mensaje al bot
  • Confirmá que el trigger tiene un Bot Token configurado mediante credencial.
  • Probá crear una credencial nueva (por si el token anterior fue revocado).
  • Verificá que estás escribiéndole al bot correcto (el username del bot).

  • Veo “Legacy Credentials Detected”

  • Significa que antes se guardaba el token “en crudo” dentro del nodo.
  • Solución: seleccioná o creá una credencial en el selector para migrar al método nuevo.

  • Seguridad

  • Tratá el bot token como contraseña: no lo pegues en capturas, tickets, ni documentos públicos.

Configuración avanzada (JSON Editor) (solo usuarios expertos)

En la pestaña JSON Editor podés ver/editar la estructura que guarda el nodo.

Formato del input:

{
  "ruleSet": {
    "bot_token": "/**$credential(\"botToken\", 123)**/"
  },
  "config": {}
}
  • ruleSet.bot_token normalmente no es el token real, sino una referencia a credencial con el formato:
  • /**$credential("botToken", <id>)**/
  • config actualmente se guarda como {}.

Referencias internas (para ubicarlo en el editor)

  • Key del nodo: telegram_trigger
  • Clase: trigger
  • Campo requerido: Bot Token (vía credencial de tipo Telegram)