À propos du projet

## Vue d'ensemble Web Visitor Analytics for Telegram est un module de surveillance côté serveur écrit en Python, conçu pour s'intégrer aux applications web basées sur Python (Flask, Django ou tout autre backend Python). Il fournit des alertes visiteurs en temps réel via l'API Telegram Bot, enrichissant chaque notification de données de géolocalisation et d'ISP issues du service public IP-API. Ce n'est pas une application autonome — l'extrait fourni doit être collé dans votre fichier principal d'application (par exemple, `app.py`) afin qu'il s'exécute parallèlement à vos gestionnaires de routes existants. ## Fonctionnalités - **Notifications Telegram en temps réel :** Des alertes instantanées sont envoyées à chaque accès à une page, avec des résumés de visite structurés directement vers un utilisateur ou un chat Telegram désigné. - **Données de géolocalisation :** Résout automatiquement la ville, le pays et l'ISP du visiteur en interrogeant IP-API à partir de l'adresse IP d'origine de la requête. - **Intégration non bloquante :** Le module intègre la gestion des erreurs afin que les échecs de l'API de suivi ou de la livraison Telegram ne perturbent pas le flux principal de l'application. - **Affichage respectueux de la vie privée :** Les adresses IP complètes sont partiellement masquées dans les notifications afin de réduire l'exposition tout en conservant une identification utile. ## Prérequis - Python - La bibliothèque `requests` (`pip install requests`) - Un jeton Bot Telegram obtenu auprès de @BotFather - Votre ID de chat Telegram personnel, récupérable depuis @userinfobot ## Installation et configuration 1. Créez un bot via @BotFather sur Telegram et enregistrez le jeton API. 2. Récupérez votre Chat ID depuis @userinfobot. 3. Collez l'extrait d'intégration dans le point d'entrée principal de votre projet (par exemple, `app.py`). 4. Remplacez les valeurs du jeton et de l'ID de chat par les vôtres — idéalement via des variables d'environnement plutôt que en dur. ``` pip install requests ``` ## Notes de compatibilité Ce module est écrit entièrement en Python. Il fonctionne avec Flask et Django dès le départ et peut être adapté à tout backend Python. Il ne fonctionnera pas sur des sites HTML statiques ou dans des environnements non Python sans transférer la logique vers ces langages. ## Avertissements importants - **Précision de la géolocalisation :** Les localisations sont déterminées par le routage du réseau ISP du visiteur, et non par des coordonnées GPS. Un utilisateur peut apparaître dans une ville différente de son emplacement physique selon la manière dont son fournisseur route le trafic. - **Respect de la vie privée et conformité légale :** L'outil collecte et transmet des données dérivées des adresses IP. Les utilisateurs sont responsables de se conformer aux réglementations applicables telles que le RGPD ou la CCPA. À utiliser de manière éthique et responsable. - **Sécurité：** Ne jamais coder en dur les jetons de bot ou les IDs de chat dans des dépôts publics. Utilisez des variables d'environnement ou un gestionnaire de secrets. ## Cas d'utilisation L'auteur utilise ce module sur un site portfolio privé en production pour surveiller le trafic visiteurs en direct et recevoir des insights de sécurité immédiats sur son appareil Telegram. Une notification exemple affiche l'IP masquée, le nom de l'ISP, la ville et le pays dans un message compact et formaté.