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
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 oreason: 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.