इस प्रोजेक्ट के बारे में

## Overview Telegram के लिए Web Visitor Analytics एक सर्वर-साइड Python मॉनिटरिंग मॉड्यूल है जिसे Python-आधारित वेब अनुप्रयोगों (Flask, Django, या किसी भी Python बैकएंड) में एकीकृत करने के लिए डिज़ाइन किया गया है। यह Telegram Bot API के माध्यम से वास्तविक समय में विज़िटर अलर्ट प्रदान करता है, और सार्वजनिक IP-API सेवा से प्राप्त जियोलोकेशन और ISP डेटा के साथ प्रत्येक नोटिफिकेशन को समृद्ध करता है। यह कोई स्टैंडअलोन एप्लिकेशन नहीं है — दिए गए स्निपेट को आपकी मुख्य एप्लिकेशन फ़ाइल (जैसे, `app.py`) में पेस्ट किया जाना चाहिए ताकि यह आपके मौजूदा रूट हैंडलर के साथ निष्पादित हो सके। ## Features - **वास्तविक समय Telegram नोटिफिकेशन:** हर बार किसी पेज पर जाने पर तुरंत अलर्ट भेजे जाते हैं, जिससे सीधे एक निर्दिष्ट Telegram उपयोगकर्ता या चैट पर संरचित विज़िट सारांश वितरित होते हैं। - **जियोलोकेशन डेटा:** अनुरोध के मूल IP पते का उपयोग करके IP-API को क्वेरी करके विज़िटर के शहर, देश और ISP का स्वचालित रूप से पता लगाता है। - **नॉन-ब्लॉकिंग इंटीग्रेशन:** मॉड्यूल में त्रुटि हैंडलिंग (error handling) शामिल है ताकि ट्रैकिंग API या Telegram डिलीवरी में विफलताएं मुख्य एप्लिकेशन प्रवाह को बाधित न करें। - **गोपनीयता-सचेत प्रदर्शन:** उपयोगी पहचान प्रदान करते हुए भी जोखिम को कम करने के लिए नोटिफिकेशन में पूर्ण IP पतों को आंशिक रूप से मास्क किया जाता है। ## Requirements - Python - `requests` लाइब्रेरी (`pip install requests`) - @BotFather से प्राप्त एक Telegram Bot टोकन - आपकी व्यक्तिगत Telegram Chat ID, जिसे @userinfobot से प्राप्त किया जा सकता है ## Installation & Setup 1. Telegram पर @BotFather के माध्यम से एक बॉट बनाएं और API टोकन सहेजें। 2. @userinfobot से अपनी Chat ID प्राप्त करें। 3. अपने प्रोजेक्ट के मुख्य एंट्री पॉइंट (जैसे, `app.py`) में इंटीग्रेशन स्निपेट पेस्ट करें। 4. प्लेसहोल्डर टोकन और चैट ID मानों को अपने स्वयं के मानों से बदलें — आदर्श रूप से उन्हें हार्डकोड करने के बजाय पर्यावरण चर (environment variables) के माध्यम से। ``` pip install requests ``` ## Compatibility Notes यह मॉड्यूल पूरी तरह से Python में लिखा गया है। यह Flask और Django के साथ सीधे काम करता है और इसे किसी भी Python बैकएंड के अनुकूल बनाया जा सकता है। लॉजिक को उन भाषाओं में पोर्ट किए बिना यह स्थिर (static) HTML साइटों या गैर-Python वातावरणों पर नहीं चलेगा। ## Important Disclaimers - **जियोलोकेशन सटीकता:** स्थान विज़िटर के ISP नेटवर्क रूटिंग द्वारा निर्धारित किए जाते हैं, न कि GPS निर्देशांक द्वारा। कोई उपयोगकर्ता अपने प्रदाता द्वारा ट्रैफ़िक को रूट करने के तरीके के आधार पर अपने भौतिक स्थान की तुलना में किसी भिन्न शहर में दिखाई दे सकता है। - **गोपनीयता और कानूनी अनुपालन:** यह टूल IP-व्युत्पन्न डेटा एकत्र और प्रसारित करता है। उपयोगकर्ता GDPR या CCPA जैसे लागू गोपनीयता नियमों का अनुपालन करने के लिए जिम्मेदार हैं। नैतिक और जिम्मेदारी से उपयोग करें। - **सुरक्षा:** सार्वजनिक रिपॉजिटरी में कभी भी बॉट टोकन या चैट ID को हार्डकोड न करें। पर्यावरण चर (environment variables) या सीक्रेट मैनेजर का उपयोग करें। ## Use Case लेखक लाइव विज़िटर ट्रैफ़िक की निगरानी करने और अपने Telegram डिवाइस पर तत्काल सुरक्षा अंतर्दृष्टि प्राप्त करने के लिए एक निजी प्रोडक्शन पोर्टफोलियो वेबसाइट में इस मॉड्यूल का उपयोग करता है। एक नमूना नोटिफिकेशन एक संक्षिप्त स्वरूपित संदेश में मास्क किए गए IP, ISP नाम, शहर और देश को दिखाता है।