Este es un bot de Telegram programado en Python que funciona como un asistente personal para tu agenda. Te permite almacenar tus contactos, programar horarios específicos para volver a llamarlos y recibir un recordatorio automático directo en tu chat de Telegram cuando llega el momento.
- Agenda de Contactos: Guarda nombres y números telefónicos.
- Programación de Rellamadas: Elige la fecha y hora exacta para volver a comunicarte.
- Alertas en Tiempo Real: Mensajes automáticos de recordatorio vía Telegram.
- Clona el repositorio o descarga los archivos en tu computadora.
- Abre la terminal en la carpeta del proyecto e instala las dependencias necesarias con:
bash
pip install python-telegram-bot requests
Usa el código con precaución.
Para que el bot pueda enviarte mensajes, debes configurar tus credenciales:
- Duplica el archivo de ejemplo para crear tu configuración personal:
- Windows: copy config.example.json config.json
- Linux/Mac: cp config.example.json config.json
- Abre el nuevo archivo config.json con un editor de texto.
- Coloca tu token de Telegram (generado con BotFather) y tu ID de chat.
Nota: El archivo config.json está protegido en el .gitignore para que tus contraseñas nunca se suban de forma pública.
Para iniciar el gestor de contactos, ejecuta en tu terminal:
bash
python gestor_contactos.py
Usa el código con precaución.
Para que los recordatorios de rellamada y las alertas automáticas lleguen correctamente a tu chat de Telegram, debes tener en cuenta lo siguiente:
- Computadora encendida: El equipo donde está instalado el proyecto debe permanecer prendido.
- Programa activo: El script gestor_contactos.py tiene que estar ejecutándose en la terminal de forma continua.
Nota: Si apagas la computadora o cierras la terminal, el sistema no podrá procesar los horarios programados ni enviar los mensajes hasta que lo vuelvas a iniciar.
En Linux se usa un archivo .sh:
Abrís la terminal en la carpeta donde está tu script y escribís:
bash nano gestor_contactos.sh
Pegás esto (reemplazando la ruta):
bash #!/bin/bash python3 /ruta/completa/gestor_contactos.py
Guardás con Ctrl+O → Enter → Ctrl+X
Luego le das permisos de ejecución:
bash chmod +x gestor_contactos.sh
Para el ícono en el escritorio creás un archivo .desktop:
bash nano ~/Escritorio/gestor_contactos.desktop
Pegás esto:
ini [Desktop Entry] Name=Gestor de Contactos Exec=python3 /ruta/completa/gestor_contactos.py Icon=address-book Terminal=false Type=Application
Guardás, y después:
bash chmod +x ~/Escritorio/gestor_contactos.desktop
Click derecho sobre el ícono en el escritorio → Permitir ejecutar y listo, doble click abre el gestor directo.
Si tu escritorio está en inglés cambiá Escritorio por Desktop en las rutas.