Como exportar o histórico de um chat do Telegram

Para exportar o histórico de um chat do Telegram, você precisa de algo que leia a conversa como você e a grave no seu próprio disco. O TelegramBuddy faz isso de três formas: uma página HTML fácil de ler que abre em qualquer navegador, um arquivo JSON para tudo o que precisa de dados estruturados, e um arquivo de texto simples com apenas as mensagens que você escolheu. É um app de computador gratuito para macOS e Windows, e roda a partir do código no Linux. Não é um bot nem um site: você entra na sua própria conta do Telegram com um código QR ou com o seu número de telefone, e a exportação é gravada direto em uma pasta do seu computador.

Qual das três você quer depende de uma única pergunta: quem vai ler isso é uma pessoa ou um programa?

HTML ou JSON: qual exportação é a certa para você

As duas cobrem a mesma conversa. A diferença está em para quem o arquivo é feito.

	Página HTML	Arquivo JSON
O que você recebe	Uma única página, na ordem de leitura	Um registro estruturado por mensagem
Abre com	Qualquer navegador	Qualquer coisa que leia JSON — um script, um importador de planilhas, outro app
Melhor para	Ler, guardar, entregar para outra pessoa	Buscar em massa, contar coisas, levar os dados para outro lugar
Mídia	Ligada aos arquivos no seu disco	Referenciada por nome e caminho do arquivo
Agradável de ler	Sim	Não muito

Uma regra prática: o HTML é a cópia que você realmente vai abrir daqui a três anos. O JSON é a cópia da qual você vai ficar grato quando quiser fazer algo que ninguém planejou — puxar todos os links que um grupo já publicou, contar mensagens por mês, jogar uma conversa dentro de outra ferramenta. Não é uma coisa ou outra, e exportar as duas é o padrão mais seguro.

Como exportar o histórico de um chat do Telegram, passo a passo

A ordem importa mais do que as pessoas esperam, porque a exportação aponta para os arquivos de mídia em vez de carregá-los dentro de si. Baixe primeiro, exporte depois, e todos os links da página final vão funcionar.

1. Entre na sua conta. Abra o app e entre na sua própria conta do Telegram com um código QR ou com o seu número de telefone. Na primeira vez, ele pede um api_id e um api_hash, que você pega de graça com o Telegram em my.telegram.org, em “API development tools”. Leva alguns minutos, você faz isso uma vez só, e os valores ficam na sua máquina. Há um passo a passo em como obter um api_id e um api_hash do Telegram.
2. Abra o chat que você quer. Escolha na sua lista de chats, ou cole um @usuário, um id numérico, um link de convite t.me/+ ou um link privado t.me/c/<id>/<mensagem> para abrir algo que ainda não está na lista. Grupos e canais privados funcionam desde que você seja membro — veja como baixar de um canal privado do Telegram.
3. Baixe a mídia. Use o download em massa para buscar todos os arquivos que correspondem ao filtro no chat, percorrendo o histórico inteiro, ou selecione mensagens à mão na visualização de chat. Você pode colocar vários chats na fila de uma vez e deixar rodando.
4. Deixe terminar. Um histórico longo leva um tempo e o Telegram às vezes pede que o app espere; essas pausas são tratadas para você. Os arquivos grandes continuam de onde pararam em vez de começar do zero, o que faz diferença em uma conexão instável — isso é explicado em como retomar downloads interrompidos do Telegram.
5. Exporte o chat. Escolha HTML, JSON ou os dois. A exportação é gravada ao lado dos seus arquivos.
6. Confira uma coisa. Abra a página HTML e clique em uma foto e em um vídeo. Se os dois abrirem, o seu acervo está íntegro e você pode guardá-lo em um lugar seguro.

O passo 3 é opcional no sentido estrito — você pode exportar só a conversa. Mas uma exportação cuja mídia nunca foi baixada é uma transcrição cheia de links quebrados, e raramente é isso que alguém quer dizer com acervo.

Como a exportação se liga à mídia que você baixou

A exportação não enfia as imagens dentro de um único arquivo gigante. Ela aponta para os arquivos reais no seu disco, e é por isso que eles continuam úteis por conta própria e que a página abre na hora.

Os arquivos são salvos em uma pasta por chat, e você pode dividir cada chat nas subpastas Photos, Videos, Files, Music e Voice (Fotos, Vídeos, Arquivos, Música e Voz). Cada arquivo mantém o nome que o Telegram deu a ele. Os arquivos que chegam sem nome nenhum — o que é o caso da maioria das fotos e de muitos vídeos — recebem o nome do id da mensagem de onde vieram, então uma foto da mensagem 4182 fica como 4182.jpg. Se dois arquivos realmente diferentes tiverem o mesmo nome, o segundo recebe o id da mensagem entre parênteses: report (4193).pdf. Nada sobrescreve nada em silêncio.

Duas consequências práticas:

• Mantenha a pasta e a exportação juntas. A exportação se refere aos arquivos pelo lugar que eles ocupam nessa pasta. Mova a pasta inteira do chat para onde quiser; mova a página HTML sozinha para fora dela e os links quebram. Quando fizer backup do acervo, faça backup da pasta.
• As datas batem. A data de cada arquivo recebe a data em que a mensagem foi publicada, e não a data em que você a baixou. Ordene por data a pasta de um chat no Finder ou no Explorer e você tem a ordem em que a conversa aconteceu, o que deixa a pasta navegável mesmo sem abrir a exportação.

Salvar o texto só das mensagens que você precisa

Uma exportação completa é a ferramenta errada para “tinha um endereço em algum lugar dessa conversa”. Para isso, a visualização de chat é mais rápida.

A visualização de chat mostra a conversa inteira, da mensagem mais antiga à mais recente — texto e mídia juntos, com separadores de dia e miniaturas, e as mensagens antigas carregando conforme você rola para cima. Clique em uma mensagem para selecioná-la, use shift+clique para pegar um intervalo, ou use Selecionar tudo, Só arquivos ou Só textos para levar tudo de uma vez. Com a seleção feita, salve o texto em um arquivo .txt e você recebe exatamente aquelas mensagens, na ordem do chat, e nada mais.

É isso que você quer para tirar as decisões de um grupo de planejamento com 900 mensagens, guardar uma receita que alguém publicou ou juntar todos os links de um canal de leituras. Leva segundos e gera um arquivo pequeno o bastante para colar em uma anotação.

Manter o acervo atualizado sem começar do zero

Os canais continuam publicando, então uma exportação é um retrato de um momento, e não um espelho ao vivo. Atualizar sai barato: rode o mesmo chat outra vez e os arquivos já concluídos são ignorados, então só o que é novo é baixado. Depois exporte de novo por cima.

Isso faz de uma atualização mensal ou trimestral um hábito perfeitamente razoável para um canal com o qual você se importa, e é o motivo de a primeira rodada ser a lenta.

O que uma exportação é, e o que ela não é

Vale ser direto sobre os limites:

• Ela vê exatamente o que a sua conta vê. Os chats dos quais você é membro, nada além disso. Não existe porta dos fundos para um canal em que você nunca esteve.
• Ela é um retrato do momento em que você a rodou. Nada é sincronizado depois disso até você rodar de novo.
• Nada passa pelo servidor de outra pessoa. Não existe conta do TelegramBuddy nem etapa de envio — o app fala direto com o Telegram e grava no seu disco. A sua sessão de login é um arquivo na sua própria máquina. Este é um projeto independente e não tem vínculo com o Telegram.
• Conseguir salvar algo não é o mesmo que ter o direito de guardar ou compartilhar. Cursos pagos, filmes licenciados e o trabalho de outras pessoas continuam sendo deles. Arquive o que é seu para arquivar.

Para onde ir depois

Se você está configurando isso pela primeira vez, o passo do api_id é a única parte que exige sair do app, então comece por aí. Se você está avaliando se o app cobre o que precisa, a página de recursos lista a visualização de chat, a visualização de galeria, o download em massa e o comportamento da exportação em um só lugar, e o FAQ responde às perguntas curtas — onde os arquivos ficam, o que acontece quando a conexão cai, quais dos oito idiomas de interface estão disponíveis.