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_tokennormalmente no es el token real, sino una referencia a credencial con el formato:/**$credential("botToken", <id>)**/configactualmente 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 tipoTelegram)