Об этом проекте

## Обзор Web Visitor Analytics for Telegram — это серверный модуль мониторинга на Python, предназначенный для интеграции в веб-приложения на Python (Flask, Django или любой другой Python backend). Он обеспечивает оповещения о посетителях в реальном времени через Telegram Bot API, дополняя каждое уведомление данными геолокации и провайдера, полученными из публичного сервиса IP-API. Это не автономное приложение — предоставленный фрагмент кода необходимо вставить в главный файл приложения (например, `app.py`), чтобы он выполнялся параллельно с вашими обработчиками маршрутов. ## Возможности - **Оповещения в Telegram в реальном времени:** мгновенные уведомления отправляются при каждом посещении страницы, предоставляя структурированную сводку о визите напрямую назначенному пользователю или чату Telegram. - **Данные геолокации:** автоматически определяет город, страну и ISP посетителя путём запроса к IP-API с использованием исходного IP-адреса запроса. - **Неблокирующая интеграция:** модуль включает обработку ошибок, чтобы сбои в работе API отслеживания или доставки в Telegram не нарушали основной поток приложения. - **Деликатное отношение к приватности:** полные IP-адреса частично маскируются в уведомлениях для снижения риска раскрытия, сохраняя при этом полезную идентификационную информацию. ## Требования - Python - Библиотека `requests` (`pip install requests`) - Токен Telegram Bot, полученный от @BotFather - Ваш персональный Telegram Chat ID, который можно получить от @userinfobot ## Установка и настройка 1. Создайте бота через @BotFather в Telegram и сохраните токен API. 2. Получите ваш Chat ID от @userinfobot. 3. Вставьте интеграционный фрагмент в главный входной файл проекта (например, `app.py`). 4. Замените значения-заполнители токена и chat ID на свои — предпочтительно через переменные окружения, а не жестко прописывая их. ``` pip install requests ``` ## Примечания по совместимости Модуль написан исключительно на Python. Он работает с Flask и Django «из коробки» и может быть адаптирован под любой Python backend. Он не будет работать на статических HTML-сайтах или в средах без Python без переноса логики на соответствующие языки. ## Важные положения - **Точность геолокации:** местоположение определяется маршрутизацией через сеть поставщика услуг посетителя, а не GPS-координатами. Пользователь может отображаться в другом городе относительно своего физического местоположения в зависимости от того, как его провайдер маршрутизирует трафик. - **Приватность и юридическое соответствие:** инструмент собирает и передаёт данные, производные от IP-адреса. Пользователи несут ответственность за соблюдение применимых нормативных актов в области приватности, таких как GDPR или CCPA. Используйте этично и ответственно. - **Безопасность:** никогда не храните токены ботов или chat ID в открытых репозиториях. Используйте переменные окружения или менеджеры секретов. ## Пример использования Автор использует этот модуль на частном производственном портфолио-сайте для мониторинга живого трафика посетителей и получения немедленных данных безопасности на своём устройстве Telegram. Пример уведомления показывает замаскированный IP, имя ISP, город и страну в компактном форматированном сообщении.