Cómo crear un bot de Telegram con Claude Code o Codex (guía para principiantes)

¿Nunca has programado un bot, pero quieres automatizar mensajes en Telegram? Claude Code, Codex u otros asistentes de programación con IA pueden hacer la mayor parte del trabajo técnico por ti, siempre que los guíes bien. En unos pocos pasos, pasamos de una idea a un bot que funciona de verdad. Aquí te explicamos cómo hacerlo.

1. Crea tu bot en Telegram

Abre Telegram y habla con @BotFather, el bot oficial que crea bots. Escribe /newbot, elige un nombre y un identificador (que debe terminar en «bot»). BotFather te da un token : una larga cadena de caracteres que sirve como clave secreta para controlar tu bot. Guárdalo bien, nunca lo compartas públicamente — y si alguna vez se filtra (por ejemplo, si lo publicas por error en GitHub), vuelve a ver a BotFather para revocarlo y generar uno nuevo.

2. Abre tu asistente de IA en una carpeta de proyecto

Crea una carpeta vacía en tu ordenador y luego lanza el asistente en un terminal en esa ubicación. Siempre trabaja en la carpeta actual: ahí es donde va a leer y escribir tus archivos.

3. Dale un prompt de inicio preciso

No hace falta vocabulario técnico, pero cuanto más precisa sea tu petición, mejor será el resultado. Aquí tienes un prompt que puedes copiar y pegar tal cual (sustituyendo los valores entre corchetes):

Crea un bot de Telegram en Python con la librería python-telegram-bot.
El bot debe enviar cada mañana el tiempo de [CIUDAD] a [HORA].

Restricciones:
- Guarda el token de Telegram en un archivo .env, nunca escrito directamente en el código.
- Crea un archivo .gitignore que excluya .env.
- No inventes ningún valor secreto (token, clave API): indícame claramente
  dónde y cómo introducirlos yo mismo.
- Explícame cada paso antes de ejecutarlo.
- Prueba el bot antes de dar el proyecto por terminado.

Para un mensaje enviado cada día sin que tengas que escribirle al bot, también hay que conocer tu chat ID (identificador de tu conversación con el bot). Pídele simplemente a la IA que te explique cómo obtenerlo — normalmente enviando un primer mensaje al bot y luego leyendo la respuesta de la API de Telegram.

4. Protege el token desde el principio

La IA debe crear un archivo .env para guardar el token.

5. Deja que la IA ejecute los comandos, con prudencia

La IA puede lanzar ella misma los comandos de instalación (pip install, npm install, etc.) y arrancar el bot para probarlo. Te pedirá tu autorización antes de cada acción importante. Es normal, es una medida de seguridad. Cuando alguien que empieza no tiene las referencias para juzgar «lo que es lógico», basta con una regla simple: si un comando te pide tu contraseña, modifica archivos que no reconoces o instala un programa del que nunca has oído hablar, pídele primero a la IA que te explique qué va a hacer y por qué, antes de aceptar.

6. Prueba tu bot

Una vez bot lanzado, abre Telegram y envíale un mensaje. Si no responde como esperabas, descríbele el problema a la IA («el bot no responde a /start» o «tengo un error XYZ»): leerá los mensajes de error y corregirá el código.

7. Añade funcionalidades poco a poco

Una vez que la base funcione, enriquécelo bot progresivamente: respuestas automáticas, recordatorios programados, integración con una API externa… Pide una funcionalidad a la vez, pruébala y luego pasa a la siguiente. Si tu bot debe memorizar usuarios, sus preferencias o recordatorios, pide a la IA que prevea un almacenamiento persistente: un simple archivo local puede ser suficiente para un prototipo, pero no siempre sobrevivirá a un reinicio en un alojamiento, entonces se vuelve necesaria una pequeña base de datos.

8. Aloja tu bot de forma continua

Para que el bot funcione incluso cuando tu ordenador está apagado, hay que alojarlo en un servidor. Pide a la IA que te explique las opciones actuales (pequeño servidor en la nube, plataformas como Railway o Fly.io, funciones serverless como Cloudflare Workers) y que prepare el despliegue. Verifica siempre las condiciones y tarifas vigentes en el momento en que leas esto: las ofertas gratuitas de estas plataformas cambian con regularidad.

9. Soluciona problemas y mantén tu bot

Un bot que funciona hoy puede dejar de funcionar mañana: dependencia actualizada, proveedor de alojamiento que cambia sus reglas, token caducado… Guarda un registro de lo que la IA ha implementado (pídele que documente claude.md) para poder darle el contexto fácilmente. En caso de fallo, simplemente copia y pega el mensaje de error a la IA: a menudo es suficiente para que identifique y corrija el problema.

Responder, programar o difundir: tres lógicas diferentes

Un bot de Telegram puede hacer tres cosas bien distintas: responder a un mensaje recibido, enviar un mensaje programado a una hora fija, o difundir una notificación a varios usuarios. Este último caso es más exigente: hay que gestionar la lista de personas que han iniciado una conversación con el bot, sus preferencias y respetar los límites de envío impuestos por Telegram. Un bot no puede escribir espontáneamente a cualquier cuenta de Telegram; cada usuario debe haber iniciado primero la conversación.

Lo que es gratis, lo que es de pago

Crear un bot con BotFather es gratuita, y la API de Bot de Telegram generalmente no se factura por llamada, pero Telegram impone límites de velocidad, y algunas funcionalidades pueden tener sus propias condiciones. En cuanto al asistente de IA, el uso depende de tu plan: una suscripción tipo Claude Pro o Max o ChatGPT Pro incluye un uso de la herramienta.

En cuanto al alojamiento, varias plataformas (Cloudflare Workers, Railway, Fly.io…) suelen ofrecer un nivel gratuito adecuado para un pequeño bot personal de bajo tráfico. Pero estas ofertas cambian con regularidad y varían según el uso real de tu bot : verifica siempre las condiciones actuales antes de comprometerte. En resumen: es totalmente posible poner en marcha un primer bot de Telegram sin gastar ni un céntimo.

Algunas ideas de bots de Telegram

Seguimiento de precios y compras

• Alerta de bajada de precio: vigila un producto y avisa en cuanto baja de un umbral fijado.
• Comparador de precios de combustible: avisa cuando una gasolinera cercana baja de cierto precio por litro.
• Seguimiento de disponibilidad: avisa en cuanto un artículo agotado vuelve a estar disponible.

Finanzas & mercados

• Cotización bursátil / cripto: envía el precio del Bitcoin, de una acción o de un ETF, o avisa en caso de variación fuerte.
• Seguimiento de cartera: calcula cada día el valor total de tus inversiones.
• Tipo de cambio: avisa cuando un par de divisas alcanza un umbral interesante.

Meteo & medio ambiente

• Meteo diaria de tu ciudad, enviada cada mañana.
• Alerta meteorológica en caso de tormenta, lluvia fuerte o helada prevista.
• Calidad del aire / polen.

Productividad & vida personal

• Bot personal de tareas: añade, elimina y recuerda tareas directamente en Telegram.
• Bot de vigilancia RSS: vigila varios sitios y solo envía los artículos nuevos.
• Bot de resumen: envía un artículo o un texto al bot y recibe un resumen.
• Bot de notificaciones para tu propia web: nuevo pedido, nuevo formulario, error del servidor.
• Bot de seguimiento domótico: avisa cuando un dispositivo o un sensor cambia de estado.
• Bot de diario personal: guarda notas rápidamente y recupéralas por búsqueda.
• Seguimiento de paquetes: centraliza el estado de tus envíos en un solo bot.

Para recordar

No necesitas saber programar para crear un bot de Telegram funcional. El papel de la IA es traducir tus ideas a código, ejecutar los comandos técnicos y corregir los errores. Tu papel es describir claramente lo que debe hacer el bot, proteger tus accesos, hacer preguntas, pedirle a la IA si tiene dudas y probar el resultado. Es un verdadero trabajo en equipo entre tu visión y la ejecución técnica de la IA.