Clase 01 · Módulo 10
Bot de Telegram desde cero
Bot de Telegram desde cero
Qué logras en esta clase
Dejas un bot de Telegram propio que recibe un mensaje y lo contesta desde un flujo de n8n.
- Creas el bot y obtienes su token.
- Guardas el token como credencial.
- Recibes mensajes con un disparador y respondes al chat correcto.
02
Qué es un bot
Un bot de Telegram es una cuenta que no maneja una persona, sino un programa. Aquí el programa es tu flujo de n8n.
03
Por qué partir por Telegram
- Enviar mensajes con el bot no tiene costo.
- Se crea en minutos, sin trámites de empresa.
- Sirve muy bien para avisos internos: alertas, reportes, aprobaciones.
- Lo malo: muchos clientes no usan Telegram. Para atender público masivo en Chile suele hacer falta WhatsApp (clases 4 a 6).
Lo que aprendas aquí se repite casi igual en WhatsApp, con más reglas.
04
Cómo viaja un mensaje
Telegram queda siempre al medio. Tu flujo nunca habla directo con el teléfono de la persona.
05
Las cuatro piezas
| Pieza | Qué es |
|---|---|
| @BotFather | El bot oficial de Telegram donde se registran y configuran los bots |
| Token | La clave que identifica a tu bot ante Telegram |
| Identificador de chat | El número que dice a qué conversación responder |
| Webhook | La dirección de tu n8n a la que Telegram avisa cada mensaje |
06
Crear el bot con @BotFather
- En Telegram, busca @BotFather y revisa que sea la cuenta verificada.
- Inicia la conversación: te muestra la lista de comandos disponibles.
- Usa el comando para crear un bot nuevo y responde lo que pide: un nombre visible y un nombre de usuario.
- Copia el token que te entrega.
07
El token es el bot
Quien tenga el token controla el bot por completo. Se guarda como una contraseña: nunca en una planilla ni en un chat.
08
Guardar el token en n8n
- En n8n, crea una credencial nueva y busca el tipo Telegram.
- Pega el token en el campo que lo pide.
- Guarda y revisa el resultado de la prueba de conexión que muestra n8n.
El token queda cifrado con la clave de tu instancia (módulo 2, clase 6). Los nodos lo usan sin mostrarlo.
09
Dos formas de recibir mensajes
| Forma | Cómo funciona | Quién la usa |
|---|---|---|
Consulta periódica (getUpdates) | Tu programa pregunta cada cierto rato si hay mensajes | Scripts simples |
| Webhook | Telegram llama a tu dirección apenas llega un mensaje | El disparador de n8n |
Son excluyentes: con un webhook configurado, la consulta periódica deja de funcionar.
10
Qué exige Telegram a tu dirección
- Debe ser HTTPS con un certificado válido.
- Solo acepta los puertos 443, 80, 88 y 8443.
- No sigue redirecciones.
Por eso http://localhost:5678 no sirve: Telegram no puede llegar a tu computador. Necesitas una dirección pública.
11
De dónde sacas la dirección pública
| Opción | Dirección | Conviene para |
|---|---|---|
| Túnel rápido de Cloudflare | Aleatoria, cambia en cada arranque | Aprender y probar |
| Túnel con nombre y dominio | Fija | Bot estable desde tu computador |
| Servidor o n8n Cloud | Fija | Bot que atiende 24/7 |
El túnel rápido se vio en el módulo 5, clase 6. Las otras dos, en el módulo 14.
12
Que n8n conozca su dirección
n8n registra el webhook con la dirección que cree tener. Detrás de un túnel debes decírsela con la variable de entorno N8N_WEBHOOK_URL (módulo 5, clase 6). En guías antiguas aparece como WEBHOOK_URL.
N8N_WEBHOOK_URL=https://tu-direccion-publica/13
Armar el disparador
- Crea un flujo y agrega el nodo Telegram Trigger.
- Elige la credencial que guardaste.
- Selecciona qué tipo de aviso quieres recibir: para partir, los mensajes.
- Ejecuta el flujo en modo de prueba y escríbele al bot desde tu teléfono.
Si todo está bien, el mensaje aparece en el panel de salida del nodo.
14
Qué trae el mensaje
Telegram envía un JSON. Los campos que más vas a usar:
{
"message": {
"text": "Hola, ¿atienden hoy?",
"chat": { "id": 123456789 },
"from": { "first_name": "Camila" }
}
}chat.id es el dato clave: sin él no sabes a quién responder.
15
Responder al mismo chat
- Agrega un nodo Telegram después del disparador.
- Elige la operación para enviar un mensaje de texto.
- En el identificador de chat, arrastra
chat.iddesde el panel de entrada. - Escribe el texto. Puedes mezclarlo con datos del mensaje.
Hola {{ $json.message.from.first_name }}, recibimos tu mensaje.16
El bot no puede hablar primero
Un bot no inicia conversaciones. La persona tiene que escribirle antes o agregarlo a un grupo.
17
Qué implica eso en la práctica
- Para avisarte a ti mismo, primero escríbele al bot una vez.
- Tu identificador de chat lo ves en esa primera ejecución: anótalo.
- Para avisar a un equipo, agrega el bot al grupo.
- No sirve para contactar en frío a personas que no lo conocen.
18
Probar y publicar
En prueba, el flujo escucha un solo mensaje y los datos se ven en el editor. Publicado, responde siempre y cada corrida queda en la pestaña Executions.
19
Un bot, una dirección
Telegram guarda una sola dirección de webhook por bot. Si pruebas en el editor un flujo que ya está publicado, la prueba reemplaza la dirección de producción.
20
Si el bot no responde
| Síntoma | Revisa |
|---|---|
| El disparador no recibe nada | Dirección pública y N8N_WEBHOOK_URL |
| Funcionaba ayer y hoy no | El túnel rápido cambió de dirección |
| Recibe pero no contesta | El identificador de chat del nodo de envío |
| Error de credencial | El token se pegó incompleto o fue cambiado |
21
Dos errores comunes
El segundo: pegar el token directo en un nodo HTTP Request o en un nodo Code. Queda visible para cualquiera que abra o exporte el flujo.
22
Lo que te llevas
- Un bot se registra en @BotFather y se controla con su token.
- El token vive en una credencial de n8n, en ningún otro lado.
- El disparador usa webhook: exige dirección HTTPS pública.
- Se responde usando el
chat.iddel mensaje recibido. - El bot no puede escribirle a quien nunca le escribió.
23
Hazlo ahora
En 15 minutos:
- Crea un bot de pruebas en @BotFather.
- Guarda su token como credencial.
- Abre un túnel rápido y arranca n8n con
N8N_WEBHOOK_URL. - Arma disparador más nodo de envío y haz que el bot te salude por tu nombre.
- Publica y revisa la corrida en Executions.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Bots: An introduction for developers (Telegram)core.telegram.org ↗
- Bots FAQ (Telegram)core.telegram.org ↗
- Telegram Trigger (documentación de n8n)docs.n8n.io ↗
- Telegram: message operations (documentación de n8n)docs.n8n.io ↗
- Quick Tunnels (Cloudflare)developers.cloudflare.com ↗
- n8n 2.0 breaking changesdocs.n8n.io ↗
- n8n Docs — Variables de entorno de endpoints (N8N_WEBHOOK_URL)docs.n8n.io ↗