TgWitness / Documentação

O que foi testado →

Referência / Coletar

Telegram · 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.

TgWitness / Documentação · Coleção

Coleção

Em Mais ferramentas → Fontes → Bate-papos incluídos, verifique os bate-papos ativados, escolha API padrão ou Exportação Takeout e, em seguida, selecione Carregar histórico completo. A execução corrige essa lista de fontes e importa as mensagens anteriores disponíveis para o Bate-papos e para o diário de observações assinado. O recurso de mídia utiliza as configurações de anexos existentes e a fila de downloads permanente. Isso é independente da exportação assinada em formato JSON/HTML por bate-papo.

Para coleta em toda a conta, selecione Conta inteira e salve o escopo. O histórico atualiza todas as caixas de diálogo acessíveis, incluindo conversas arquivadas, antes de assinar sua lista de fontes. Essa descoberta não utiliza o limite da lista do seletor de conversas. As conversas descobertas posteriormente são observadas e recebem seu instantâneo inicial configurado; outra execução completa pode carregar seu histórico anterior. Mantenha a opção Manter observação ativada durante e após o carregamento do histórico ativada para registrar novas mensagens, edições e notificações de exclusão enquanto o histórico é carregado. Uma execução ou exportação do histórico utiliza o slot de aquisição; a observação em tempo real ocorre paralelamente a ela.

Escolha de um a três chats simultâneos, de um a cinco operadores de anexos e se deseja preservar as “Ações Recentes” disponíveis e comparar versões salvas anteriormente. A exportação pode exigir aprovação no Telegram e um tempo de espera especificado pelo servidor. Essas opções permanecem inalteradas ao retomar a operação. Consulte o comportamento de preenchimento retroativo e o contrato de evidência para obter detalhes sobre transporte, repetição de tentativas e confiança.

Pausa, reinício e resultados parciais#

  • Histórico de pausa interrompe a leitura. Histórico de continuação retoma a partir da última mensagem confirmada em cada fonte; reiniciar o aplicativo também mantém a execução em pausa até que seja retomada. A retomada requer a mesma conta do Telegram inativa.
  • 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 (cada intervalo dividido do Telegram no Takeout) define um ID de mensagem máximo 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.
  • O Telegram exibe o registro de administração de um chat apenas para seus administradores. Para um membro comum, a consulta ao registro de administração é registrada como `history.admin_log.unavailable` com o reason: not_admin, e não torna o histórico incompleto; já uma consulta ao registro de administração que falha para um administrador, sim.
  • Os atrasos do FloodWait respeitam o backoff da conta salva. Falhas transitórias são repetidas até cinco vezes; esgotamento e pouco espaço em disco causam uma pausa, mantendo o cursor intacto.
  • Encerrar esta execução do histórico preserva as observações salvas. Não as remove nem cancela tarefas de anexação da API padrão. Encerrar o Takeout marca seus arquivos Takeout restantes como ignorados; pausar permite que sejam retomados. Uma nova execução lê novamente as fontes habilitadas.

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 esperada da chave de assinatura 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. Novas execuções também vinculam o progresso da fonte e as opções a eventos de cursor assinados. Sem o --evidence, ele verifica apenas o relatório assinado e sua consistência interna. Os campos de progresso legados e os resumos de anexos permanecem como declarações assinadas do coletor. O verificador de evidências verifica os bytes de mídia arquivados.

Leia o histórico verificado juntamente com seus intervalos de aquisição, cobertura e ações recentes disponíveis. Esse fluxo de trabalho lê o histórico atualmente acessível; o monitoramento em tempo real preserva versões e notificações à medida que chegam, enquanto os Chats Secretos utilizam a integração de endpoint habilitada. Para verificação, use os pontos de verificação retidos, registros de testemunhas e atestados de aquisição aplicáveis descritos nos modos de verificaçã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.