Informer - Vigilância em Massa no Telegram

Atualização 10-20-2025

• Segurança: Corrigida vulnerabilidade de alta severidade CVE-2022-1941 no mysql-connector-python
• Segurança: Migrado do obsoleto oauth2client para google-auth
• Atualizadas todas as dependências para as versões seguras mais recentes
• Corrigidos bugs no script quick_start.sh (criação de venv e parâmetro account_id)
• Corrigidos problemas de conexão MySQL no Docker para compatibilidade entre plataformas
• Melhorada a documentação de configuração do Google Sheets

Atualização 08-23-2021

• Atualizado para o Telethon 1.23.0 mais recente
• Corrigidos problemas de banco de dados migrando para docker-compose
• Tornado Google Spreadsheets opcional na configuração
• Arquivos ENV seguros para configuração
• Configuração mais fácil
• Substituído docker-compose em vez do App Engine porque AE é ruim

Sobre

Informer (TGInformer) é uma biblioteca de bot que permite que você se passe por vários usuários REAIS no Telegram e espione mais de 500 canais do Telegram por conta. Os detalhes são registrados em um banco de dados MySQL, uma planilha privada do Google e seu próprio canal privado para análise.

Este é um projeto funcional de prova de conceito com bugs conhecidos. Sinta-se à vontade para bifurcar, compartilhar e me dar um toque.

Aplicações Comerciais Potenciais

• Marionetismo para derrubar um regime despótico
• Monitoramento de marca e análise de sentimento
• Promover criptomoedas em um instante para ganho financeiro
• Influenciar o sentimento em questões tópicas
• Entrar cedo na ação do preço
• Executar análise de um canal do Telegram

Funcionalidades

• Execute todos os seus bots na nuvem enquanto você dorme. Suporte ao Docker Compose

• Escreva todas as notificações em uma planilha privada do Google

• Suporta expressões regulares para filtragem de palavras-chave

• SQLAlchemy para persistência de dados agnóstica

• Registro de dados contextuais de mensagens e canais em um canal privado e banco de dados

• Armazena meta-informações sobre o remetente da mensagem, canal, número de participantes no canal

• Entra automaticamente em canais a partir de uma lista CSV contendo URLs de canais do Telegram

• Persiste a sessão dos canais ingressados

• Faça login uma vez, o bot permanece logado para sempre sem precisar de reautenticação 2FA

• Entre em até 500 canais por conta

• Usa contas REAIS evitando a detecção de bots, ISTO NÃO É UM BOT DO TELEGRAM mas sim uma conta de usuário automatizada real. Esta é uma distinção importante porque a API oficial de bots é limitada e os bots são frequentemente restritos em canais públicos.

Requisitos

SO / Infraestrutura

• Python 3+
• Docker (opcional)
• Telegram (Desktop, Web ou Mobile: https://www.telegram.org/)
• Aplicativo Burner

Pacotes Python

• SQLAlchemy (1.4.54)
• sqlalchemy-migrate (0.13.0)
• Telethon (1.36.0)
• mysql-connector-python (8.4.0)
• gspread (6.1.4)
• google-auth (2.37.0) - substitui o obsoleto oauth2client
• python-dotenv (1.0.1)

Início Rápido

Configure suas variáveis de ambiente

Edite o arquivo informer.env que contém todas as variáveis de ambiente necessárias para o informer

Você pode obter as informações necessárias relacionadas ao Telegram aqui:

Configure seu Aplicativo Telegram

1. Acesse https://my.telegram.org/auth para autenticar sua conta fornecendo um número de telefone e o código de confirmação enviado para seu número de telefone (ou Telegram)

2. Depois de autenticado, clique em "API Development Tools"

3. Crie um Novo Aplicativo preenchendo o formulário mostrado abaixo

4. Agora você deve ter os valores de parâmetro necessários para os campos TELEGRAM_API_HASH e TELEGRAM_API_APP_ID do arquivo informer.env

5. Substitua os valores, incluindo TELEGRAM_ACCOUNT_PHONE_NUMBER e prossiga para a próxima seção

Obtendo seu ID do Telegram

Até agora temos o necessário para o Telethon e o Informer acessarem as APIs do Telegram, em seguida precisamos adquirir os identificadores da conta do seu bot.

1. Abra o Telegram e pesquise pelo usuário userinfobot.

2. Você verá vários, certifique-se de selecionar a conta com a grafia correta.

3. Clique no usuário e você verá uma opção de diálogo na parte inferior que diz "Start". Clique nela.

4. O bot tem um único propósito, refletir de volta para você as informações da sua conta atual do Telegram.

Você deve receber seu nome de usuário do Telegram e seu ID de conta do Telegram. Isso é importante.

5. Edite o arquivo informer.env e preencha os valores para TELEGRAM_ACCOUNT_ID que deve ser seu ID de conta do Telegram da etapa anterior e TELEGRAM_ACCOUNT_USER_NAME.

Você pode opcionalmente preencher TELEGRAM_NOTIFICATIONS_CHANNEL_ID com seu nome de usuário ou um ID de canal.

6. Certifique-se de que TELEGRAM_ACCOUNT_PHONE_NUMBER esteja preenchido, pois isso é fundamental para gerar a sessão. Para criar várias contas, consulte o Burner App abaixo.

Inicializar e autenticar sessão

Certifique-se de estar executando python 3 e simplesmente execute ./quick_start.sh no diretório.

Você deve executar isso primeiro para poder autenticar com o Telegram na primeira execução e gerar um arquivo de sessão local.

Você pode posteriormente copiar os arquivos para as diferentes contas em app/session e montá-los via Docker, se desejar.