📦 Correos Tracking Bot

Bot de Telegram para el seguimiento automático de envíos de Correos España con notificaciones en tiempo real.

✨ Características

• 🔄 Seguimiento automático: Monitorización continua de tus envíos
• 📱 Notificaciones instantáneas: Recibe alertas cuando hay actualizaciones
• 🎯 Comandos intuitivos: Interfaz fácil de usar mediante comandos de Telegram
• 📊 Historial detallado: Consulta el historial completo de cada envío
• 🔔 Gestión automática: Sugerencia de eliminación cuando el envío está entregado
• 💾 Persistencia de datos: Los seguimientos se mantienen entre reinicios
• 🔐 Configuración segura: Credenciales separadas del código principal

📁 Estructura del Proyecto

proyecto/
├── config.py           # Configuración y constantes
├── correos_tracker.py  # Código principal
├── .gitignore         # Archivos a ignorar en git
├── tracking_data.pkl  # Se creará automáticamente
└── __pycache__/      # Creado por Python

La estructura del proyecto es simple y modular:

• config.py: Almacena todas las configuraciones y credenciales
• correos_tracker.py: Contiene la lógica principal del bot
• .gitignore: Especifica qué archivos no deben incluirse en el control de versiones
• tracking_data.pkl: Archivo de datos generado automáticamente para persistencia
• __pycache__/: Directorio de cache de Python (generado automáticamente)

🚀 Instalación

1. Clona el repositorio:

git clone https://github.com/yourusername/correos-track-bot.git
cd correos-track-bot

2. Instala las dependencias:

pip install requests

3. Crea un archivo config.py con tus credenciales:

TELEGRAM_BOT_TOKEN = "TU_BOT_TOKEN"
TELEGRAM_CHAT_ID = "TU_CHAT_ID"
CHECK_INTERVAL = 300
COMMAND_CHECK_INTERVAL = 1
CORREOS_API_URL = "https://api1.correos.es/digital-services/searchengines/api/v1/"

🔧 Configuración

Crear un bot de Telegram:

1. Habla con @BotFather en Telegram
2. Usa el comando /newbot y sigue las instrucciones
3. Guarda el token que te proporciona

Obtener el Chat ID:

1. Inicia un chat con tu bot
2. Envía cualquier mensaje
3. Visita: https://api.telegram.org/bot<TU_TOKEN>/getUpdates
4. Busca el número chat_id en la respuesta

💻 Uso

Iniciar el bot:

python correos_tracker.py

Comandos disponibles:

• /add NUMERO - Añade un envío al seguimiento
• /status NUMERO - Muestra el estado actual de un envío
• /list - Lista todos los envíos en seguimiento
• /remove NUMERO - Elimina un envío del seguimiento
• /help - Muestra la ayuda

📸 Capturas de pantalla

🛠️ Tecnologías utilizadas

• Python - Lenguaje de programación
• Telegram Bot API - API para bots de Telegram
• Correos API - API de seguimiento de Correos
• Requests - Cliente HTTP para Python

🚀 Mejoras Futuras

• Añadir soporte para varios idiomas en las notificaciones
• Incluir autenticación de usuarios en Telegram
• Ampliar la funcionalidad con nuevas APIs de seguimiento
• Optimizar la frecuencia de chequeo para reducir el consumo de recursos
• Mejorar el manejo de errores para conexiones inestables
• Añadir pruebas unitarias para cada componente
• Crear un sistema de alertas basado en tiempo estimado de entrega

📝 Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor, abre primero un issue para discutir los cambios que te gustaría realizar.

1. Haz un Fork del proyecto
2. Crea tu rama de características (git checkout -b feature/AmazingFeature)
3. Haz commit de tus cambios (git commit -m 'Add some AmazingFeature')
4. Haz Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

⭐ Muestra tu apoyo

Si este proyecto te ha resultado útil, considera darle una estrella ⭐️

📧 Contacto

Project Link: https://github.com/vgvr0/correos-tracking-bot