Clase 02 · Módulo 10
Telegram: comandos, botones, archivos y grupos
Telegram: comandos, botones, archivos y grupos
Qué logras en esta clase
Conviertes el bot que saluda en uno que ofrece opciones, maneja archivos y trabaja en un grupo sin ser bloqueado.
- Enrutas comandos y clics de botones.
- Recibes y envías archivos dentro de los límites.
- Configuras el bot en un grupo y espacias los envíos.
02
Menos texto libre, menos errores
Cada botón que ofreces es una respuesta que no tienes que interpretar. Parte por botones y deja el texto libre para lo que de verdad lo necesita.
03
Qué es un comando
Un comando es un mensaje que parte con una barra: /start, /horario, /ayuda. Para tu flujo es texto normal que llega en message.text.
/startes lo que envía Telegram cuando alguien abre el bot por primera vez.- Los demás los inventas tú.
- Conviene que sean pocos, cortos y en minúsculas.
04
Enrutar comandos con Switch
Switch se vio en el módulo 4, clase 1. Deja siempre una salida para «cualquier otra cosa»: la gente escribe lo que quiere.
05
Mostrar el menú de comandos
Telegram puede mostrar tus comandos en un menú junto al cuadro de texto. Esa lista no se configura en n8n: se registra en @BotFather, eligiendo tu bot y cargando cada comando con su descripción.
06
Dos tipos de botones
| Tipo | Dónde aparece | Qué pasa al tocarlo |
|---|---|---|
| Teclado en línea | Pegado al mensaje del bot | Tu flujo recibe un aviso con un dato oculto |
| Teclado de respuesta | Reemplaza el teclado del teléfono | Se envía un mensaje de texto normal |
Para menús y confirmaciones conviene el teclado en línea: el chat queda limpio y el dato llega exacto.
07
Agregar botones al mensaje
- En el nodo Telegram, operación de enviar mensaje.
- Busca la opción de marcado de respuesta y elige el teclado en línea.
- Agrega cada botón con dos datos: el texto visible y el dato que viaja al tocarlo.
Los nombres exactos de esas opciones están en la página «Message operations» del nodo: ábrela junto al editor la primera vez.
08
Un clic no es un mensaje
Al tocar un botón en línea, Telegram no envía un mensaje: envía una consulta de retorno (callback_query) con el dato del botón.
09
Recibir el clic en n8n
- El disparador debe estar suscrito a ese tipo de aviso, además de los mensajes.
- El dato del botón llega en
callback_query.data. - El chat ya no viene en
message.chat.idsino dentro decallback_query.
10
El recorrido completo de un botón
Confirmar el clic quita el indicador de carga del botón. El nodo tiene operaciones de «callback» para eso.
11
Recibir un archivo
El mensaje no trae el archivo: trae su identificador. Con él, el nodo lo descarga y queda como dato binario (módulo 3, clase 6), listo para subir a Drive o leer con IA.
12
Enviar un archivo
- Ten el archivo como dato binario en el flujo: descargado, generado o leído de Drive.
- En el nodo Telegram, elige la operación según el tipo: documento, foto, audio.
- Indica el chat y la propiedad binaria que contiene el archivo.
13
Límites de archivos
| Dirección | Tamaño máximo |
|---|---|
| El bot descarga lo que le envían | 20 MB |
| El bot envía | 50 MB |
Un video largo grabado con el teléfono supera fácil los 20 MB. Si tu proceso depende de archivos grandes, pide un enlace de Drive en vez del archivo.
14
El bot en un grupo
- Agrega el bot al grupo como a cualquier integrante.
- Escribe algo en el grupo dirigido al bot y mira la ejecución.
- Anota el identificador de chat del grupo: es distinto del tuyo.
- Usa ese identificador en los nodos que envían avisos.
Un grupo de avisos internos es el uso más rentable de un bot en un negocio chico.
15
Modo privacidad: qué ve el bot
| Modo privacidad | El bot recibe |
|---|---|
| Activado | Comandos dirigidos a él, respuestas a sus mensajes y mensajes de servicio |
| Desactivado, o bot administrador | Todos los mensajes del grupo, salvo los de otros bots |
Se cambia en @BotFather. Déjalo activado salvo que el bot necesite leer todo.
16
Leer todo tiene costo
Un bot que recibe cada mensaje de un grupo activo dispara una ejecución por mensaje. Y guarda conversaciones de personas que quizá no saben que las lee.
17
Límites de envío
| Caso | Límite aproximado |
|---|---|
| Mismo chat | 1 mensaje por segundo |
| Un grupo | 20 mensajes por minuto |
| Avisos a muchos chats | 30 mensajes por segundo en total |
Pasarse devuelve error 429. Existe una difusión pagada de mayor volumen con requisitos muy altos: no es para un negocio chico.
18
Espaciar envíos a muchas personas
Es el mismo patrón del módulo 4, clase 3. Activa además el reintento del nodo para que un 429 ocasional no corte el envío.
19
Cuándo usar cada recurso
| Necesidad | Recurso |
|---|---|
| Acción fija y conocida | Comando |
| Elegir entre pocas opciones | Botones en línea |
| Dato abierto: nombre, dirección | Texto libre |
| Comprobante, foto, documento | Archivo |
| Avisar a un equipo | Grupo |
20
Dos errores comunes
El segundo: probar los límites con el bot real. Si Telegram lo frena, tus avisos importantes también se detienen. Usa el bot de pruebas.
21
Lo que te llevas
- Un comando es texto que parte con barra; lo enruta un Switch.
- El clic de un botón en línea llega como aviso aparte, con su dato.
- Los archivos viajan por identificador: 20 MB para recibir, 50 MB para enviar.
- En grupos, el modo privacidad decide qué ve el bot.
- Los envíos masivos se espacian con lotes y esperas.
22
Hazlo ahora
En 15 minutos, con tu bot de pruebas:
- Haz que
/startresponda con dos botones en línea: «Horario» y «Ubicación». - Suscribe el disparador a los clics y enruta cada dato a un mensaje distinto.
- Envíale una foto al bot y haz que te la devuelva como documento.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Bots FAQ: límites, archivos y modo privacidad (Telegram)core.telegram.org ↗
- Bots: An introduction for developers (Telegram)core.telegram.org ↗
- Telegram: message operations (documentación de n8n)docs.n8n.io ↗
- Telegram: callback operations (documentación de n8n)docs.n8n.io ↗
- Telegram Trigger (documentación de n8n)docs.n8n.io ↗