Un bot de Telegram puede responder preguntas, gestionar comandos y conectar un chat con otros servicios. Para crearlo, primero hay que registrarlo con BotFather; para que responda, necesitas configurar un flujo sin código o crear un programa que procese los mensajes.
Esta guía te explica cómo crear un bot de Telegram en 2026: registrar una cuenta, obtener un token, configurar respuestas sin código o con Python y solucionar los errores de configuración más habituales. Empezaremos con BotFather y después veremos las dos formas de crear un bot funcional.
En resumen
Registra el bot desde la cuenta oficial de @BotFather y mantén en privado su token de acceso.
Un flujo sin código sirve para respuestas sencillas; Python te da control sobre la lógica personalizada.
BotFather crea la cuenta, pero para responder hace falta un flujo activo o un programa en ejecución.
Prueba /start, /help y un mensaje de texto en un chat privado antes de poner el bot en marcha.
¿Qué es un bot de Telegram?
Un bot de Telegram es una aplicación con la que los usuarios interactúan a través de una cuenta de Telegram diseñada para automatizar tareas. Puede responder preguntas, gestionar comandos o conectar una conversación con otro servicio, como se explica en la guía de bots de Telegram.
Empieza con una sola tarea. Un bot de ayuda puede mostrar instrucciones para /start y /help. Un bot eco repite los mensajes: envía Hola y recibirás Hola. Con eso basta para comprobar la conexión antes de añadir más lógica.
Un bot no es automáticamente un chatbot con IA. Para enviar una respuesta fija basta con una regla; si quieres respuestas de IA, necesitas integrar un modelo por separado. Una Mini App es una interfaz web que se abre dentro de Telegram, así que crearla es distinto de implementar el bot de texto de esta guía.
Los bots también forman parte del ecosistema publicitario de Telegram: una plataforma de publicidad en Telegram como AdsGram gestiona campañas en canales, bots y Mini Apps.
Cómo crear un bot de Telegram
Crea la cuenta con BotFather y luego elige si quieres configurar su comportamiento con un flujo sin código o con Python. BotFather es el paso de registro en ambas opciones, no una tercera forma de programar la lógica de la conversación.
Opción | Qué configuras | Ideal para empezar | Qué debes mantener |
|---|---|---|---|
BotFather | Cuenta, perfil y token de acceso | Registro obligatorio | Titularidad y configuración de la cuenta |
Sin código | Activadores, condiciones y respuestas | Una conversación breve y predecible | Flujo de trabajo, credenciales y disponibilidad del servicio |
Python | Gestores de eventos y lógica de la aplicación | Reglas o integraciones personalizadas | Código, dependencias y entorno de ejecución |
Antes de elegir una herramienta para crear bots de Telegram, dibuja una conversación sencilla: mensaje recibido → condición → respuesta. Comprueba que la herramienta admita los tipos de mensajes, las ramificaciones y el almacenamiento de datos que necesitas. Si la conversación tiene muchas excepciones, compara cuánto cuesta cambiar las reglas en un editor visual y en el código.
Regístrate con BotFather
Abre la cuenta oficial de @BotFather, envía /newbot y sigue las instrucciones para elegir un nombre visible y un nombre de usuario. Telegram explica el proceso de registro en su tutorial para crear tu primer bot.
- Abre BotFather desde el enlace directo de arriba y pulsa Iniciar.
- Envía
/newbot. - Escribe un nombre visible, por ejemplo,
Workshop Help. - Elige un nombre de usuario disponible que termine en bot, por ejemplo,
workshop_help_demo_bot. - Guarda el token de acceso en un gestor de contraseñas o en un almacén de secretos.
- Abre el enlace del bot para comprobar que puedes acceder al chat.
El nombre de usuario de ejemplo es orientativo; no se garantiza que esté disponible. Usa letras latinas, números y guiones bajos, y sigue los requisitos de nombre de usuario que indica BotFather.
El token de acceso autentica al bot ante la Bot API. Cualquiera que lo consiga podría controlar el bot, así que no lo publiques en capturas de pantalla, repositorios ni documentos compartidos. Si ya tienes un bot, abre las opciones de administración de BotFather para obtener o sustituir su token. Si se filtra, revócalo y actualiza la aplicación conectada con el nuevo token.
Comandos útiles de BotFather
Estos son comandos habituales de configuración, pero no es una lista exhaustiva. Consulta la guía de BotFather de Telegram y el menú actual de BotFather para ver los ajustes disponibles.
Comando | Función |
|---|---|
| Registrar un bot |
| Gestionar tus bots |
| Editar el nombre visible |
| Explicar qué hace el bot |
| Editar la breve descripción del perfil |
| Establecer la imagen del perfil |
| Configurar el menú de comandos |
| Generar un token de autenticación |
Añade solo los comandos que tu aplicación realmente puede gestionar. Que un comando aparezca en el menú no significa que genere una respuesta: /help también necesita una regla de flujo de trabajo o un controlador en el código.
Crea un bot sin programar
Para crear un bot de Telegram sin programar, conecta su token a un flujo de trabajo visual y define cómo responder a los mensajes entrantes. Aquí tienes un ejemplo básico con n8n, una herramienta de automatización de terceros que no pertenece a Telegram.
Empieza con una instancia de n8n que pueda recibir eventos de Telegram. Si la alojas por tu cuenta, también tendrás que configurar un servidor: «sin código» no significa «sin configuración». No des por hecho que un plan alojado o el funcionamiento continuo son gratuitos.
- Crea un flujo de trabajo y añade Telegram Trigger.
- Crea las credenciales de Telegram y pega el token de BotFather en el campo Access Token, siguiendo la documentación de credenciales.
- Selecciona el evento Message en Telegram Trigger.
- Añade una acción de Telegram con el recurso Message y la operación Send Message.
- Establece Chat ID como el ID del chat del mensaje entrante. Si la acción va justo después del trigger, usa la expresión
{{ $json.message.chat.id }}. - Establece Text como
¡Hola! Tu bot está conectado.La documentación de acciones de Telegram describe las operaciones disponibles. - Inicia un listener de prueba y envíale un mensaje privado nuevo al bot.
- Comprueba que responde y publica o activa el flujo de trabajo para usarlo de forma continua.
Así, el bot responde con la misma frase a todos los mensajes. Después, añade una condición para que /start muestre un mensaje de bienvenida y /help envíe instrucciones. Define qué responderá si recibe algo que no reconoce, para que el usuario no se quede esperando.
Si alojas n8n por tu cuenta, Telegram necesita una dirección pública de webhook con HTTPS. Las pruebas y producción pueden sobrescribir el registro del webhook, así que usa un bot de prueba distinto cuando hagas cambios en un flujo de trabajo activo. Consulta la guía de n8n para solucionar problemas con Telegram.
Crea un bot de Telegram con Python
Usa Python si necesitas controlar al detalle las respuestas, la validación y las integraciones. El ejemplo de abajo implementa /start, /help y la repetición de los mensajes de texto, siguiendo el patrón de controladores asíncronos del ejemplo de python-telegram-bot.
Prepara el proyecto
Instala una versión compatible de Python; Python 3.12 es una buena opción para este ejemplo. La documentación de la biblioteca incluye los detalles de compatibilidad. Crea una carpeta y un entorno virtual para mantener separados los paquetes de este proyecto.
En macOS o Linux:
mkdir telegram-bot-demo cd telegram-bot-demopython3 -m venv .venv source .venv/bin/activate python -m pip install "python-telegram-bot==22.8"
En Windows PowerShell, ejecuta py -m venv .venv,
después .\.venv\Scripts\Activate.ps1 y, a continuación, el mismo comando de instalación.
Si una política local impide la activación, ejecuta directamente .\.venv\Scripts\python.exe en lugar de cambiar la política del sistema solo para seguir este tutorial.
Añade el código del bot
Guárdalo como bot.py. El token se obtiene de una variable de entorno, no de una cadena guardada en el control de versiones.
import os
from telegram import Update
from telegram.ext import (
Application, CommandHandler, ContextTypes,
MessageHandler, filters,
)
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message:
await update.message.reply_text("¡Hola! Envía un mensaje de texto o usa /help.")
async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message:
await update.message.reply_text("Repito los mensajes de texto. Prueba a enviar Hola.")
async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
if update.message and update.message.text:
await update.message.reply_text(update.message.text)
def main():
token = os.environ.get("TELEGRAM_BOT_TOKEN")
if not token:
raise SystemExit("Define TELEGRAM_BOT_TOKEN antes de iniciar el bot.")
app = Application.builder().token(token).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("help", help_command))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
app.run_polling(allowed_updates=["message"])
if __name__ == "__main__":
main()
Inicia el bot
Define el secreto en la misma sesión de terminal y ejecuta python bot.py. En macOS o Linux con bash o zsh, así no tendrás que escribir el token directamente en un comando que quede guardado en el historial del shell:
read -s "TELEGRAM_BOT_TOKEN?Pega el token del bot: "zsh export TELEGRAM_BOT_TOKEN python bot.py
En bash, sustituye la primera línea por read -s -p "Pega el token del bot: " TELEGRAM_BOT_TOKEN.
En PowerShell 7, usa $env:TELEGRAM_BOT_TOKEN = Read-Host -MaskInput 'Pega el token del bot' y luego ejecuta python bot.py.
Abre el chat privado y prueba /start, /help y un mensaje de texto corto. Detén el proceso con Ctrl+C. Este código sirve como punto de partida para aprender: no incluye base de datos, estado de conversación persistente ni monitorización para producción.
Mantén el bot en funcionamiento
Ejecuta la aplicación en un servidor que esté siempre encendido o mantén activo el flujo de trabajo sin código en su entorno de alojamiento. Si cierras el proceso local de Python, el bot dejará de responder.
El sondeo largo funciona así: tu programa solicita las novedades a Telegram. Con un webhook, Telegram envía las novedades a tu servidor. La referencia de la Bot API describe estos dos métodos excluyentes para recibir actualizaciones. El ejemplo en Python usa sondeo, mientras que el activador de n8n usa un webhook.
Antes de pasar de una prueba a un servicio compartido:
- Guarda el token en la configuración de secretos de tu servicio de hosting y excluye .venv y los archivos secretos de Git.
- Ejecuta una sola instancia de sondeo por token de bot; evita que otra aplicación consuma las actualizaciones del mismo bot.
- Configura el reinicio automático y revisa los errores sin registrar secretos ni contenido innecesario de los mensajes.
- Guarda el estado de conversación necesario fuera de la memoria del proceso.
- Prueba a reiniciar el servicio y comprueba que el bot vuelva a estar operativo.
Si más adelante el proyecto necesita una interfaz web, planifícala por separado. En la guía de AdsGram sobre errores al desarrollar Telegram Mini Apps encontrarás información relacionada para esa etapa.
Soluciona los errores de configuración más comunes
Si el bot no responde, comprueba que la aplicación esté en marcha y que reciba las actualizaciones antes de cambiar su perfil. Sigue estos pasos para distinguir un problema de la cuenta de uno del flujo de trabajo o del código.
- No responde después del registro: conecta e inicia el flujo de trabajo o el programa; BotFather no lo ejecuta por sí solo.
- Falta una variable de entorno: configura
TELEGRAM_BOT_TOKENen la misma terminal o servicio de hosting desde donde inicias Python. - Error de autenticación: comprueba que no haya espacios, que el token no esté obsoleto y que las credenciales sean del bot correcto.
- Conflicto de sondeo: detén los procesos duplicados. Si vas a cambiar de un servicio con webhook al sondeo, elimina antes el webhook de forma intencionada con
deleteWebhook; consulta las preguntas frecuentes sobre las actualizaciones de Telegram. - Funciona en un chat privado, pero no en un grupo: comprueba el modo de privacidad y prueba a enviar un comando dirigido al bot, como
/help@your_bot_username. - El comando del menú no hace nada: implementa un controlador para ese comando; añadirlo en BotFather solo hace que aparezca.
Preguntas frecuentes
Puedes empezar en tu equipo, sin contratar hosting. Aquí respondemos a las dudas sobre el registro y el funcionamiento continuo.
¿Puedo crear un bot de Telegram gratis?
La plataforma básica de bots de Telegram es gratuita y puedes desarrollar un bot sencillo en Python en tu propio ordenador. El hosting, los servicios sin código y las API externas pueden tener un coste aparte. Para empezar, prueba con un bot local que responda con texto y comprueba cuánto te costará el hosting o el servicio antes de dejarlo funcionando de forma continua.
¿Es seguro BotFather?
Accede a la cuenta oficial desde la documentación de Telegram o mediante el enlace directo a @BotFather de esta guía. BotFather es la herramienta de Telegram para gestionar bots. Los principales riesgos son las cuentas falsas y la exposición de los tokens de acceso. Mantén el token en privado y compártelo solo con la aplicación o el servicio en el que confíes para operar el bot.
¿Cómo consigo un token de bot de Telegram con BotFather?
Envía /newbot a la cuenta oficial de BotFather y sigue las indicaciones para elegir el nombre y el nombre de usuario. Después, BotFather te dará el token del bot. Si ya tienes un bot, puedes generar un token desde las opciones de gestión. Guárdalo de forma segura y actualiza las credenciales de la aplicación si revocas o sustituyes el token anterior.
¿Necesito Python para crear un bot de Telegram?
No. Puedes crear respuestas básicas con un flujo visual, sin Python, y también puedes usar otros lenguajes de programación para interactuar con la Bot API. Elige la opción que mejor se adapte a lo que quieres que haga el bot y a lo que puedas mantener. Para una herramienta visual, basta con un árbol de decisiones sencillo; si necesitas validaciones o integraciones más complejas, quizá te convenga desarrollar tu propia aplicación.
¿Por qué mi bot deja de funcionar cuando cierro la terminal?
En este ejemplo, la terminal ejecuta el proceso que recibe los mensajes y envía las respuestas. Cuando el proceso se detiene, esa lógica deja de funcionar, aunque la cuenta del bot sigue existiendo. Para mantenerlo activo, despliega el programa en un entorno que esté siempre encendido y pueda reiniciarlo si falla, o deja activo un flujo de trabajo alojado y revisa los registros de ejecución si el bot deja de responder.
