tdata, arquivo de sessão e JSON no Telegram: cada um abre em um programa

Chega um arquivo compactado com uma pasta chamada tdata. Ou um arquivo terminado em .session. Ou um texto longo colado numa mensagem, chamado de string de sessão. Ou ainda um JSON. Todos dizem entregar a mesma conta, e nenhum vem com instrução.

A confusão tem uma causa única: não são variações do mesmo arquivo, são coisas que pertencem a programas diferentes. Importar no lugar errado quase nunca dá uma mensagem de erro útil. Simplesmente não abre, e a pessoa conclui que o arquivo estava quebrado.

Quem abre o quê

• Pasta tdata. Pertence ao Telegram Desktop, o aplicativo de computador. Não é um arquivo, é um diretório com vários arquivos binários dentro. Abre no Telegram Desktop e em nada mais.
• Arquivo .session ou string de sessão. Pertence às bibliotecas de automação em Python, Telethon e Pyrogram. É lido por código, não por aplicativo. Nenhum clique duplo faz nada com ele.
• JSON. Não tem dono. É o que a ferramenta que gerou decidiu escrever, geralmente credenciais e metadados. Só serve se você souber qual ferramenta gerou e o que ela colocou lá dentro.

A pergunta que resolve noventa por cento dos casos, antes de baixar qualquer coisa: eu vou usar isso num aplicativo ou num script? Aplicativo quer tdata. Script quer sessão. Se a resposta for "não sei", a resposta prática é tdata, porque é o caminho sem programação.

Em que sistemas a pasta tdata existe

Essa dúvida aparece muito nas buscas, sempre colada ao nome de um sistema, e a resposta é mais simples do que parece: a pasta tdata pertence ao Telegram Desktop, então ela existe onde o Telegram Desktop existe. Isso inclui Windows, Linux e também macOS, porque o Telegram Desktop é distribuído para os três e usa a mesma organização de arquivos nos três.

Duas exceções que geram confusão. No macOS existe também um cliente nativo separado, que não é o Telegram Desktop e não guarda os dados nesse formato: se você instalou o aplicativo pela loja da Apple, provavelmente é esse, e ele não vai abrir uma pasta tdata. E no celular, Android ou iPhone, não existe pasta tdata para colocar em lugar nenhum. Uma conta entregue nesse formato é uma conta para abrir no computador. Se o seu plano era usar no telefone, o caminho é abrir no computador primeiro e depois entrar no celular pelo próprio Telegram, com a conta já nas suas mãos.

Abrindo uma pasta tdata sem destruir a sua própria conta

Aqui mora o erro mais caro e ele é irreversível na prática. Se você substituir a pasta tdata do Telegram Desktop que já está instalado no seu computador, você apaga a sessão da sua conta pessoal. Ela não volta sozinha; você precisa entrar de novo do zero.

O jeito certo é usar uma cópia portátil separada:

1. Baixe a versão portátil do Telegram Desktop e descompacte numa pasta própria, longe da instalação normal.
2. Dentro dessa pasta existe um diretório tdata vazio. É ele que você substitui pelo que recebeu.
3. Abra o executável de dentro dessa mesma pasta, não o atalho do menu iniciar.
4. Uma conta por pasta. Duas contas na mesma cópia portátil é o caminho mais rápido para misturar sessões.

Se ao abrir aparecer um pedido de senha, não é erro. É a verificação em duas etapas ligada, e ela é separada da sessão. Procure um arquivo de texto junto com o pacote, porque é comum a senha vir ao lado. Sem ela, a conta abre mas você não consegue reconfigurar nada.

Arquivo de sessão: o que costuma faltar

Um arquivo de sessão não basta sozinho. Ele foi criado sob um par de credenciais de aplicativo, o api_id e o api_hash, e a biblioteca precisa dos mesmos valores para reabrir. É por isso que "api id and hash error" aparece nas sugestões de busca: é a falha mais comum e ela não é sobre a conta, é sobre o par não bater.

Três coisas para pedir junto do arquivo, sempre:

• O api_id e o api_hash sob os quais a sessão foi gerada.
• Qual biblioteca gerou, porque sessão de Telethon e de Pyrogram não são intercambiáveis.
• A senha da verificação em duas etapas, se houver.

Faltando o primeiro item, o arquivo é praticamente inútil, e essa é a causa da maioria das reclamações de "veio quebrado".

Vale dizer uma palavra sobre os conversores, porque procurar por eles é um dos caminhos de busca mais comuns nesse assunto. Converter uma pasta tdata em arquivo de sessão, ou o contrário, é possível, e não é atalho: a sessão gerada continua presa a um par de credenciais de aplicativo, então o conversor não te livra de precisar do api_id e do api_hash. Ele muda o formato, não o requisito. Se você não tem o par, converter não resolve nada, e a decisão certa continua sendo pedir os dados ao vendedor.

JSON: pergunte antes de aceitar

Não existe leitor universal de JSON de Telegram porque não existe padrão. Antes de aceitar esse formato, pergunte que ferramenta gerou o arquivo e quais campos ele contém. Se a resposta não vier, o formato é um problema seu para resolver depois, não uma comodidade.

Na prática, JSON só compensa quando você já tem uma automação que espera exatamente aquele formato. Para qualquer outro caso, é o formato que mais gera retrabalho.

O que o mercado escolheu

Dá para ver a preferência com números. Na prateleira de contas de Telegram, com setecentos e noventa e oito anúncios ativos de quarenta e dois fornecedores, quatro em cada cinco entregam pasta tdata, e essa etiqueta custa praticamente a mediana da prateleira. Nem mais, nem menos.

Isso diz duas coisas. É o formato padrão, não um diferencial, então ninguém deveria cobrar a mais por ele. E é o formato que a maioria dos compradores consegue usar, o que faz sentido: é o único que não exige escrever código.

Um contraste que explica o Telegram inteiro: apenas cinco anúncios dessa prateleira, de setecentos e noventa e oito, incluem uma caixa de email. Na prateleira de contas de Twitter e X, quase dois terços incluem. Não é descuido dos vendedores. É que no Telegram o email não é a coluna de recuperação, e sim o telefone e a senha da nuvem. Quem procura email numa conta de Telegram está procurando a alavanca errada.

O que dá para fazer no primeiro dia, e o que só depois de 24 horas

Vale tratar como parte da importação, não como cuidado extra. Qualquer um desses arquivos equivale a uma sessão viva: quem tem a cópia entra na conta sem saber senha nenhuma.

1. Defina ou troque a senha da verificação em duas etapas, com um email de recuperação seu. Este é o primeiro passo, e não o segundo, porque é o único que funciona no mesmo dia. Enquanto a senha for a antiga, a conta é de quem a conhece.
2. Abra a lista de dispositivos e apenas anote o que está lá. Quantidade, tipo de aparelho, região, último acesso. O Telegram recusa que uma sessão encerre qualquer outra antes de ela mesma completar vinte e quatro horas conectada, e a recusa vale para encerrar um aparelho, encerrar todos os outros e até definir prazo de expiração, então não há atalho. Volte depois das vinte e quatro horas e encerre tudo que não é você.
3. Apague o arquivo original depois de confirmar que funciona. Cópia guardada em pasta sincronizada com a nuvem é credencial publicada.
4. Não deixe o pacote em conversa de trabalho. Ali ele fica encaminhável para sempre.

Uma observação sobre prazo, porque pega quem importa à noite: nessa prateleira a garantia mediana é de doze horas contadas da entrega. Faça o teste de abrir no mesmo dia. Como esse relógio funciona está no guia de entrega.