TgWitness / Documentação

Referência / Coletar

Carregar histórico de origem

Carregue mensagens anteriores de fontes habilitadas, pause e retome a gravação e verifique um relatório de progresso assinado.

Versão principal atual: disponível no código-fonte; não incluída na prévia portátil da versão 0.7.0.

Em “Fontes”, revise os chats habilitados, inicie a observação e, em seguida, selecione “Carregar histórico completo”. A execução fixa essa lista de fontes e importa as mensagens anteriores disponíveis para “Chats” e para o diário de observação assinado. A mídia utiliza as configurações de anexos existentes e a fila de download permanente. Isso é independente da exportação assinada em formato JSON/HTML por chat.

Para coleta em toda a conta, selecione “Conta inteira”, inicie a observação para carregar sua lista de fontes e revise essa lista antes de iniciar o histórico. O limite da lista de diálogos ainda se aplica (1.000 por padrão, ajustável em “Parâmetros”). Uma execução bem-sucedida não comprova que todas as conversas da conta foram listadas. Bate-papos descobertos ou ativados posteriormente exigem outra execução.

Pausa, reinício e resultados parciais#

  • Pausar o histórico interrompe a leitura. Continuar o histórico retoma a partir da última mensagem gravada em cada fonte; reiniciar o aplicativo também deixa a execução em pausa até que seja retomada. Reinicie a observação primeiro. A retomada requer a mesma conta do Telegram.
  • A observação da mensagem, o processamento do anexo e o registro do cursor ocorrem em uma única transação. Uma execução retomada não repete as observações já registradas. A captura em tempo real ou uma execução separada, iniciada explicitamente, pode observar a mesma mensagem de forma independente.
  • Cada fonte define um ID máximo de mensagem na primeira leitura. As mensagens mais recentes pertencem à observação em tempo real, e não às páginas históricas restantes dessa fonte.
  • Fontes inacessíveis e fontes desativadas durante a aquisição permanecem visíveis como falhadas ou ignoradas. Outras fontes continuam; o resultado geral fica incompleto.
  • Os atrasos do FloodWait respeitam o intervalo de espera salvo na conta. Timeouts de transporte e pouco espaço em disco suspendem a execução, mantendo o cursor intacto. Retome após resolver a causa.
  • Encerrar esta execução do histórico preserva as observações salvas. Isso não as remove nem cancela os downloads de anexos já enfileirados. Uma nova execução lê as fontes habilitadas novamente.

A conclusão do histórico descreve apenas as leituras do histórico. Os anexos podem permanecer pendentes, falhar ou ser excluídos pela política configurada. Verifique os recibos de mídia no registro e na fila de anexos; somente um recibo concluído com bytes preservados constitui um anexo salvo. A operação do histórico é uma solicitação explícita de instantâneo e é distinta das opções que selecionam categorias de eventos ao vivo futuros.

Transferir e verificar#

Salve o relatório de progresso assinado e, em seguida, use a opção “Exportar evidências” para baixar o registro e os anexos salvos. Uma exportação posterior de evidências pode incluir registros adicionais; o relatório vincula seus contadores ao prefixo do registro no momento em que foi criado. Execute o verificador a partir de uma cópia confiável desta versão:

python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT

Mantenha a impressão digital da chave de assinatura esperada de forma independente. O verificador verifica a assinatura do relatório, o arquivo de evidências, o ponto de verificação do relatório, o plano de origem, a conta e as contagens de mensagens salvas/indisponíveis. Sem o --evidence, ele verifica apenas o relatório assinado e sua consistência interna. As fases de progresso, títulos, cursores e resumos de anexos são declarações assinadas do coletor, não reconstruídas de forma independente por este verificador de relatórios. O verificador de evidências ainda verifica os bytes de mídia arquivados.

Nem a assinatura nem a finalização do histórico disponível comprovam a origem do Telegram, um instantâneo atômico ou a integridade histórica. As mensagens podem sofrer alterações durante a leitura; mensagens excluídas, edições intermediárias não visualizadas e bate-papos secretos não são recuperados. Um operador que controle a chave de assinatura pode falsificar um registro antes que existam compromissos externos. Utilize pontos de verificação mantidos separadamente ou uma testemunha independente para as propriedades documentadas de detecção de adulteração.

O cursor de aquisição representa o estado local da área de trabalho. A restauração de um arquivo ZIP de evidências, por si só, não restaura uma tarefa de aquisição pendente nem uma sessão do Telegram. Mantenha o backup da área de trabalho caso seja necessário dar continuidade à tarefa original.