Cómo integrar Telegram en n8n au­to­alo­ja­do

La in­te­gra­ción de Telegram en una instancia au­to­alo­ja­da de n8n te permite in­co­r­po­rar mensajes y no­ti­fi­ca­cio­nes di­re­c­ta­me­n­te en tus flujos de trabajo de au­to­ma­ti­za­ción. En esta guía apre­n­de­rás paso a paso cómo conectar n8n con Telegram y crear tus primeros flujos sencillos para mensajes entrantes y salientes.

Ventajas de integrar n8n y Telegram

Telegram es una buena opción para in­te­grar­se con n8n, porque ofrece una co­mu­ni­ca­ción rápida, fiable y directa. Por lo general, los mensajes se entregan en tiempo real, de modo que puedes recibir avisos al instante sobre los eventos de tus flujos de trabajo. En co­m­pa­ra­ción con el correo ele­c­tró­ni­co u otros sistemas de no­ti­fi­ca­ción como Discord, que también se puede conectar con n8n, los mensajes de Telegram suelen verse antes en di­s­po­si­ti­vos móviles. Por ello, Telegram es ideal para alertas críticas, mensajes de estado o co­n­fi­r­ma­cio­nes.

Otra ventaja es la es­tru­c­tu­ra sencilla de la co­mu­ni­ca­ción. Los mensajes, archivos, imágenes o enlaces se pueden tra­n­s­fe­rir sin co­m­pli­ca­cio­nes y seguir pro­ce­sa­n­do en los flujos de trabajo. Por ejemplo, puedes enviar au­to­má­ti­ca­me­n­te a Telegram datos pro­ce­de­n­tes de distintas API, bases de datos u otras he­rra­mie­n­tas, como Jira integrado con n8n, sin tener que de­sa­rro­llar in­te­r­fa­ces adi­cio­na­les. Al mismo tiempo, los mensajes entrantes pueden servir como des­en­ca­de­na­n­tes para otras au­to­ma­ti­za­cio­nes, lo que permite crear flujos in­ter­ac­ti­vos.

Para in­s­ta­n­cias au­to­alo­ja­das de n8n, Telegram resulta muy práctico, ya que no necesitas una in­frae­s­tru­c­tu­ra adicional para las no­ti­fi­ca­cio­nes. Puedes conectar di­re­c­ta­me­n­te tus flujos de trabajo exi­s­te­n­tes con una apli­ca­ción de me­n­sa­je­ría que ya usas a diario. La co­mu­ni­ca­ción en equipo también se puede gestionar fá­ci­l­me­n­te enviando mensajes a grupos o canales. Así, varias personas pueden seguir al mismo tiempo los eventos im­po­r­ta­n­tes.

Paso 1: cumplir los re­qui­si­tos previos

Antes de empezar con la co­n­fi­gu­ra­ción, conviene comprobar si tienes todo lo necesario. Esto te ahorrará tiempo más adelante, ya que los errores más fre­cue­n­tes con los triggers de Telegram no suelen deberse al flujo de trabajo en sí, sino a re­qui­si­tos previos que faltan, como una URL de n8n no accesible pú­bli­ca­me­n­te o un bot que aún no se ha creado. Debes cumplir los si­guie­n­tes re­qui­si­tos:

• Una instancia de n8n au­to­alo­ja­da: tu entorno de n8n ya debe estar en fu­n­cio­na­mie­n­to y ser accesible desde el navegador.
• Una URL pública para n8n: para los eventos entrantes de Telegram, n8n necesita una dirección HTTPS accesible desde el exterior.
• Acceso a Telegram y un token de bot: necesitas una cuenta de Telegram y un token de acceso generado mediante BotFather para guardarlo después en n8n.
• Acceso a la co­n­fi­gu­ra­ción de n8n: si tu instancia se ejecuta detrás de un proxy inverso, deberías poder ajustar variables de entorno como WEBHOOK_URL, N8N_HOST y N8N_PROTOCOL.
• Opcional: un chat o grupo de prueba: así puedes probar la in­te­gra­ción sin afectar a procesos en pro­du­c­ción.

Paso 2: preparar los datos de acceso de Telegram

Para integrar Telegram en n8n, necesitas cre­de­n­cia­les de acceso válidas con las que n8n pueda au­te­n­ti­car­se en Telegram. Con estas cre­de­n­cia­les n8n puede enviar mensajes y, si utilizas un trigger, también recibir mensajes entrantes.

Si ya tienes una cuenta de Telegram, ya cuentas con la base principal. Sin embargo, Telegram no se conecta di­re­c­ta­me­n­te con n8n, sino a través de una interfaz técnica, la Bot API, para la que se necesita un token de acceso. Este token funciona como una clave única con la que n8n puede co­mu­ni­car­se con Telegram.

En muchos casos, este acceso ya existe, por ejemplo, si Telegram ya se utiliza en otras he­rra­mie­n­tas o au­to­ma­ti­za­cio­nes. En ese caso, puedes re­uti­li­zar el token existente e in­tro­du­ci­r­lo di­re­c­ta­me­n­te en n8n. Si aún no tienes un token de acceso, primero tendrás que crearlo como parte de un bot de Telegram para n8n. Este paso suele co­m­ple­tar­se rá­pi­da­me­n­te.

Trata el token de acceso como una co­n­tra­se­ña. Cualquier persona que tenga acceso a él puede enviar o procesar mensajes en nombre de tu in­te­gra­ción. Guárdalo de forma segura y no lo compartas pú­bli­ca­me­n­te.

Paso 3: hacer que n8n sea accesible co­rre­c­ta­me­n­te para los webhooks

Si utilizas Telegram en n8n solo para enviar mensajes, basta con guardar las cre­de­n­cia­les en n8n. En ese caso, la he­rra­mie­n­ta de au­to­ma­ti­za­ción establece ac­ti­va­me­n­te la conexión con Telegram, por lo que no hace falta ninguna co­n­fi­gu­ra­ción adicional.

Sin embargo, si quieres procesar mensajes entrantes y utilizar Telegram como trigger, tu instancia de n8n debe ser accesible desde el exterior. El motivo es que Telegram envía ac­ti­va­me­n­te los mensajes nuevos a n8n. Para ello, n8n utiliza webhooks, es decir, URL públicas a las que pueden acceder servicios externos. n8n genera estas URL au­to­má­ti­ca­me­n­te según la co­n­fi­gu­ra­ción de tu instancia.

No obstante, si n8n se ejecuta detrás de un proxy inverso, sin ajustes adi­cio­na­les no­r­ma­l­me­n­te solo conoce di­re­c­cio­nes internas. Como co­n­se­cue­n­cia, los webhooks se crean, pero no funcionan co­rre­c­ta­me­n­te desde el exterior.

El siguiente ejemplo para Docker Compose muestra cómo co­n­fi­gu­rar tu instancia de n8n para que genere URL públicas de webhook válidas y servicios externos como Telegram puedan acceder a ellas de forma fiable:

services:
    n8n:
        image: n8nio/n8n:latest
        ports:
            - "5678:5678"
        environment:
            - N8N_HOST=n8n.example.com
            - N8N_PROTOCOL=https
            - WEBHOOK_URL=https://n8n.example.com/
            - N8N_PROXY_HOPS=1
        volumes:
            - ./n8n_data:/home/node/.n8n

Paso 4: guardar las cre­de­n­cia­les de acceso de Telegram en n8n

En el siguiente paso, conecta Telegram con tu instancia de n8n. Para ello, solo tienes que guardar una vez en n8n las cre­de­n­cia­les que pre­pa­ra­s­te antes. n8n las almacena como Cre­de­n­tia­ls, de modo que puedas re­uti­li­zar­las después en cualquier flujo de trabajo sin tener que in­tro­du­cir el token cada vez.

Sigue estos pasos:

1. Abre la interfaz de n8n en el navegador.
2. Crea un nuevo flujo de trabajo para co­n­fi­gu­rar o probar la in­te­gra­ción.
3. Añade un nodo Telegram.
4. Haz clic en el área “Cre­de­n­tia­ls” en “Create new cre­de­n­tial”.
5. Introduce tu token de acceso existente en el campo “Access Token”.

Guarda la entrada. Después, la conexión con Telegram estará di­s­po­ni­ble de inmediato. Puedes se­le­c­cio­nar y usar las cre­de­n­cia­les creadas en cualquier otro flujo de trabajo. Este paso solo tienes que hacerlo una vez. A partir de ahí, puedes utilizar Telegram tantas veces como quieras en flujos de trabajo nuevos o exi­s­te­n­tes.

Close

A co­n­ti­nua­ción, prueba di­re­c­ta­me­n­te la conexión. Si todo está co­n­fi­gu­ra­do co­rre­c­ta­me­n­te, n8n mostrará el resultado co­rre­s­po­n­die­n­te:

Close

Paso 5: enviar tu primer mensaje de Telegram desde n8n

Para probar la in­te­gra­ción, se re­co­mie­n­da crear primero un flujo de trabajo muy sencillo que envíe un mensaje a Telegram. De este modo podrás comprobar rá­pi­da­me­n­te si la conexión entre n8n y Telegram funciona co­rre­c­ta­me­n­te, sin tener que trabajar desde el principio con triggers o lógicas más complejas.

La es­tru­c­tu­ra básica del flujo de trabajo tiene este aspecto:

Manual Trigger -> Telegram

Esto significa que el flujo de trabajo se inicia ma­nua­l­me­n­te y, a co­n­ti­nua­ción, se envía un mensaje a través del nodo Telegram. Para ello, añade primero un nodo Manual Trigger, que sirve para ejecutar el flujo de trabajo con un clic. Después, añade un nodo Telegram y conecta ambos nodos trazando una línea entre ellos.

En el nodo Telegram, se­le­c­cio­na las cre­de­n­cia­les de Telegram que has creado pre­via­me­n­te para que n8n sepa con qué datos de acceso debe enviar el mensaje. Después, configura el nodo eligiendo como Resource la opción “Message” y como Operation la opción “Send Message”. Indica también el destino. Para ello, introduce un ID de chat o un nombre de canal, por ejemplo “@cha­n­ne­l­na­me”. Este dato determina adónde se enviará el mensaje. Como prueba puedes usar cualquier texto; en nuestro ejemplo uti­li­za­mos: Hello World! From n8n.

Close

Puedes comprobar si el envío funciona haciendo clic en “Execute Step”:

Close

A co­n­ti­nua­ción, inicia el flujo de trabajo ma­nua­l­me­n­te. Si todo está co­n­fi­gu­ra­do co­rre­c­ta­me­n­te, el mensaje se mostrará de inmediato en Telegram.

Close

Paso 6: procesar mensajes entrantes de Telegram

Si quieres usar Telegram no solo para enviar mensajes, sino también como canal de entrada, utiliza el Telegram Trigger. Este nodo inicia tu flujo de trabajo au­to­má­ti­ca­me­n­te cuando llega un nuevo mensaje a Telegram. Así puedes procesar y responder di­re­c­ta­me­n­te a los mensajes entrantes.

Una es­tru­c­tu­ra sencilla tendría este aspecto:

Telegram Trigger -> Telegram

En nuestro ejemplo, se responde di­re­c­ta­me­n­te a un mensaje recibido. Para ello, añade primero un nodo Telegram Trigger a tu flujo de trabajo. Después, se­le­c­cio­na las cre­de­n­cia­les que has creado pre­via­me­n­te para que n8n pueda acceder a Telegram. A co­n­ti­nua­ción, define el evento deseado, por ejemplo, la recepción de nuevos mensajes.

En el siguiente paso, añade un nodo Telegram y conéctalo con el trigger. En este nodo, vuelve a elegir una operación de envío adecuada, por ejemplo “Send Message”, para enviar una respuesta.

Para que la respuesta llegue al chat correcto, puedes tomar el ID del chat di­re­c­ta­me­n­te de los datos del trigger. Esto significa que el flujo de trabajo responde au­to­má­ti­ca­me­n­te al mismo chat desde el que llegó el mensaje original. Así no tienes que in­tro­du­cir el ID del chat ma­nua­l­me­n­te.

Después de una prueba, n8n te muestra en la sección Output del nodo Telegram Trigger todos los datos recibidos. Ahí puedes ver exac­ta­me­n­te qué in­fo­r­ma­ción hay di­s­po­ni­ble, por ejemplo, el texto del mensaje, el ID del chat u otros metadatos.

Paso 7: usar el flujo de trabajo en pro­du­c­ción

En cuanto tu flujo de trabajo funcione co­rre­c­ta­me­n­te, podrás activarlo. A partir de ese momento, n8n procesará los mensajes entrantes de forma continua y enviará re­s­pue­s­tas o no­ti­fi­ca­cio­nes au­to­má­ti­ca­me­n­te. Como hasta ahora n8n solo ha guardado el flujo de trabajo como borrador, primero tienes que pu­bli­car­lo. Para ello, haz clic en el botón “Publish” (en versiones an­te­rio­res, utiliza el in­te­rru­p­tor de ac­ti­va­ción).

De este modo, Telegram se convierte en una parte fija de tu au­to­ma­ti­za­ción y actúa como interfaz de co­mu­ni­ca­ción dentro de tus flujos de trabajo de n8n.

Tres ideas prácticas para flujos de trabajo de Telegram con n8n

Telegram es ideal como interfaz para no­ti­fi­ca­cio­nes e in­ter­ac­cio­nes dentro de n8n. Resulta es­pe­cia­l­me­n­te útil cuando la in­fo­r­ma­ción debe estar di­s­po­ni­ble rá­pi­da­me­n­te o cuando hay que reac­cio­nar di­re­c­ta­me­n­te ante de­te­r­mi­na­dos eventos.

Ejemplo 1: notificar caídas de se­r­vi­do­res o páginas web

Con n8n puedes comprobar pe­rió­di­ca­me­n­te una página web o un servidor y recibir avisos au­to­má­ti­cos por Telegram si hay problemas. Para ello, se configura un flujo de trabajo que se ejecute a in­te­r­va­los fijos, por ejemplo, cada cinco minutos. Un nodo HTTP Request llama a la página web deseada y comprueba si es accesible. A co­n­ti­nua­ción, un nodo IF evalúa si el código de estado indica un problema, por ejemplo, un error o una falta de respuesta del servidor. En caso de error, n8n envía au­to­má­ti­ca­me­n­te un mensaje a Telegram, para que estés informado al instante. Así detectas caídas rá­pi­da­me­n­te sin tener que su­pe­r­vi­sar los sistemas ma­nua­l­me­n­te.

Close

Ejemplo 2: usar Telegram como canal de entrada para consultas

Telegram también puede servir como una interfaz de entrada sencilla y directa para tus flujos de trabajo. En este escenario, el flujo de trabajo de n8n se activa au­to­má­ti­ca­me­n­te cuando llega un mensaje nuevo. A co­n­ti­nua­ción, se evalúa el contenido del mensaje, por ejemplo, con un nodo IF o Switch. Según el contenido, se pueden ejecutar di­fe­re­n­tes acciones, como obtener datos de una API o de una base de datos. Después, los re­su­l­ta­dos se envían de nuevo a Telegram en forma de mensaje. De este modo se crea un flujo in­ter­ac­ti­vo sencillo con el que puedes consultar in­fo­r­ma­ción di­re­c­ta­me­n­te por chat. Así accedes rá­pi­da­me­n­te a los datos sin tener que iniciar sesión en otros sistemas.

Close

Ejemplo 3: reenviar au­to­má­ti­ca­me­n­te nuevas so­li­ci­tu­des o eventos

Otro caso de uso muy habitual es el reenvío au­to­má­ti­co de eventos desde otros sistemas a Telegram. Por ejemplo, cuando llega una nueva solicitud a través de un fo­r­mu­la­rio o se crea un pedido en la tienda, n8n puede procesar esta in­fo­r­ma­ción. El flujo de trabajo se inicia mediante un webhook o un trigger es­pe­cí­fi­co de una app. Después, los datos re­le­va­n­tes se preparan y se tra­n­s­fo­r­man en un mensaje claro y co­m­pre­n­si­ble. Este mensaje se envía au­to­má­ti­ca­me­n­te a un chat o grupo de Telegram. De este modo, tú y tu equipo podéis estar siempre al día sin tener que revisar co­n­s­ta­n­te­me­n­te distintos sistemas. Es­pe­cia­l­me­n­te en equipos pequeños, esto permite reac­cio­nar más rápido y mantener una mejor visión general.

Close