¿Cómo configurar un bot en Telegram para enviar recordatorios automáticos?

Introducción

En el mundo acelerado de hoy, olvidar tareas o reuniones es común. Telegram, más allá de ser una aplicación de mensajería, ofrece una plataforma potente para automatizar recordatorios mediante bots. Configurar un bot de Telegram para enviar recordatorios automáticos puede transformar tu productividad personal o de equipo, permitiéndote recibir alertas oportunas sin depender de aplicaciones externas. En este artículo, te guiaremos paso a paso desde la creación del bot con BotFather hasta la implementación de un sistema de recordatorios funcional, usando ejemplos prácticos y consideraciones de despliegue. Cubriremos tanto los fundamentos como las mejores prácticas para que puedas adaptar la solución a tus necesidades.

¿Qué es un bot de Telegram y cómo funciona?

Un bot de Telegram es una cuenta automatizada controlada por un programa, no por una persona. Interactúa con los usuarios mediante comandos, mensajes de texto o incluso botones inline. Los bots se comunican con el servidor de Telegram a través de la API de Bots, que es una interfaz HTTP basada en JSON. Cuando un usuario envía un mensaje a un bot, Telegram envía una actualización a un servidor que el bot ha configurado (webhook) o el bot puede consultar periódicamente (polling). El bot procesa la actualización y responde según la lógica programada.

Para los recordatorios automáticos, el bot necesita una capacidad de programación de tareas: ejecutar una acción (enviar un mensaje) en un momento específico o en intervalos. Esto se logra combinando la API de Telegram con un scheduler en el lenguaje de programación que elijas, típicamente Python, Node.js o PHP. En este artículo usaremos Python por su simplicidad y amplia comunidad.

Requisitos previos

Antes de comenzar, asegúrate de tener:

Una cuenta de Telegram activa.
Acceso a un ordenador o servidor (puede ser local para pruebas, luego desplegar en la nube).
Conocimientos básicos de programación (Python en este ejemplo).
Python 3.7+ instalado en tu sistema.
Un editor de código (VS Code, PyCharm, etc.).
Conexión a internet para instalar librerías y probar el bot.

Si no tienes Python, descárgalo desde python.org e instálalo. Asegúrate de marcar la opción 'Add Python to PATH' durante la instalación.

Creación del bot con BotFather

El primer paso es crear un bot oficial en Telegram usando BotFather, el bot oficial que gestiona todos los bots. Sigue estos pasos:

Abre Telegram y busca @BotFather. Inicia una conversación y presiona /start.
Envía el comando /newbot. BotFather te pedirá un nombre para tu bot (visible para los usuarios) y un nombre de usuario (debe terminar en 'bot', ej. MiRecordatorioBot).
Una vez creado, recibirás un mensaje con el token de acceso. Este token es una cadena alfanumérica única que identifica a tu bot. Guárdalo de forma segura; cualquiera que tenga el token puede controlar tu bot.
Opcionalmente, puedes configurar la descripción, foto de perfil y comandos del bot usando otros comandos de BotFather (como /setdescription).

Advertencia: Nunca compartas tu token públicamente (por ejemplo, en repositorios de GitHub). Si crees que se ha comprometido, usa el comando /revoke en BotFather para revocarlo y genera uno nuevo.

Configuración del entorno de desarrollo

Una vez que tienes el token, configura tu entorno de Python. Crea una carpeta para el proyecto, abre una terminal y navega a ella. Luego, crea un entorno virtual (opcional pero recomendado):

python -m venv venv
source venv/bin/activate  # En Windows: venv\Scripts\activate

Instala la librería python-telegram-bot, que es un wrapper de la API de Telegram para Python. También necesitaremos schedule para la programación de tareas y python-dotenv para manejar variables de entorno (opcional).

pip install python-telegram-bot schedule python-dotenv

Si prefieres no usar schedule, puedes usar la biblioteca estándar threading.Timer, pero schedule ofrece una sintaxis más limpia para tareas recurrentes.

Escribiendo el código del bot

Crea un archivo bot.py y escribe la estructura básica. Primero, importamos las librerías y configuramos el token. Es buena práctica guardar el token en una variable de entorno o en un archivo .env.

import os
from dotenv import load_dotenv
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes

load_dotenv()
TOKEN = os.getenv('TELEGRAM_TOKEN')

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text('¡Hola! Soy tu bot de recordatorios. Usa /recordatorio para programar uno.')

def main():
    app = Application.builder().token(TOKEN).build()
    app.add_handler(CommandHandler('start', start))
    app.run_polling()

if __name__ == '__main__':
    main()

Este código crea un bot que responde al comando /start. Para probarlo, ejecuta python bot.py y envía /start a tu bot en Telegram. Asegúrate de que el bot esté en ejecución.

Implementación de recordatorios automáticos

Ahora agregaremos la funcionalidad de recordatorios. La idea es que el usuario pueda programar un recordatorio con un mensaje y una hora, y el bot le enviará el mensaje en el momento indicado. Existen varias estrategias:

En hilo (threading.Timer): Para recordatorios únicos no persistentes. Se pierden si el bot se reinicia.
Con librería schedule: Para tareas recurrentes (cada día a las 9 AM). También en memoria.
Con base de datos y cron: Para persistencia, usando SQLite y un script separado ejecutado por cron o un scheduler externo.

Para este ejemplo, usaremos una combinación: almacenaremos los recordatorios en un diccionario en memoria (para simplicidad) y usaremos asyncio para programar el envío. En un entorno de producción, deberías usar una base de datos y un scheduler externo como APScheduler o Celery.

Comando /recordatorio

Implementaremos un comando que reciba el mensaje y el tiempo en formato natural (ej.