Sobre el proyecto

## Descripción general Web Visitor Analytics for Telegram es un módulo de monitoreo del lado del servidor escrito en Python, diseñado para integrarse en aplicaciones web basadas en Python (Flask, Django o cualquier backend Python). Proporciona alertas de visitantes en tiempo real a través de la API de Telegram Bot, enriqueciendo cada notificación con datos de geolocalización e ISP obtenidos del servicio IP-API. No es una aplicación independiente: el fragmento proporcionado debe pegarse en el archivo principal de la aplicación (por ejemplo, `app.py`) para que se ejecute junto con los manejadores de rutas existentes. ## Características - **Notificaciones de Telegram en tiempo real:** Las alertas instantáneas se envían cada vez que se accede a una página, entregando resúmenes estructurados de visitas directamente a un usuario o chat de Telegram designado. - **Datos de geolocalización:** Resuelve automáticamente la ciudad, país e ISP del visitante consultando IP-API mediante la dirección IP de origen de la solicitud. - **Integración no bloqueante:** El módulo incluye manejo de errores para que los fallos en la API de seguimiento o en la entrega por Telegram no interrumpan el flujo principal de la aplicación. - **Visualización respetuosa con la privacidad:** Las direcciones IP completas aparecen parcialmente enmascaradas en las notificaciones para reducir la exposición, manteniendo una identificación útil. ## Requisitos - Python - La librería `requests` (`pip install requests`) - Un token de Bot de Telegram obtenido de @BotFather - Tu ID de chat de Telegram personal, obtenible desde @userinfobot ## Instalación y configuración 1. Crea un bot a través de @BotFather en Telegram y guarda el token de la API. 2. Obtén tu ID de chat desde @userinfobot. 3. Pega el fragmento de integración en el punto de entrada principal de tu proyecto (por ejemplo, `app.py`). 4. Reemplaza los valores de marcador de posición del token y del ID de chat con los tuyos — idealmente mediante variables de entorno en lugar de codificarlos directamente. ``` pip install requests ``` ## Notas de compatibilidad Este módulo está escrito puramente en Python. Funciona con Flask y Django de forma nativa y puede adaptarse a cualquier backend Python. No funcionará en sitios HTML estáticos o entornos sin Python sin adaptar la lógica a esos lenguajes. ## Avisos importantes - **Precisión de la geolocalización:** Las ubicaciones se determinan por el enrutamiento de red del ISP del visitante, no por coordenadas GPS. Un usuario puede aparecer en una ciudad diferente a su ubicación física dependiendo de cómo su proveedor enruta el tráfico. - **Privacidad y cumplimiento legal:** La herramienta recopila y transmite datos derivados de la IP. Los usuarios son responsables de cumplir con las regulaciones de privacidad aplicables, como GDPR o CCPA. Usar de manera ética y responsable. - **Seguridad:** Nunca codifiques tokens de bots o IDs de chat en repositorios públicos. Utiliza variables de entorno o un gestor de secretos. ## Caso de uso El autor utiliza este módulo en un sitio web de portafolio privado en producción para monitorear el tráfico de visitantes en vivo y recibir información de seguridad inmediata en su dispositivo de Telegram. Una notificación de ejemplo muestra la IP enmascarada, el nombre del ISP, la ciudad y el país en un mensaje compacto y formateado.