- Inicio
- Recursos
- Integraciones
- Telegram
Integración Telegram n8nAutomatiza Telegram con n8n.
¿Hasta dónde llega un bot en una integración Telegram n8n? El nodo expone 24 operaciones en 4 recursos, desde un mensaje de texto hasta un anuncio fijado o un archivo recuperado de una conversación. El trigger escucha 9 tipos de actualización. Encaja en avisos, validaciones y bots de soporte.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué cubre de verdad la integración Telegram n8n?
La integración Telegram n8n se apoya en dos nodos que vienen con n8n. El nodo de Telegram hace de bot: publica texto, fotos, vídeos, audio, documentos, stickers y ubicaciones en una conversación, edita o borra lo que ya envió, fija y desfija mensajes, y vuelve a leer los datos de un chat. El Telegram Trigger, el nodo que arranca un flujo, salta en cuanto una actualización llega a ese mismo bot.
La primera forma, y la más corta, es el aviso. Un flujo que vigila un lead nuevo en Mautic termina en message.sendMessage, y el grupo comercial ve la línea en segundos. Pon Parse Mode en HTML cuando las cifras tengan que destacar, y apaga Append n8n Attribution en Additional Fields para que el mensaje no acabe con la firma de n8n.
La segunda es la validación, y es lo que separa Telegram de un canal de avisos de un solo sentido. message.sendAndWait lanza la pregunta y detiene la ejecución hasta que alguien responde, de ahí que esa operación traiga un Response Type con Approval, Free Text y Custom Form. Un descuento fuera de tarifa, una compra, una baja: la decisión se toma en el hilo y el flujo continúa solo después.
La tercera es un bot de doble sentido. El trigger salta con un message entrante, el flujo responde con message.sendMessage y una respuesta por teclado inline vuelve como callback_query que callback.answerQuery contesta. Las fotos que mandan los equipos pasan por file.get antes de archivarse en Google Sheets. El mismo patrón funciona en Slack, con una diferencia práctica: un grupo de Telegram se direcciona con un Chat ID numérico, y @channelusername solo vale en canales públicos.
El nodo HTTP Request toma el relevo en cuanto el método de la Bot API que necesitas queda fuera de las 24 operaciones. Llama a cualquier endpoint de Telegram reutilizando el mismo credential, la credencial que se guarda una vez en n8n, así que no hay que rehacer nada. Dos límites piden plan: la Bot API acepta 30 mensajes por segundo, cifra que un nodo Loop Over Items pasando como mucho 30 Chat ID y una pausa con un nodo Code mantienen a raya, y Telegram guarda un único webhook por bot, de modo que un flujo en pruebas le quita los eventos a la versión publicada.
Si la duda es la plataforma y no el nodo, la Reseña n8n repasa alojamiento y coste, y el Curso n8n enseña a montar este tipo de flujo de principio a fin.
¿Cómo se conecta Telegram con n8n?
- 01
Crear el bot con BotFather
Una cuenta de Telegram basta como requisito. Abre un chat con
@BotFather, envía/newboty responde sus dos preguntas. El name aparece en la ficha de contacto y se cambia luego. El username lo usan la búsqueda, las menciones y los enlaces t.me: de 5 a 32 caracteres, letras latinas, números y guiones bajos, sin distinguir mayúsculas, terminado enbote inamovible. - 02
Guardar el token como credential
BotFather responde con un token. En n8n, abre el menú Credentials, crea un credential de Telegram y pega ese valor en Access Token. Es el único método de autenticación que admiten estos nodos. Un credential se crea una vez y luego aparece en la lista desplegable de cada flujo que lo necesita, y el Telegram Trigger toma exactamente el mismo, así que un bot se configura una sola vez.
- 03
Dar acceso al bot en el canal
Un bot no publica donde no es miembro. En la aplicación de Telegram, abre el canal de destino y toca su nombre, márcalo como canal público y entra en Administrators, Add Admin, busca el username del bot y confirma con la marca de la esquina superior derecha. Sin este paso, la primera ejecución devuelve
Error: Forbidden: bot is not a participant of the channel.
¿Qué arranca un flujo desde Telegram ?
Telegram Trigger es el nodo que arranca un workflow cuando algo ocurre en Telegram. Escucha 9 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Telegram llama) en tu cuenta.
Lo que ves en n8n
Todos los eventos, por familia
Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.
callback_query.*1callback_query. callback_query
channel_post.*1channel_post. channel_post
edited_channel_post.*1edited_channel_ post. edited_channel_ post
edited_message.*1edited_message. edited_message
inline_query.*1inline_query. inline_query
message.*1message.message
poll.*1poll.poll
pre_checkout_query.*1pre_checkout_ query. pre_checkout_ query
shipping_query.*1shipping_query. shipping_query
El trigger también acepta * (cualquier evento). Útil para logs, peligroso en producción.
Notas de configuración
01Telegram Trigger setup
El Telegram Trigger registra un webhook al activar el flujo. Un webhook es una URL que Telegram llama: cada actualización entra en n8n en segundos, sin consultar la API cada cierto tiempo.
Parámetros clave
- Trigger On: las actualizaciones a las que se suscribe el bot. El catálogo expone 9, y
*recoge todo menos Chat Member, Message Reaction y Message Reaction Count. - Restrict to Chat IDs: dispara solo con los Chat ID que enumeres aquí, separados por comas.
- Restrict to User IDs: el mismo filtro aplicado a identificadores de usuario.
- Download Images/Files: trae al item la imagen o el archivo adjunto, con Image Size eligiendo el tamaño, el grande por defecto.
02Message and Edited Message
Estos dos llevan el tráfico normal de una conversación, y sobre esa pareja se construye la mayoría de los bots.
Parámetros clave
- Message (
message): un mensaje entrante nuevo de cualquier tipo, texto, foto o sticker. - Edited Message (
edited_message): una versión nueva de un mensaje que el bot ya conoce y que se editó.
03Channel Post and Edited Channel Post
Un canal emite en una sola dirección, y Telegram reporta su actividad aparte de los mensajes de conversación.
Parámetros clave
- Channel Post (
channel_post): una publicación entrante nueva en un canal, de cualquier tipo, incluidos texto, foto y sticker. - Edited Channel Post (
edited_channel_post): una versión nueva de una publicación de canal que el bot conoce y que se editó.
04Callback Query and Inline Query
Estos dos eventos nacen de una interacción con el bot y no de un mensaje escrito, y ambos esperan una respuesta de vuelta.
Parámetros clave
- Callback Query (
callback_query): una callback query entrante nueva, del tipo que devuelve un teclado inline al bot. - Inline Query (
inline_query): una inline query entrante nueva, que surge cuando alguien escribe el nombre del bot dentro de cualquier chat.
callback.answerQuery, que devuelve la respuesta a ese teclado. La vía de la escritura se completa con callback.answerInlineQuery, que devuelve la lista de resultados que la persona inserta.05Poll, Pre-Checkout Query and Shipping Query
Los tres últimos eventos son estrechos a propósito, y cada uno arrastra una condición que conviene saber antes de construir encima.
Parámetros clave
- Poll (
poll): un estado nuevo de encuesta. Los bots solo reciben actualizaciones de encuestas detenidas y de las que ellos mismos enviaron. - Pre-Checkout Query (
pre_checkout_query): una pre-checkout query entrante nueva, con la información completa de la compra. - Shipping Query (
shipping_query): una shipping query entrante nueva, solo para facturas con precio flexible.
¿Qué sabe hacer el nodo de Telegram ?
El nodo Telegram expone 24 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Get | Get Administrators | Answer Inline Query | Answer Query | Delete Chat Message | Edit Message Text | Leave | Get Member | Pin Chat Message | Send and Wait for Response | Send Animation | Send Audio | Send Chat Action | Send Document | Send Location | Send Media Group | Send Message | Send Photo | Send Sticker | Send Video | Set Description | Set Title | Unpin Chat Message |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chat | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||||||||||||
| Callback | ✓ | ✓ | |||||||||||||||||||||
| File | ✓ | ||||||||||||||||||||||
| Message | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Índice de operaciones
Chat
6 operacionesGet a chat
chat.getLo que ves en n8n
Notas y casos de uso
Trae al flujo el estado actual de un chat, para que los nodos siguientes decidan sobre lo que Telegram devuelve y no sobre una suposición.
Parámetros clave
- Chat ID: el identificador único del chat de destino, o su nombre de usuario. Si no lo tienes a mano, pídeselo a
@get_id_bot.
Get all administrators in a chat
chat.administratorsLo que ves en n8n
Notas y casos de uso
Devuelve en una sola llamada los administradores de un chat, con el método getChatAdministrators de la Bot API.
Parámetros clave
- Chat ID: el Chat ID o el nombre del canal en formato
@channelusername. Un Telegram Trigger colocado antes en el flujo te entrega ese valor directamente.
Get a member in a chat
chat.memberLo que ves en n8n
Notas y casos de uso
Consulta a una persona concreta dentro de un chat concreto y devuelve su ficha de miembro.
Parámetros clave
- Chat ID: el chat en el que se comprueba la pertenencia.
- User ID: el identificador único del usuario de destino.
Leave a chat
chat.leaveLo que ves en n8n
Notas y casos de uso
Saca al bot de un grupo, un supergrupo o un canal.
Parámetros clave
- Chat ID: el grupo, supergrupo o canal que el bot abandona.
Set description on a chat
chat.setDescriptionLo que ves en n8n
Notas y casos de uso
Sustituye por otro el texto que aparece bajo el nombre del chat.
Parámetros clave
- Chat ID: el chat cuya descripción cambia, como identificador o como
@channelusername. - Description: la nueva descripción del chat, de 0 a 255 caracteres, un techo que conviene tener presente al construir la cadena.
Set a title on a chat
chat.setTitleLo que ves en n8n
Notas y casos de uso
Cambia el nombre de un chat desde el flujo, algo que gana sentido cuando ese nombre lleva información.
Parámetros clave
- Chat ID: el chat que se renombra.
- Title: el nuevo título del chat, de 1 a 255 caracteres.
Callback
2 operacionesAnswer Query a callback
callback.answerQueryLo que ves en n8n
Notas y casos de uso
Contesta una callback query enviada desde un teclado inline, para que cada botón de ese teclado reciba respuesta del flujo.
Parámetros clave
- Query ID: el identificador único de la consulta que se responde. Un Telegram Trigger puesto en Callback Query lo pasa.
- Text: una notificación opcional de 0 a 200 caracteres. Si la dejas vacía, no se muestra nada.
- Show Alert: convierte esa notificación en una ventana de alerta en lugar de un aviso en la parte superior del chat.
Answer an inline query callback
callback.answerInlineQueryLo que ves en n8n
Notas y casos de uso
Rellena la lista de resultados que ve quien escribe el nombre del bot en cualquier conversación, sin que tenga que salir de ella.
Parámetros clave
- Query ID: el identificador único de la consulta respondida, tomado de un Telegram Trigger puesto en Inline Query.
- Results: un array de resultados serializado en JSON. Telegram admite 50 como máximo por consulta.
- Cache Time: cuántos segundos puede el cliente guardar esa respuesta en caché.
File
1 operaciónGet a file
file.getLo que ves en n8n
Notas y casos de uso
Recupera a partir de su identificador un archivo al que el bot llega, y si hace falta trae su contenido al flujo.
Parámetros clave
- File ID: el identificador del archivo que se quiere obtener.
- Download: activado, el nodo descarga el archivo; desactivado, solo devuelve su ficha.
- MIME Type: se indica cuando la extensión por sí sola no identifica el archivo, por ejemplo
image/jpeg.
Message
15 operacionesDelete a chat message
message.deleteMessageLo que ves en n8n
Notas y casos de uso
Borra un mensaje de una conversación con el método deleteMessage de la Bot API.
Parámetros clave
- Chat ID: la conversación que contiene el mensaje.
- Message ID: el identificador único del mensaje que se borra.
Edit a text message
message.editMessageTextLo que ves en n8n
Notas y casos de uso
Reescribe en su sitio el texto de un mensaje ya publicado, en vez de apilar debajo una corrección.
Parámetros clave
- Chat ID: la conversación donde vive el mensaje que se reescribe.
- Message ID: el identificador único del mensaje que se edita.
- Inline Message ID: se usa en su lugar cuando Message Type vale Inline Message.
- Text: el texto en el que se convierte el mensaje.
- Reply Markup: None, o Inline Keyboard para conservar botones bajo el texto editado.
Pin a chat message
message.pinChatMessageLo que ves en n8n
Notas y casos de uso
Fija un mensaje para que se quede arriba del chat a la vista de todos.
Parámetros clave
- Chat ID: la conversación donde aparece la fijación.
- Message ID: el identificador único del mensaje que se fija.
- Disable Notification: campo de Additional Fields que decide si todos los miembros reciben aviso del nuevo mensaje fijado.
Send an animated file
message.sendAnimationLo que ves en n8n
Notas y casos de uso
Publica un GIF, o un vídeo H.264/MPEG-4 AVC sin sonido, hasta 50 MB.
Parámetros clave
- Chat ID: la conversación donde aterriza la animación.
- Binary File: activado cuando el archivo viene del propio flujo.
- Input Binary Field: el nombre de la propiedad binaria que contiene ese archivo.
- Animation: se usa con Binary File desactivado. Pasa un
file_idque ya esté en los servidores de Telegram, la vía recomendada, o una URL HTTP.
Send an audio file
message.sendAudioLo que ves en n8n
Notas y casos de uso
Manda un archivo de audio, que Telegram muestra en su reproductor de música.
Parámetros clave
- Chat ID: la conversación de destino.
- Binary File e Input Binary Field: el interruptor y el nombre de la propiedad cuando el audio llega de un nodo anterior.
- Audio: un
file_ido una URL HTTP, en lugar de la vía binaria. - Performer y Title: campos de Additional Fields que rellenan las dos líneas del reproductor.
Send a chat action
message.sendChatActionLo que ves en n8n
Notas y casos de uso
Avisa a la conversación de que algo se está moviendo del lado del bot. Telegram mantiene ese estado 5 segundos o menos.
Parámetros clave
- Chat ID: la conversación que ve el estado.
- Action: lo que se difunde, elegido según lo que la persona está a punto de recibir. Typing, Upload Photo, Upload Document, Record Audio, Find Location y el resto de la lista.
Send a document
message.sendDocumentLo que ves en n8n
Notas y casos de uso
Entrega un archivo como documento, el formato adecuado para un PDF, una exportación o un comprimido.
Parámetros clave
- Chat ID: la conversación que recibe el archivo.
- Binary File e Input Binary Field: activa el interruptor y nombra la propiedad binaria que lleva el documento.
- Document: un
file_ido una URL HTTP cuando la vía binaria está apagada. - File Name: campo de Additional Fields que fija el nombre que ve quien lo recibe.
Send a location
message.sendLocationLo que ves en n8n
Notas y casos de uso
Coloca un punto en el mapa dentro del chat, construido a partir de dos coordenadas.
Parámetros clave
- Chat ID: la conversación donde se publica el punto.
- Latitude: la latitud del lugar.
- Longitude: la longitud del lugar.
Send a media group message
message.sendMediaGroupLo que ves en n8n
Notas y casos de uso
Agrupa varias fotos y vídeos en un solo álbum en lugar de una ráfaga de mensajes sueltos.
Parámetros clave
- Chat ID: la conversación que recibe el álbum.
- Media: usa Add Media una vez por archivo. Cada entrada lleva un Type, Photo o Video, y un Media File dado como
file_ido como URL HTTP.
Send a text message
message.sendMessageLo que ves en n8n
Notas y casos de uso
Aquí termina la mayoría de los flujos. El bot publica texto en una conversación, y ya está.
Parámetros clave
- Chat ID: la conversación de destino, como identificador numérico o como
@channelusername. - Text: el cuerpo del mensaje, hasta 4096 caracteres tras el análisis de entidades.
- Parse Mode: Markdown, MarkdownV2 o HTML, para valores en negrita y enlaces.
- Append n8n Attribution: activo por defecto, de ahí que los mensajes enviados acaben con la línea de n8n. Añade el campo y apaga el interruptor para quitarla.
Send message and wait for response
message.sendAndWaitLo que ves en n8n
Notas y casos de uso
Publica un mensaje y deja la ejecución en espera hasta que alguien responde en Telegram, con lo que una conversación se convierte en un paso de validación.
Parámetros clave
- Chat ID: la conversación donde aparece la pregunta.
- Message: el texto que lee la persona antes de decidir.
- Response Type: Approval para un botón, Free Text para una respuesta escrita en un formulario, Custom Form para varios campos.
- Type of Approval: Approve Only, o Approve and Disapprove para los dos botones.
- Limit Wait Time: limita cuánto espera el nodo antes de seguir.
Send a photo message
message.sendPhotoLo que ves en n8n
Notas y casos de uso
Publica una imagen dentro de la conversación, la operación que toca cuando el visual es el mensaje.
Parámetros clave
- Chat ID: la conversación a la que va la imagen.
- Binary File e Input Binary Field: la pareja que se usa cuando un nodo anterior ha generado la imagen.
- Photo: un
file_idque ya esté en los servidores de Telegram, o una URL HTTP, con la vía binaria apagada. - Caption: de 0 a 1024 caracteres bajo la imagen.
Send a sticker
message.sendStickerLo que ves en n8n
Notas y casos de uso
Contesta con un sticker: .WEBP estático, .TGS animado o .WEBM en vídeo.
Parámetros clave
- Chat ID: la conversación que recibe el sticker.
- Binary File e Input Binary Field: se usan cuando el archivo del sticker viaja por el flujo.
- Sticker: un
file_idya alojado en los servidores de Telegram, o una URL HTTP a un archivo .webp.
Send a video
message.sendVideoLo que ves en n8n
Notas y casos de uso
Sube un vídeo al chat, junto con los campos que describen el clip.
Parámetros clave
- Chat ID: la conversación donde se publica el vídeo.
- Binary File e Input Binary Field: el interruptor y la propiedad binaria que lleva el vídeo.
- Video: un
file_ido una URL HTTP con la vía binaria apagada. - Width, Height y Duration: campos de Additional Fields que describen el clip.
- Thumbnail: una imagen JPEG de menos de 200 kB cuyo ancho y alto no deben pasar de 320.
Unpin a chat message
message.unpinChatMessageLo que ves en n8n
Notas y casos de uso
Quita la fijación de un mensaje cuando ya no tiene sentido que siga arriba.
Parámetros clave
- Chat ID: la conversación que contiene el mensaje fijado.
- Message ID: el identificador único del mensaje que se desfija.
¿Necesitas ayuda para automatizar Telegram con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


