TgWitness / Documentação

O que foi testado →

Algumas partes desta página ainda estão em inglês: o original em inglês sofreu alterações após ter sido traduzido.

Referência / Provas

Telegram · Exportação de contas

Exporte o que uma conta pode ler no momento: escopo, tarefas retomáveis, um arquivo assinado e cópias de compartilhamento minimizadas.

TgWitness / Documentação · Evidências e verificação

Evidências e verificação

A exportação de uma conta reserva o slot de aquisição da conta. A observação em tempo real pode continuar enquanto o arquivo é localizado, baixado, verificado e compactado. Pause outro histórico ou tarefa de exportação antes de iniciar uma aquisição simultânea. Pausar o arquivo mantém a observação em execução, e pausar a observação mantém a tarefa de arquivamento.

As exportações em contas diferentes podem ser executadas simultaneamente. Um trabalho apenas para exportação que esteja aguardando aprovação libera a conta, de modo que uma exportação em sessão regular separada possa ser iniciada enquanto a aprovação estiver pendente. Uma aquisição ativa ainda mantém a conta reservada.

Como administrador da instalação, selecione Página inicial → Exportar minha conta ou Exportações → Conta do Telegram → Configurar exportação da conta. Faça login, se necessário, revise o escopo e inicie explicitamente a exportação. Não é necessária observação contínua. Observações salvas é uma exportação separada do diário existente; seu arquivo ZIP inclui todas as fontes, independentemente dos filtros do diário. Cada espaço de trabalho possui suas próprias tarefas, identidade de assinatura e armazenamento. O acesso concedido pelo painel, incluindo uma autorização de exportação comum sem restrições, não permite acessar essas rotas válidas para toda a conta.

Os filtros de remetente e de texto são expandidos em “Filtrar por remetente ou texto da mensagem”. A seção “Dados da conta e método de conexão” contém categorias opcionais de contas e a opção “Takeout/sessão regular”; seu resumo mostra as opções ativas mesmo quando fechada. Fechar essas seções mantém suas configurações. Rascunhos de exportação e relatórios permanecem na sessão atual do painel ao alternar entre visualizações; eles não são salvos ao recarregar o navegador. Tarefas existentes continuam acessíveis a partir de qualquer uma das opções de exportação.

Este fluxo de trabalho exporta os dados atualmente acessíveis à conta conectada. O método padrão Automático inicia com o Telegram Takeout, que retorna o histórico acessível em seu estado atual, incluindo canais abandonados, contatos salvos e outros dados da conta. Se o Telegram impor um período de espera antes do início do Takeout, o modo “Automático” prossegue imediatamente com a sessão regular; o registro mantém account_export.transport e o inventário assinado indica o método utilizado e lista a alteração como uma omissão. A sessão do Telegram Takeout, por sua vez, aguarda apenas a aprovação, enquanto a sessão regular nunca solicita o Takeout. As conversas secretas são registradas em tempo real pelo módulo de conversas secretas, e as edições são registradas por meio de observação em tempo real. A sessão regular possui cobertura diferente e registra categorias não suportadas.

Página inicial → Exportar tudo inicia uma exportação com todos os tipos de bate-papo, todos os tipos de anexos, o perfil, os contatos, as fotos de perfil, as histórias, os metadados da sessão e outros dados da conta, em todos os formatos: o arquivo assinado do TgWitness com visualizações em JSON e HTML do Telegram Desktop. A opção Escolher o que exportar abre o formulário abaixo com as mesmas configurações padrão.

O Takeout é a API oficial de exportação também utilizada pelo Telegram Desktop. O TgWitness pode gravar JSON compatível com o Desktop diretamente a partir de sua própria aquisição; não é necessário importar o arquivo de outra pessoa. Os IDs de bate-papo e de mensagens estão disponíveis por meio de ambos os meios de transporte. A velocidade de exportação e o atraso na aprovação do Takeout dependem dos limites do Telegram para a conta, bem como do fato de um bate-papo ser público ou reenviável. Avalie o mesmo escopo e as mesmas configurações de mídia antes de comparar a velocidade.

Para até 20 IDs de bate-papo explicitamente selecionados, a exportação via API padrão resolve esses pares diretamente antes de considerar o inventário completo de diálogos da conta. Um canal público legível pode, portanto, ser exportado sem a necessidade de ingressar nele, mesmo quando estiver ausente da lista de diálogos. Os pares não armazenados em cache recorrem ao inventário comum. O filtro de arquivo continua em vigor: se o Telegram não retornar um diálogo e os chats arquivados forem excluídos, o status de arquivo desconhecido é registrado como uma omissão. O Takeout mantém seu procedimento de inventário de intervalo dividido. Nenhum dos caminhos entra em chats nem altera permissões de encaminhamento. No JSON compatível com Desktop, os canais que o Telegram marca como left aparecem sob left_chats, incluindo canais públicos legíveis dos quais a conta não participou.

Tanto o FLOOD_WAIT quanto o FLOOD_PREMIUM_WAIT suspendem as solicitações durante todo o período solicitado pelo servidor. O prazo da conta é mantido mesmo após reconexões e reinicializações; um tempo de espera posterior mais curto não pode reduzi-lo. As tentativas de repetição são limitadas, o cancelamento preserva as páginas seladas, e as credenciais da API não são alternadas para contornar um limite de taxa. Nenhuma compra do plano Premium é realizada.

Escolha o que será coletado#

Contexto Significado
Objetivo Registre por que essa aquisição é necessária. Não inclua nomes desnecessários ou detalhes confidenciais do caso aqui.
Idioma do relatório Escolha o idioma dos rótulos do relatório legível. O texto original da mensagem permanece inalterado; os rótulos do modelo não traduzidos utilizam o inglês. O idioma é definido pelas opções da tarefa assinada.
Tipos de chat / IDs de chat Todos os tipos selecionados ou apenas os chats listados; as “Mensagens Salvas” pertencem a chats privados. Os chats arquivados podem ser selecionados separadamente.
Datas UTC. As datas do calendário “De” e “Até” do painel estão ambas incluídas. A API utiliza intervalos inclusivos from_utc e exclusivos to_utc; o painel envia o início do dia seguinte à data “Até”. Um limite vazio deixa esse lado sem restrições.
IDs de remetentes Apenas mensagens dos remetentes listados; uma lista vazia inclui todos os remetentes.
O texto contém Expressões literais que não diferenciam maiúsculas de minúsculas são combinadas com “OU”. Condições de remetente/data/mensagem própria são combinadas com “E”.
Mensagens próprias Mantenha apenas as mensagens enviadas.
Tipos de mídia Selecione categorias de anexos ou desmarque todas para evitar o download de arquivos de mensagens.
Limites de arquivos / mídia total MiB por arquivo e GiB total de mídia baixada. Textos, recibos, relatórios legíveis e sobrecarga de ZIP exigem espaço adicional em disco.
Categorias de contas Perfil, contatos, fotos de perfil, stories, metadados de sessão e outros dados do Takeout possuem controles separados.

A predefinição “Minimize” desativa arquivos e metadados de contas. Os filtros de remetente/conteúdo são aplicados antes das páginas de mensagens retidas e dos downloads de mídia. O Telegram ainda transmite páginas do histórico da API contendo mensagens necessárias para avaliar esses filtros: a filtragem não garante que mensagens não selecionadas nunca entrem na memória do processo. Outras observações em andamento no espaço de trabalho têm seu próprio escopo e configurações de retenção.

O histórico de fotos de perfil, as histórias, os metadados de sessão e outros dados da conta são selecionados por padrão. Desative-os, bem como o perfil e os contatos, quando o caso exigir apenas mensagens. Se anexos ou metadados forem desnecessários, excluí-los durante a aquisição evita a retenção de outra cópia privada nesta exportação.

As cargas úteis de fotos utilizam a variante de imagem estática identificada em seus metadados e manifestos de hash, incluindo fotos com uma variante de avatar animado. Essa animação não substitui a imagem estática selecionada. Uma carga útil menor ou maior do que o tamanho observado é registrada como um anexo com falha, e uma representação alterada durante a renovação da referência do arquivo é rejeitada. Essas falhas deixam o arquivo incompleto, embora os registros das mensagens sejam mantidos. A verificação independente também rejeita anexos salvos cujo comprimento assinado contradiga seu tamanho ou representação observados, inclusive em arquivos mais antigos.

Se uma conexão dedicada para mídia falhar temporariamente, as leituras de anexos utilizam a conexão padrão de arquivos. Após um minuto, a rota dedicada é tentada novamente em segundo plano, enquanto os downloads continuam. Essa recuperação mantém o limite de conexão configurado e se aplica separadamente a cada data center. As esperas por inundação de mensagens no Telegram e as falhas de autorização continuam a se propagar.

Números de mensagens e mapa de atividades#

Cada arquivo de conta contém message-gaps.json e map.html. Canais e supergrupos numeram suas mensagens por chat; portanto, cada número ausente entre a primeira e a última mensagem exportada corresponde a uma mensagem desse chat. Bate-papos privados, bots e grupos básicos compartilham uma sequência numérica para toda a conta: um número ausente nesses casos pertencia a algum bate-papo. O bate-papo em questão é comprovado quando uma resposta exportada ou um pin aponta para o número; caso contrário, estima-se quais bate-papos estavam ativos no intervalo entre as mensagens vizinhas, e o restante é atribuído a bate-papos que não constam na exportação. Cada execução traz sua janela de tempo, mensagens vizinhas, as contagens por conversa e um rótulo de confiança. É declarado um escopo limitado (filtros, conversas não selecionadas), pois os números ausentes incluem, nesse caso, mensagens fora da seleção.

map.html apresenta um calendário, bate-papos ao longo do tempo e grades por dia da semana e por hora para mensagens e números ausentes, com tabelas de cada bate-papo e as sequências mais longas. As páginas de bate-papo exibem seu próprio calendário, participantes ao longo do tempo para grupos e uma marca na transcrição onde há mensagens ausentes. verify.py recalcula message-gaps.json a partir das páginas assinadas e rejeita um arquivo alterado.

O mapa de atividades lista as maiores lacunas de canais e supergrupos, incluindo seus intervalos de números e horários das mensagens vizinhas. Abra um intervalo para ir diretamente para a posição marcada na transcrição paginada. Essas marcas registram os números ausentes entre mensagens vizinhas salvas; os eventos de exclusão, seus horários e os textos das mensagens provêm apenas dos registros salvos. Tabelas largas rolam dentro de seus cartões em telas pequenas.

As transcrições longas incluem um índice de páginas com intervalos de datas das mensagens e um calendário. Escolha um mês para abrir seu primeiro registro na ordem das páginas capturadas. A contagem dos meses utiliza as datas das mensagens registradas em UTC; os registros sem data permanecem na transcrição. A navegação pelas páginas inclui a primeira, a última e as páginas próximas, e abre a seção da mensagem diretamente. O índice funciona offline, sem JavaScript.

Resumo, cobertura e verificação#

Cada tarefa congela suas opções e a identidade da conta. O inventário e as páginas capturadas são assinados; os recibos das páginas registram hashes, cursores, horários, resultados de anexos e seus recibos anteriores. Somente páginas confirmadas avançam no progresso. A função “Reiniciar/Retomar” verifica esses registros antes de continuar. Uma conta alterada, uma página assinada alterada ou uma cadeia de recibos inconsistente é rejeitada. As opções não podem ser editadas no meio de uma aquisição: inicie outra tarefa para outro escopo.

A função “Pausar” interrompe a operação da conta em execução. Reiniciar o aplicativo deixa o trabalho inacabado disponível para retomada explícita. Uma sessão do Takeout expirada requer uma retomada explícita; alterar os intervalos de divisão do Telegram pode exigir uma nova aquisição. A função “Retomar” mantém as observações anteriores, de modo que uma exportação de longa duração não é um instantâneo atômico único. Outras operações de alteração de conta e exportações conflitantes são bloqueadas durante a aquisição. Aguarde a conclusão da compactação antes de excluir um espaço de trabalho.

A opção “Retomar” exibe a mensagem Verificando dados de exportação salvos… imediatamente e verifica o conteúdo salvo em segundo plano antes de entrar em contato com o Telegram. O painel permanece disponível durante a verificação. A opção “Pausar” aguarda que o processo de verificação seja concluído com segurança antes de liberar a conta; ela também funciona quando selecionada imediatamente após o início ou a retomada. Em armazenamentos lentos, essa espera pode ser demorada. Verificações de integridade com falha geram uma tarefa com falha, acompanhada de uma explicação, e mantêm seus arquivos.

Se o Telegram encerrar a autorização da conta durante a aquisição do inventário, do histórico ou dos anexos, a tarefa será pausada sem marcar a página inacabada como concluída. Reconecte a mesma conta e retome a tarefa para continuar a partir da última página salva. Os marcadores de posição de mensagens indisponíveis avançam o cursor do histórico, mas não encerram a leitura: as mensagens mais antigas disponíveis ainda são solicitadas, e um marcador de posição não é apresentado como uma mensagem capturada ou uma exclusão confirmada.

The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: Coverage and missing material. Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed.

Os arquivos ZIP finalizados permanecem disponíveis para downloads repetidos e por intervalo HTTP. Um arquivo de conta contém manifest.json, manifest.sig, job.json assinado, inventory.json, receipts/, data/*.jsonl oficiais, media/ selecionados, HTML legível e um verificador. Fixe a impressão digital do coletor por meio de um canal independente e, em seguida, verifique usando uma instalação confiável. O painel salva o arquivo como tgwitness-account-export-EXPORT_ID.zip; uma captura selada o inclui em seu arquivo de evidências como account-export.zip. Use o nome do arquivo que você possui:

python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256

Para arquivos cujo conteúdo expandido exceda 4 GiB, defina um limite explícito adequado --max-gib. O painel verifica seus arquivos locais autenticados e completos usando o tamanho expandido declarado e o resumo publicado ZIP; a CLI externa mantém seu limite de tamanho independente. Verifique antes de abrir o HTML legível. O verificador integrado ao arquivo é prático, mas um verificador obtido de forma independente evita a necessidade de confiar no código executável fornecido junto com a evidência.

A assinatura Ed25519 e os hashes SHA-256 detectam alterações após o coletor ter confirmado os bytes relevantes. Analise esse resultado juntamente com o escopo de coleta registrado, os intervalos de aquisição, os recibos de carimbo de data/hora externos e as verificações de proveniência disponíveis para a implantação selecionada. Observações posteriores são registradas separadamente, preservando as versões capturadas anteriormente.

Prepare uma divulgação para um advogado ou outro destinatário#

Após baixar uma exportação concluída, mantenha o arquivo original ZIP e abra index.html a partir de uma cópia extraída. O relatório explica seu escopo, cobertura disponível e limites. Suas referências de registro combinam a referência do arquivo, o caminho do documento e o número do registro, para que o destinatário possa localizar a mesma entrada no HTML ou na impressão. Para ver um exemplo prático, abrir o relatório fictício.

A partir de uma exportação de conta concluída, selecione “Preparar uma cópia para compartilhamento”. Isso gera um derivado assinado separado. A fonte ZIP permanece inalterada e privada; não a envie junto com um derivado minimizado, a menos que o destinatário esteja autorizado a receber seu conteúdo completo. Escolha o idioma do relatório separadamente. Alterar o idioma ou qualquer configuração de seleção requer outra visualização prévia antes da criação.

  1. Insira a finalidade da divulgação e selecione datas, IDs de remetentes e critérios de texto literal.
  2. Escolha entre manter as identidades, revelar apenas os participantes listados ou pseudonimizar todos. Em qualquer um dos modos de pseudonimização, os IDs/títulos das conversas e os IDs das mensagens também são substituídos. Os pseudônimos permanecem estáveis dentro de uma divulgação e mudam entre divulgações preparadas independentemente.
  3. Mantenha o texto da mensagem, omita-o totalmente ou adicione nomes/frases literais para mascarar. Nos modos privados, a ferramenta também mascara nomes de remetentes ocultos conhecidos e nomes de usuário alternativos, IDs de remetente com token completo, nomes de bate-papos diretos, links, endereços de e-mail e sequências semelhantes a números de telefone. A correspondência de nomes conhecidos lida com a conversão de maiúsculas e minúsculas do Unicode, incluindo Straße/STRASSE. Títulos genéricos de grupos/canais não são removidos automaticamente do texto da mensagem. Se o limite de mascaramento de identidades conhecidas for excedido, restrinja a exportação de origem ou omita o texto; a ferramenta se recusa a ignorar silenciosamente nomes posteriores. Essas são regras de melhor esforço, não de anonimização geral.
  4. Deixe os arquivos de fora, a menos que o destinatário precise deles. Os originais incluídos mantêm seus pixels, áudio, texto e metadados. Eles não são anonimizados pela ferramenta.
  5. Visualize as contagens, os avisos e exemplos de mensagens transformadas e, em seguida, confirme explicitamente a criação. As amostras são limitadas a 12 mensagens e 2.000 caracteres de texto cada. Trata-se de uma amostra, não de uma revisão completa do resultado. Alterar as configurações requer uma nova visualização. Uma visualização expira após 15 minutos e está vinculada àquela sessão do administrador e à imagem original exata ZIP; ela não pode ser reutilizada após a criação. Uma nova visualização invalida a anterior para o mesmo trabalho e sessão.
  6. Confira o resultado completo index.html e messages.jsonl localmente antes de entregá-lo. Se ele revelar informações desnecessárias, crie uma nova divulgação com exclusões mais rigorosas. Não edite a imagem assinada ZIP no local.

Mensagens excluídas pela seleção#

Pré-visualização. Uma divulgação não parece completa quando não está. Dentro de cada chat que contenha pelo menos uma mensagem divulgada, as mensagens que não foram incluídas na seleção aparecem como marcadores, [withheld by selection — rule: sender] (ou text, period). Escolha “Mensagens excluídas pela seleção”: um marcador para cada sequência de mensagens ocultadas consecutivas (padrão) ou um para cada mensagem. Os marcadores contêm apenas a regra e uma contagem, nunca texto, remetente, data ou arquivos. Bate-papos sem nada divulgado são totalmente excluídos, de modo que o pacote não revela que eles existem.

Respostas divulgadas indicam o que respondem: uma mensagem incluída nesta cópia, uma mensagem excluída pela seleção ou uma mensagem que não consta na exportação de origem (excluída antes da exportação ou nunca exportada; a exportação não permite distinguir qual das duas). Uma mensagem omitida à qual uma resposta divulgada se refere sempre recebe seu próprio marcador, de modo que a resposta aponta para um registro que explica por que ela está vazia. Esses três estados são distintos das exclusões e lacunas na coleta, que pertencem à exportação de origem.

Em messages.jsonl (formato tgwitness-account-disclosure-v2) cada mensagem possui state: disclosed, ou withheld com rules e count. Uma resposta divulgada possui reply_to com o alvo id e state (disclosed, withheld, not_in_source). O manifesto contabiliza mensagens, bate-papos, mídias e withheld mensagens. verify.py Rejeita um marcador que contenha conteúdo e uma resposta que aponte para um registro ausente do pacote; os pacotes da versão 1 são verificados como antes.

O formato minimizado omite perfis de conta estruturados, contatos, avatares, sessões, stories, objetos brutos do Telegram, cabeçalhos de encaminhamento, citações de respostas, cartões de contato e metadados de localização. Ele exclui os arquivos JSONL originais, configurações de filtro privadas, chave de pseudônimo e mapa de identidade. Textos selecionados, identidades explicitamente retidas e arquivos incluídos ainda podem conter os mesmos nomes, IDs ou frases usados nesses filtros; eles precisam de revisão separada. A política privada e a chave de pseudônimo são mantidas criptografadas no cofre local da tarefa; a exclusão da tarefa limpa seus registros de divulgação privada associados. A política pública registra o número de filtros, em vez dos valores dos filtros. A finalidade declarada é pública no manifesto e no HTML: critérios privados explícitos e, em modos pseudonimizados, identidades ocultas conhecidas também são mascaradas ali, inclusive quando o texto da mensagem é omitido. Mantenha a finalidade livre de detalhes pessoais desnecessários; o contexto de identificação desconhecido pode permanecer.

Seu manifesto vincula os arquivos derivados, a política pública e o hash do ZIP original. A verificação permite confirmar a integridade e, caso a fonte seja fornecida localmente, a correspondência das ligações da fonte. O painel salva a cópia compartilhada como tgwitness-disclosure-DISCLOSURE_ID.zip:

python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip

A vinculação à fonte mostra de qual arquivo e de qual chave do coletor a divulgação se originou. A divulgação contém apenas o conteúdo selecionado; revise a seleção e a remoção dos detalhes identificadores com base na exportação original.

Compartilhamento e captura hospedada#

Selecione as mensagens e os arquivos de que o destinatário precisa, revise a cópia completa a ser compartilhada e mantenha a fonte separadamente. Registre o hash do ZIP entregue para que o destinatário possa identificar e verificar essa cópia exata. A pseudonimização substitui os identificadores selecionados; o texto incluído e os arquivos originais continuam fazendo parte da revisão.

O GitHub Actions oferece suporte à exportação de contas completas e de chats selecionados por meio do Takeout ou da API padrão, além de um diário de eventos de um único chat. O guia de captura hospedada explica a verificação das configurações e o limite de 120 minutos. Para verificar uma cópia compartilhada derivada da captura hospedada, compare o hash de origem com o arquivo original e verifique o atestado desse arquivo por meio das verificações específicas do modo .

Formato das evidências · Relatórios de casos