Sobre o projeto

## Visão geral Web Visitor Analytics for Telegram é um módulo de monitoramento Python do lado do servidor, projetado para se integrar a aplicativos web baseados em Python (Flask, Django ou qualquer backend Python). Fornece alertas de visitantes em tempo real por meio da API do Telegram Bot, enriquecendo cada notificação com dados de geolocalização e ISP derivados do serviço público IP-API. Não se trata de um aplicativo independente — o trecho fornecido deve ser colado no arquivo principal do seu aplicativo (por exemplo, `app.py`) para que seja executado junto com seus handlers de rota existentes. ## Recursos - **Notificações em tempo real pelo Telegram:** Alertas instantâneos são enviados sempre que uma página é acessada, entregando resumos estruturados de visitas diretamente a um usuário ou chat designado no Telegram. - **Dados de geolocalização:** Resolve automaticamente a cidade, o país e o ISP do visitante consultando a IP-API usando o endereço IP de origem da solicitação. - **Integração não bloqueante:** O módulo incorpora tratamento de erros para que falhas na API de rastreamento ou na entrega via Telegram não interrompam o fluxo principal do aplicativo. - **Exibição consciente da privacidade:** Endereços IP completos são parcialmente mascarados nas notificações para reduzir a exposição, ainda fornecendo identificação útil. ## Requisitos - Python - A biblioteca `requests` (`pip install requests`) - Um token de bot do Telegram obtido no @BotFather - Seu ID de chat pessoal do Telegram, recuperável no @userinfobot ## Instalação e configuração 1. Crie um bot via @BotFather no Telegram e salve o token da API. 2. Obtenha seu ID de chat no @userinfobot. 3. Cole o trecho de integração no ponto de entrada principal do seu projeto (por exemplo, `app.py`). 4. Substitua os valores de token e ID de chat de preenchimento pelos seus próprios — idealmente por meio de variáveis de ambiente, em vez de codificá-los diretamente. ``` pip install requests ``` ## Notas de compatibilidade Este módulo é escrito inteiramente em Python. Funciona com Flask e Django imediatamente e pode ser adaptado a qualquer backend Python. Não funcionará em sites HTML estáticos ou ambientes não Python sem que a lógica seja portada para esses idiomas. ## Avisos importantes - **Precisão da geolocalização:** As localizações são determinadas pelo roteamento de rede do ISP do visitante, não por coordenadas GPS. Um usuário pode aparecer em uma cidade diferente de sua localização física dependendo de como seu provedor roteia o tráfego. - **Privacidade e conformidade legal:** A ferramenta coleta e transmite dados derivados do IP. Os usuários são responsáveis por cumprir as regulamentações de privacidade aplicáveis, como GDPR ou CCPA. Use de forma ética e responsável. - **Segurança:** Nunca codifique tokens de bot ou IDs de chat em repositórios públicos. Use variáveis de ambiente ou um gerenciador de segredos. ## Caso de uso O autor utiliza este módulo em um site de portfólio privado em produção para monitorar o tráfego de visitantes ao vivo e receber insights de segurança imediatos em seu dispositivo Telegram. Uma notificação de exemplo mostra o IP mascarado, o nome do ISP, a cidade e o país em uma mensagem compacta e formatada.