
Despeje um bot do Telegram. Navegue por ele como no Telegram Web. Ferramenta CLI forense com interface web
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
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.

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" soxoj/telegram-bot-dumper-web
docker compose up --build # builds and serves on http://127.0.0.1:8010
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).
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
--down / --start-from-id).--listen-only): recebe novas mensagens em tempo real e oferece despejar o histórico para baixo a partir do primeiro id observado.[from:USER][group:CHAT]. DMs enviadas pelo bot são marcadas com [to:USER].--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.requirements.txt para a versão fixada)API_ID e API_HASHpip install -r requirements.txt
# Telegram API credentials from https://my.telegram.org (read from the environment)
export API_ID=123456
export API_HASH=abc...
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
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.getMessagescomeçar a retornar apenasMessageEmptypara 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
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
Útil quando você precisa apenas de uma lista de quem conversou com o bot — sem zips, sem jpegs, sem *_history.txt por chat.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.