Skip to content
KitploitKITPLOIT
FerramentasExploitsBlog
Log in
Enviar
FerramentasExploitsBlog
Enviar

Ferramentas de Hacking, PenTest e Cibersegurança para o seu Arsenal de Segurança!

Kitploit é um diretório de ferramentas de hacking, cibersegurança e pentesting. Descubra as últimas atualizações de projetos para encontrar vulnerabilidades, analisar sistemas, automatizar testes e fortalecer sua segurança.

FeedsContatoPrivacidade© 2026 Kitploit

Diretório de Ferramentas

Categorias

Ver todas as categorias
Loading categories
telegram-bot-dumper — Despeje um bot do Telegram. Navegue por ele como no Telegram Web. Ferramenta CLI forense com interface web | Kitploit
Ferramentas/GitHubGitHub/soxoj/telegram-bot-dumper
OSINT (Inteligência de Fontes Abertas)Exfiltração de DadosColeta de Informações
GitHubsoxoj/telegram-bot-dumper

telegram-bot-dumper

Despeje um bot do Telegram. Navegue por ele como no Telegram Web. Ferramenta CLI forense com interface web

Ver Repositório
24934100há 3 diasRevisado pelo Kitploit
Compartilhar

telegram-bot-dumper

Documentation Status

Dump fácil de tudo relacionado a bots do Telegram.

Entrada: apenas o token do bot.

Saída: nome e informações do bot, histórico de texto e mídia de todos os chats, informações e fotos dos usuários do bot.


Esta é uma implementação em Python.

🚀 Versão em Golang rápida, por ScBoln.

📖 Documentação completa: https://telegram-bot-dumper.readthedocs.io

Visualizador web

Uma interface de navegador semelhante ao Telegram Web para um dump: lista de chats, histórico completo de mensagens com mídia embutida, perfis de usuários com carrossel de fotos e busca global em todas as conversas ao mesmo tempo. Modo ao vivo suportado: ele executa o dumper em segundo plano e transmite novas mensagens para o navegador em tempo real.

Abra uma conversa e escolha Download chat para salvar seu histórico, mídia e fotos como dump_<bot_id>_<chat_id>.zip. O arquivo mantém a estrutura de diretórios <bot_id>/<chat_id>/ e exclui outros chats e arquivos de nível do bot.

Caso de uso — pentest de um token de bot vazado. Tokens de bots do Telegram aparecem constantemente em um engajamento — embutidos em código em um app mobile/desktop, commitados em um repositório, ou presentes em um log de CI, arquivo de configuração ou bundle do lado do cliente. Por si só, um token parece um achado de baixa severidade; carregá-lo aqui mostra o real raio de impacto. Para um bot interno (help desk, assistente de TI/DevOps, assistente de IA), isso significa todas as conversas de funcionários com ele — nomes de hosts internos, perfis de VPN, credenciais e detalhes de infraestrutura — navegáveis e pesquisáveis, para que você possa delimitar o impacto e evidenciar o achado em seu relatório.

Visualizador web — dump de um bot interno

Executar a partir de uma imagem pré-construída (Docker Hub)

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" soxoj/telegram-bot-dumper-web

Ou compile localmente

docker compose up --build      # builds and serves on http://127.0.0.1:8010

Ou sem Docker

pip install -r requirements.txt
python webapp/server.py        # serves dumps from the repository folder on :8010
./run-viewer.sh                # live mode + dumping new bots, API_ID/API_HASH from .env

Abra http://127.0.0.1:8010 e cole o token do bot para abrir o dump dele: ele deve corresponder ao token salvo no bot.json desse dump. A visualização somente leitura não precisa de credenciais de API. O modo ao vivo também precisa de API_ID/API_HASH de my.telegram.org, passados via ambiente — nunca embutidos na imagem:

# one-off container
docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" \
  -e API_ID=123456 -e API_HASH=abc... soxoj/telegram-bot-dumper-web

# or with docker compose: put them in a local .env (see .env.example)
cp .env.example .env && $EDITOR .env && docker compose up

As variáveis de ambiente PORT e HOST substituem os valores padrão (8010, 127.0.0.1).

Extraindo um novo bot a partir do visualizador

Por padrão, o visualizador só abre bots que já possuem um dump. Inicie-o com --allow-new-dumps (ALLOW_NEW_DUMPS=1 no Docker) e um token que ainda não tenha dump será verificado junto ao Telegram, receberá sua pasta e o bot.json, e o modo ao vivo extrairá todo o seu histórico diretamente no navegador. Isso requer API_ID/API_HASH.

Qualquer pessoa que consiga abrir a página poderá então fazer seu servidor extrair qualquer bot sob seu API_ID, portanto o visualizador se recusa a iniciar com essa flag ativada em um HOST que não seja loopback. No Docker, o HOST é sempre 0.0.0.0 dentro do contêiner, então adicione ALLOW_PUBLIC=1 (--allow-public) e mantenha você mesmo a porta em loopback:

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" \
  -e API_ID=123456 -e API_HASH=abc... -e ALLOW_NEW_DUMPS=1 -e ALLOW_PUBLIC=1 \
  soxoj/telegram-bot-dumper-web

Recursos

  • Despeja as mensagens do bot com conteúdo de mídia percorrendo os ids de mensagem para cima (padrão) ou para baixo (--down / --start-from-id).
  • Modo de escuta ao vivo (--listen-only): recebe novas mensagens em tempo real e oferece despejar o histórico para baixo a partir do primeiro id observado.
  • Resolve informações de usuário tanto para mensagens recebidas quanto para respostas enviadas pelo bot.
  • Modos leves para enumeração rápida de usuários: ignora mídia, ignora histórico de texto por chat, grava usuários em um único CSV.
  • Mensagens de grupo / supergrupo são marcadas com [from:USER][group:CHAT]. DMs enviadas pelo bot são marcadas com [to:USER].
  • Monitoramento de grupos: se o bot foi adicionado a um grupo/supergrupo E seu modo de privacidade está desativado, o bot recebe todas as mensagens do grupo — não apenas comandos e respostas — e --listen-only as despejará em tempo real. Com o modo de privacidade ativado (o padrão), o bot só vê comandos, menções e respostas.

Requisitos

  • Python >= 3.6
  • Telethon (consulte requirements.txt para a versão fixada)
  • Registre um aplicativo Telegram para obter API_ID e API_HASH

Usando como ferramenta CLI

pip install -r requirements.txt

# Telegram API credentials from https://my.telegram.org (read from the environment)
export API_ID=123456
export API_HASH=abc...

Início rápido — dump completo (comportamento padrão)

Percorre os ids de 1..∞ em lotes de 200, baixando todas as mensagens, todas as mídias e todas as fotos de perfil dos usuários. Por padrão, o dumper continua escutando novas mensagens recebidas após a conclusão do dump. Para sair imediatamente após o dump do histórico (ideal para scripts e tarefas cron), passe --no-listen.

./dumper.py --token 12345678:ABCe2rPVteUWZ7wLeCqCb3CH3ilUY_fLabc

Despejar para baixo a partir da mensagem mais recente

Para um bot ativo, a busca ascendente encontra um longo trecho de ids antigos podados (excluídos/expirados) e desiste. Percorrer para baixo a partir do id mais recente é muito mais produtivo. --down sonda automaticamente o limite superior (potências de 10 até 10⁹) e começa a partir do id não vazio mais alto que encontrar:

./dumper.py --token TOKEN --down

Nota. O Telegram não retém o histórico de mensagens de bots para sempre. Empiricamente, apenas as últimas centenas de milhares de mensagens permanecem acessíveis — em nossos testes, um bot movimentado expôs aproximadamente as últimas 500K mensagens antes de messages.getMessages começar a retornar apenas MessageEmpty para ids mais antigos. Se o seu bot historicamente processou mais tráfego do que isso, o histórico mais antigo simplesmente se perdeu no lado do servidor e nenhuma flag irá recuperá-lo.

Se você já conhece um id de mensagem recente (por exemplo, um que você viu em tempo real), pode pular a sondagem e começar exatamente a partir dele:

./dumper.py --token TOKEN --start-from-id 11922524

Modo de escuta

Não despeje nada; apenas observe o que chega. Na primeira mensagem recebida, o script oferecerá iniciar um despejo descendente a partir desse id:

./dumper.py --token TOKEN --listen-only

Enumeração leve de usuários (CSV, sem mídia, sem histórico por chat)

Útil quando você precisa apenas de uma lista de quem conversou com o bot — sem zips, sem jpegs, sem *_history.txt por chat.

Baixar ferramenta

Mais Populares

Ver todos →

Descubra as ferramentas mais usadas pela nossa comunidade.

Sem dados de popularidade ainda.

Explore todas as ferramentas

Navegue pela nossa coleção de ferramentas

Ver todas as ferramentas →