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 / Coletar
Telegram · Guia do painel
Todas as telas do painel: bate-papos, diário, fontes, exportações, Extras, modos de proteção e verificação de código.
TgWitness / Documentação · Introdução
Primeira configuração e ajustes · Contas · Exportar e verificar · Relatórios de casos
O que cada tela faz, o que ela grava no diário assinado e onde está o
guia detalhado. O painel exibe um espaço de trabalho por vez: uma conta do Telegram com suas próprias
fontes, diário e chave de assinatura. O seletor de contas na barra superior alterna
entre os espaços de trabalho. O endereço contém o espaço de trabalho (?ws=…); enquanto o endereço, o
seletor e a conta carregada não coincidirem, as ações permanecem bloqueadas.
Use os métodos de comparação Compare para escolher entre observação em tempo real, histórico completo, exportações recentes de contas/chats e transferência de registros salvos. A página Exportações inclui a mesma comparação acima dos controles de download.
Nesta página
Navegue pelo site#
A barra lateral reúne seis seções diárias: Página inicial, Bate-papos, Diário, Exportações, Contas e Configurações. As seções às quais seu acesso não permite são omitidas. Mais ferramentas contém ferramentas de investigação e administração. Abra Aparência na parte inferior da barra lateral para alterar o idioma, o tema, o fuso horário ou o nível da interface:
| Nível | Seções na barra lateral |
|---|---|
| Simples | As seções diárias |
| Padrão | Além disso, Case Board, Fontes, Acesso e Documentação em Mais ferramentas |
| Especialista | Além disso, Mapa do sistema, Topologia de rede, Extras, Pergunte ao arquivo, Parâmetros, Conta, Log do sistema e Integrações em Mais ferramentas |
Os nomes das seções permanecem os mesmos em todos os níveis. Um nível apenas oculta seções. Um recurso oculto continua funcionando, e o servidor verifica cada permissão por conta própria. Nível, idioma, tema e fuso horário são salvos por operador e espaço de trabalho; consulte as configurações.
Use Ir para uma seção na parte superior da barra lateral (Ctrl+K ou ⌘K no Mac) para localizar
um chat, um parâmetro ou um registro do diário por #number. As setas se deslocam, Enter abre,
Esc fecha.
A barra superior apresenta:
- Notificações: problemas e alterações no chat extraídos do diário. A opção “Marcar tudo como lido” zera o contador, e “Regras de notificação” abre as regras. O envio para o Telegram, Discord ou e-mail é configurado em Extras → Notificações.
- Um menu de status da coleta com o controle de iniciar/pausar, configurações de conexão e diagnósticos de integridade para o Telegram, recebimento de eventos, fontes e a fila de anexos. Em uma tela estreita, abra-o com o ícone de atividade.
- Bloquear: fecha o painel neste navegador. A coleção continua em execução no servidor.
A versão e o modo de proteção estão na seção Aparência; consulte os modos de proteção.
Uma instalação abre a página Página inicial após o login; um link explícito abre a
tela solicitada. Um revisor com escopo de bate-papo abre a seção “Bate-papos”. Os endereços /home, /case-board,
/pseudo-secret e /network-topology também abrem suas telas correspondentes.
Endereços de páginas desconhecidas retornam o código HTTP 404 com sugestões de páginas relacionadas.
O espaço de trabalho de demonstração contém mensagens fictícias e nunca se conecta ao Telegram. Ações que alterariam um espaço de trabalho real são recusadas nesse ambiente.
O mapa do sistema mostra as rotas das contas desta instalação, o estado do proxy, pontos finais de soquete, cofres criptografados, serviços de evidência e solicitações de rede observadas. Selecione uma conta para inspecionar seu caminho. Serviços disponíveis, mas desativados, permanecem visíveis.
Comece aqui#
A visão geral limpa o gráfico e o resumo específicos da conta quando você alterna de conta ou faz login novamente. Carregamento, falhas na leitura e um período sem registros salvos têm estados distintos. A opção Repetir repete a leitura que falhou; se o servidor solicitar uma espera, o horário da próxima tentativa é exibido. Uma atualização com falha mantém os últimos dados bem-sucedidos para o mesmo espaço de trabalho e os identifica com a hora da última atualização.
Cada conta conectada exibe separadamente o sinal de vida do coletor e o último evento recebido . O primeiro refere-se à atividade do coletor; o segundo, à última atualização do Telegram recebida. Uma fonte inativa pode manter o segundo valor inalterado enquanto o coletor continua em funcionamento. Abra o menu “status da coleta” para acessar os diagnósticos de conexão, captação, fonte e anexos.
Choose a task. Export my account downloads what the account can read now. Follow an investigation records new messages, observed edits and deletion notices from the chats you choose. While observation is paused, Chats, Journal and Sources show the setup card: connect the account, choose sources, start observation. With the goal Evidence for a case, or in the Witnessed, Case preparation, GitHub-verified or Maximum protection mode, starting observation first reads Telegram's session list (not while Strict: read only the chosen chats is on). If other sessions are signed in, the panel names their number and offers Start anyway or Open Sessions of this account. Other goals and modes start without that question. The goal question stays on this page until you answer or skip it. A new workspace opens the first setup instead.
Bate-papos#
Conversas salvas, em modo somente leitura por padrão.
As linhas do chat mostram o status da coleta, downloads de arquivos pendentes e com falha, carregamento inicial do histórico e restrições retornadas nos metadados da caixa de diálogo do Telegram. Um status de acesso perdido ou não confirmado não indica um bloqueio de conteúdo. Abra Filtros para selecionar esses status ou classificar pela fila de arquivos; a seleção permanece na URL quando a página é recarregada. O filtro Repetir localiza carregamentos iniciais de bate-papo em espera após um erro. Seu ícone mostra o tipo de erro e, durante a coleta, o horário da próxima tentativa. A página inicial resume quantos carregamentos precisam de outra tentativa. A coleta pausada mantém as tarefas até que seja retomada.
In Simple mode Home also shows Can be handed to a court: yes or no · missing: …. Yes means timestamps
are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root
certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does
not check the signing key: the recipient confirms its fingerprint, received separately, and runs verify.py with --tsa-ca and the authority's root certificate. A
Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here.
Os registros do diário com anexos preservados mostram o tipo, o nome e o tamanho em bytes observados. Os novos resultados de download também mantêm o tipo de mídia e a duração, quando o Telegram os fornece. Os registros assinados mais antigos permanecem inalterados; os metadados ausentes não são reconstruídos.
- Pesquise na lista por nome ou ID. Várias palavras podem ser combinadas em qualquer ordem, incluindo um
nome e parte de um ID juntos. O botão + abre as opções Adicionar um chat ou canal (adiciona ou remove
chats acompanhados), Abrir link do Telegram e Pseudo-secreto · Iniciar chat. A opção Abrir link do Telegram aceita um
nome de usuário ou link de convite e salva uma pré-visualização no diário; uma busca por um @nome de usuário ou link t.me sem
resultados oferece o mesmo recurso. Entrar/abrir e observar entra no chat e o adiciona às suas fontes;
abrir um bot envia o comando
/startpara ele. - As conversas pseudo-secretas aparecem na mesma lista, em verde com um cadeado, e são abertas no modo Pseudo-secreto. Quando a observação está desativada, a lista exibe Observação desativada com a opção Iniciar observação.
- Os filtros rápidos são abas dispostas em uma única linha: Todas, Pseudo-secretas, Prioridade, Alterações (edições salvas ou avisos de exclusão) e Precisa de atenção (acesso perdido ou não confirmado, mensagens não encontradas na nova verificação, mídia com falha, novas tentativas no histórico ou restrições do Telegram). As abas vazias ficam ocultas. As contagens respeitam o filtro de pesquisa e de tipo; um filtro rápido substitui o filtro de estado. Essas opções permanecem na URL para recargas e navegação com os botões Voltar/Avançar. Precisa de atenção não marca uma mensagem como excluída. Tipo, estado e classificação personalizada permanecem visíveis como blocos removíveis quando Filtros está recolhido.
- Listas grandes exibem 80 resultados por vez; a opção Mostrar mais exibe os próximos 80. O chat aberto e a linha em destaque permanecem disponíveis quando correspondem a um resultado, mesmo fora desse lote. O contador mostra o número de chats exibidos em relação ao total de resultados. A pesquisa abrange toda a lista, incluindo chats que ainda não foram exibidos.
- Na página de busca, ↓ leva ao primeiro resultado, ↑ ao último resultado exibido, e a tecla Enter abre o primeiro resultado correspondente. Dentro da lista, as teclas ↑/↓ e Home/End movem o foco; a tecla Enter abre a conversa em destaque. A tecla Escape retorna à página de busca, onde pressioná-la novamente limpa a consulta. A opção Limpar filtros reinicia a lista sem alterar a coleção ou a conversa aberta.
- O cabeçalho do chat conta as mensagens excluídas, texto mantido, excluídas antes do salvamento e não encontradas na nova verificação. Cada contagem é um botão que mostra só essas mensagens; clique de novo para mostrar todas. Excluído e Não encontrado na nova verificação em uma mensagem abrem uma nota com o horário e o que foi observado. A lista de chats e as notificações usam as mesmas definições. Uma mensagem excluída aparece em vermelho e mantém o texto salvo; uma mensagem editada mantém todas as versões salvas.
- A pesquisa de mensagens salvas analisa todo o histórico de bate-papo armazenado, incluindo versões de texto anteriores. Os filtros de mensagens excluídas, editadas, de mídia e por autor também abrangem todo o histórico de bate-papo armazenado. A mensagem Não encontrada na nova verificação é diferente dos avisos de exclusão recebidos. A pesquisa não solicita mensagens do Telegram; use Carregar histórico para obter mais. Uma correspondência em uma versão anterior abre as versões salvas com seus links de registro. A versão exibida identifica o registro usado para a mensagem e seu marcador; uma resposta do histórico posterior não pode substituir uma edição ao vivo mais recente na tela.
- Entre as mensagens, o chat mostra dois tipos de marcadores de lacuna. Números de mensagens não observados lista números sem registro no diário, apenas em canais e supergrupos: os outros chats compartilham uma numeração única da conta, então um salto ali não diz nada sobre o chat. Lacuna de cobertura marca um período entre uma interrupção registrada e a próxima retomada registrada, com o motivo quando o diário tiver um. Os marcadores aparecem com todas as mensagens visíveis e ficam ocultos enquanto um filtro de mensagens estiver ativo.
- Clicar em Gerar relatório acima das mensagens abre o Studio de Relatórios com esse bate-papo selecionado. O mesmo botão no cartão de identificação de um autor seleciona o bate-papo e esse autor. Ambas as opções alteram apenas o rascunho; salve-o antes de exportar.
- Ao clicar no nome de um autor, abre-se um cartão de pessoa ao lado das mensagens: perfil salvo, biografia, fotos de perfil, presentes, links, contagem de mensagens e a linha do tempo de atividades com seus registros do diário, além das opções Atualizar perfil e Gerar relatório. Clicar em Fechar, pressionar a tecla Esc ou abrir outro bate-papo fecha o cartão; o bate-papo mantém sua posição. O Ritmo no cartão conta as mensagens salvas do autor neste bate-papo em UTC: dias ativos, começa após 6 horas de silêncio, tempo médio para responder a outra pessoa em 24 horas, a série mais longa de mensagens consecutivas, a porcentagem de mensagens enviadas entre 00h00 e 06h00 e um mapa de calor por dia da semana × hora.
- Selecionar acima das mensagens ativa a seleção de mensagens: toque nas mensagens para marcá-las, com Shift para marcar um intervalo, ou use Selecionar exibido e depois Gerar relatório. O estúdio de relatórios abre com Mensagens selecionadas preenchido. O relatório abrange os registros dessas mensagens (observações, alterações, avisos de exclusão) que passam pelos demais filtros; um filtro de autor deixa de fora os avisos de exclusão, que não têm remetente. É possível selecionar até 1.000 mensagens; uma etiqueta no estúdio remove uma mensagem, e chats inteiros podem ser adicionados ao lado. Números de mensagem ausentes são informados apenas para chats selecionados por inteiro.
- O histórico de carregamento traz as últimas 100, 250 ou 500 mensagens para esta visualização e para o diário. Encontre-o em Ações do bate-papo, junto com as configurações de gravação, os controles de “somente leitura” e de ocultação de segredos. O menu é fechado com a tecla Escape ou com um clique fora dele. Carregar mensagens anteriores mantém a posição atual de leitura. Se a consulta ou a página mudar enquanto o Telegram responde, o carregamento concluído atualiza o diário salvo sem substituir a visualização mais recente. Um carregamento automático com falha oferece a opção Repetir. Para carregar todas as fontes ativadas, use Fontes → Histórico completo.
- A exportação do chat baixa todo o histórico visível como um
chat.jsonechat.html. Várias contas conectadas podem dividir o trabalho: cada uma baixa seu próprio intervalo de números de mensagens e assina sua parte, e a conta que inicia a exportação assina o arquivo. Veja como exportar um chat. - A seção “Pessoas” lista todos aqueles com mensagens salvas neste chat. Os perfis das pessoas estão desativados por padrão, pois se tratam de dados pessoais de terceiros. Quando estão ativados para um chat, um perfil mostra nome e histórico de nomes de usuário, sinalizadores do Telegram, hashes de avatares, atividade, quem responde a quem, outros chats observados e carteiras, telefones, nomes de usuário e links mencionados. Cada fato aponta para seu registro. A exportação de perfis salva um arquivo assinado, opcionalmente em uma senha ZIP; desativar os perfis exclui o arquivo de perfil. Veja os perfis das pessoas.
- A função “Reunir todos os autores na mesma aba” solicita ao Telegram o perfil, a biografia, as fotos de perfil, os presentes e os links da biografia de todas as pessoas com mensagens salvas no chat. Em um canal ou supergrupo, outras contas conectadas podem compartilhar o trabalho. Cada conta escolhida é reservada para a coleta, inclui pessoas inteiras e entra em contato com um autor por meio de uma das mensagens salvas desse autor. Uma conta ocupada com outra tarefa não é abordada e entra assim que estiver livre. Um autor que não puder ser contatado volta para a conta do próprio chat. O progresso mostra a porcentagem, o tempo restante e a participação de cada conta; a opção Pausar libera as contas. Cada registro salvo indica a conta que o leu, e o diário registra quando cada conta entrou e saiu.
- A opção “Salvar perfil” agora registra um instantâneo do perfil do chat ou do bot: descrição, membros, link de convite e comandos do bot.
Somente leitura, envio e segredos#
Dois botões acima das mensagens protegem a conta e o leitor:
- O modo “Somente leitura” fica ativado quando um chat é aberto. Desative-o para enviar mensagens ou clicar nos botões do bot . Cada ação exibe a pergunta “Enviar como @conta?” ou “Clicar neste botão do bot como @conta?”, informando que os participantes do chat verão a ação e que ela será registrada no diário assinado. A opção “Não perguntar novamente por 10 minutos neste chat” ignora a pergunta por um tempo. O envio fica desativado para a meta “Evidências para um caso”, no painel e na API.
- O “Mask secrets” oculta o que se parece com uma senha, um código de login, uma chave de API ou hash, um token de bot, uma string de sessão, uma chave privada, um JWT ou um número de cartão de pagamento (os números de cartão são verificados com a soma de Luhn). A opção “Show” revela um valor; a revelação é registrada no diário. O desativamento do mascaramento para este navegador também é registrado. Apenas a exibição muda: os registros originais e todas as exportações mantêm o texto completo.
Salvar as mensagens selecionadas como imagens#
Em um chat na nuvem, selecione Selecionar, marque as mensagens e, em seguida, selecione “Salvar como imagem”.
Para capturar um chat inteiro, selecione Salvar chat como imagens no menu de ferramentas do chat; ele
carrega até as últimas 2.000 mensagens salvas e informa quando as mais antigas são excluídas.
A visualização oferece os estilos Claro, Escuro e Clássico; use “Anterior” e “Próximo”
para capturas mais longas. O download do ZIP assinado salva cada página como PNG, juntamente com
pages.sig.json e README.txt (imagens assinadas do chat).
É possível selecionar até 50 mensagens, e todas elas devem ainda estar na janela do chat
carregada. O painel solicita que você reduza uma seleção muito grande, em vez de
excluir mensagens silenciosamente.
Cada página termina com um bloco de autenticidade: os números de registro do diário que ele exibe, o
bate-papo, o tempo de renderização, a impressão digital da chave do espaço de trabalho, o verify.py comando para essa
página e um código QR com o chat, a chave e o tempo de renderização. A assinatura requer a permissão de exportação
e adiciona um export.image_attested registro no diário.
A imagem inclui o texto salvo, o autor, o número da mensagem, a hora UTC, o número da resposta, os rótulos dos anexos e o status de edição/exclusão salvo. Ela utiliza o texto salvo mais recente com o número de versões mantidas; o conteúdo dos anexos, os botões embutidos, as reações e as versões anteriores do texto não são exibidos. Uma mensagem longa continua na próxima página com seu número de mensagem e contagem de partes. Cada página se identifica como renderizada a partir de mensagens salvas. O arquivo PNG é um trecho visual; use o arquivo e seu verificador ao entregar os registros assinados e os anexos.
A renderização ocorre no navegador sem a necessidade de enviar uma solicitação ao Telegram; para a assinatura, apenas o SHA-256 e os números de registro de cada página são enviados ao painel. O mascarador de informações confidenciais existente protege o texto, os nomes dos autores e os rótulos dos anexos. A visualização mantém um instantâneo até ser fechada e é apagada ao trancar o painel ou ao mudar de espaço de trabalho ou de bate-papo. A seleção do diário e do relatório assinados permanece inalterada. Consulte os relatos de casos para exportações completas dos relatórios.
Encaminhar mensagens#
Desative a opção Somente leitura no chat e, em seguida, selecione Encaminhar abaixo de uma mensagem, ou selecione e marque até 100 mensagens e escolha Encaminhar. Escolha o destino pelo nome: a lista inclui chats salvos e os chats do Telegram da conta nos quais é possível postar (grupos, chats privados, bots e canais que ela administra). O painel solicita confirmação e, em seguida, encaminha nativamente pelo Telegram com a frequência de mensagens da conta. A solicitação e seu resultado são registros assinados no diário, indicando o chat de origem, os números das mensagens e o destino. Cópias são salvas no destino somente quando esse chat é monitorado. Um chat que proíbe o encaminhamento retorna uma recusa e nada é enviado.
Encaminhar uma conversa para um canal ou grupo#
O administrador principal pode abrir um bate-papo na nuvem salvo e selecionar Encaminhar bate-papo no menu de ferramentas. Escolha Novo canal, Novo grupo ou Canal ou grupo existente. Os novos destinos são privados. Para um destino existente, a opção Escolher um bate-papo exibe os grupos da conta e os canais que ela administra; pesquise por nome. O destino deve permitir que esta conta publique. Destinos de fóruns não são suportados.
Interrompa a observação ou outra tarefa ativa da conta e habilite as ações do Telegram antes de visualizar a pré-visualização. Contas somente para leitura e o objetivo Provas para um caso bloqueiam as transferências. A pré-visualização lê o limite do histórico acessível do Telegram e verifica o destino. Ela não cria um destino nem envia mensagens. A opção Iniciar dá início à transferência; a pré-visualização expira após dez minutos. É possível ter apenas uma transferência ativa por espaço de trabalho.
A transferência lê o histórico do Telegram da mais antiga para a mais recente, até a última mensagem exibida na visualização. Ela não se limita às mensagens já salvas no TgWitness. As mensagens que chegam além desse limite são excluídas. O encaminhamento nativo preserva a atribuição de autoria e as mídias disponíveis no Telegram sem baixar e enviar cópias. Os álbuns dentro desse limite permanecem juntos. As notificações são silenciosas. Respostas, estrutura de tópicos, reações, edições e mensagens excluídas ou inacessíveis não são reconstruídas. As conversas secretas estão fora desse fluxo de trabalho. A proteção de conteúdo e as restrições de publicação do Telegram permanecem em vigor.
O painel exibe envios confirmados, omissões, o status e o horário da próxima tentativa permitida. Mensagens de serviço e mensagens protegidas individualmente são ignoradas com um motivo registrado. O espaçamento entre mensagens da conta e os limites por hora se aplicam a todas as mensagens; um álbum aguarda até que seus intervalos reservados cheguem ao prazo. As pausas do FloodWait e do modo lento atualizam o backoff RPC compartilhado da conta. Os padrões de ritmo existentes da conta permanecem inalterados.
A opção Pausar interrompe o processo entre as solicitações; a opção Cancelar interrompe o trabalho restante sem remover as mensagens já enviadas nem excluir um destino criado. Uma solicitação em andamento pode ser concluída antes que qualquer uma dessas ações entre em vigor. Fechar a caixa de diálogo não cancela um trabalho. Após a reinicialização de um processo, os trabalhos não concluídos exigem um Retomar explícito. Uma resposta de envio perdida ou incompleta pausa o trabalho para revisão: verifique o destino antes de retomar. Uma nova tentativa mantém os IDs aleatórios do Telegram armazenados e as contagens confirmadas; isso não é garantia de deduplicação indefinida pelo Telegram. Um resultado de criação desconhecido não pode ser retomado automaticamente: verifique o Telegram e cancele o trabalho antigo antes de iniciar uma nova transferência para o destino que foi criado, se houver.
Se o salvamento de uma tarefa ou de seu registro no diário falhar, o trabalhador restaura o último estado salvo e libera a conta. Um envio ou uma criação que já possa ter chegado ao Telegram permanece marcado para revisão. Repita uma inicialização com falha ou retome a tarefa assim que o armazenamento estiver disponível novamente; o progresso confirmado só avança com o respectivo registro no diário.
Assinado interaction.forward.* Os lançamentos contábeis registram o limite, o destino,
os IDs confirmados das mensagens de origem/destino e as omissões. Eles documentam a transferência;
não substituem as observações e exportações assinadas originais.
Registro#
Todos os registros que o espaço de trabalho assinou, com os mais recentes em primeiro lugar.
- A visão geral contabiliza as mensagens observadas, as edições registradas, os avisos de exclusão e as fontes selecionadas.
- Linha do tempo de eventos filtra por tipo de evento (todos, edições, exclusões, reações, participação, cobertura), por texto e por fonte. Carregar eventos anteriores volta à página anterior.
- Abra um registro para ver seus detalhes, hash e carga útil. O link para este registro é um endereço que abre o mesmo registro. Eventuais segredos são ocultados nesta visualização; as exportações mantêm o original.
- O diário é do tipo “somente adição”: nada no painel edita ou exclui um registro. Verifique isso
em Exportações → Verificar diário ou
python -m tgwitness.verify; consulte exportar e verificar.
Fontes#
Quais conversas esse espaço de trabalho registra e o que ele mantém delas. As alterações se aplicam às atividades futuras; os registros salvos permanecem.
A função “Atualizar lista de bate-papos” lê os bate-papos e as pastas da conta. Ela não baixa mensagens.
Escopo#
- O que esta conta registra : Conversas selecionadas (apenas os chats que você adicionar), Pasta do Telegram (uma das pastas da conta, incluindo chats adicionados a ela posteriormente) ou Conta completa (todos os chats, além de cada novo chat, grupo, chat privado ou bot assim que aparecerem). Modo de investigação é para uma conta dedicada: ela registra tudo o que a conta visualiza, suas próprias mensagens e cliques nos botões, e salva imediatamente o perfil de cada novo chat e as mensagens visíveis anteriores. A imagem guia dedicado à conta explica por que nunca se deve usar sua conta principal.
- Rigoroso: ler apenas os chats selecionados (Apenas chats selecionados, desativado por padrão) interrompe a leitura das notificações de serviço do Telegram; a lista de sessões e as mensagens anteriores de um chat que estiverem ativadas; mantém inalterada a configuração de conteúdo confidencial e ignora as atualizações relativas a chamadas telefônicas. Consulte chats selecionados rigorosos.
- Os tipos de fonte limitam os modos de pasta e de conta inteira a canais, grupos, conversas privadas e bots. “Ações próprias” adiciona as mensagens, edições e digitações no teclado de resposta da própria conta.
- Quando um novo chat ou bot aparece: salve seu perfil e até o número escolhido de suas últimas mensagens visíveis.
- Bate-papos selecionados está marcado como recomendado. A opção Descartar alterações retorna o formulário ao escopo salvo até que você clique em Salvar escopo.
O Pseudo-secret é a interface do Chat Secreto integrada, ativada por conta após a instalação do módulo de protocolo com um único clique. A observação na nuvem e o histórico utilizam suas próprias configurações. Nada é registrado enquanto o TgWitness não estiver em execução; após uma reinicialização, ele captura apenas o que o Telegram ainda retorna, e o relatório mostra a lacuna. Bate-papos além do limite da lista de bate-papos (1.000 diálogos, a menos que alterado em Parâmetros) são adicionados assim que se tornarem ativos. Botões do bot embutidos pressionados em outro aplicativo ficam invisíveis; a resposta do bot é registrada.
Bate-papos abrangidos#
Filtre por status (Ativado, Pausado, Prioridade, Excluído, Acesso não confirmado, Ignorado) e tipo; em seguida, execute uma ação na seleção: ativar, pausar, marcar ou remover prioridade, excluir do escopo ou remover. O ícone de status mostra apenas o estado; as ações estão no menu de cada linha, com uma descrição do que elas fazem. A pausa e a exclusão solicitam confirmação, inclusive em lote. A remoção de uma fonte solicita seu nome e exclui os perfis das pessoas relacionadas; seus registros salvos permanecem no diário.
Uma fonte que não aparece na lista de bate-papos da conta é recebendo atualizações, fora da lista de bate-papos, enquanto os registros continuam chegando; caso contrário, acesso não confirmado. Conversas disponíveis adiciona bate-papos com Adicionar selecionados ou Adicionar todos os resultados.
Histórico completo#
Carrega o histórico disponível de todas as fontes ativadas nas conversas e no diário. O progresso é mantido após uma reinicialização; os anexos seguem suas configurações de mídia. Veja o histórico da fonte.
Gravação#
- Escolha quais alterações preservar: novas mensagens, edições, avisos de exclusão, reações visíveis, entradas e saídas. Uma predefinição altera o formulário; a opção “Salvar configurações de registro” a aplica. Reativar uma categoria não recupera eventos perdidos.
- Preserve a mídia quando disponível: baixe anexos com tamanho máximo por arquivo, defina por tipo de 1 a 2.000 MiB e limite a duração do vídeo em segundos (0 significa sem limite). Cada tentativa de download tem seu resultado registrado.
- Recheck: verifica os chats prioritários a cada poucos minutos, os demais chats raramente, para que a conta fique dentro dos limites do FloodWait do Telegram. O valor 0 desativa um grupo. Marque os chats prioritários com a estrela na lista; o número de chats por rodada e a pausa entre os chats estão em Parâmetros. Consulte a coleção.
- A barra de salvamento indica se essas configurações correspondem às recomendadas. A opção Voltar às recomendadas preenche os valores recomendados; a opção Salvar configurações de gravação as aplica e a opção Descartar alterações restaura as configurações salvas.
Exportações#
A seção “Downloads” prepara os arquivos; o “Relatório de compilação” define a aparência dos relatórios.
| O que | Use-o para | Guia |
|---|---|---|
| Exportação de contas | Um instantâneo atualizado do que a conta pode ler agora | Exportação de contas |
| Compartilhamento de cópia | Uma versão simplificada de uma exportação de conta concluída | Divulgação |
| Assinado ZIP | Diário, relatório, anexos e ferramentas de verificação dentro de um limite fixo do diário | Exportar e verificar |
| Relatório em HTML, PDF e JSON | Um relatório selado e legível | Relatórios de casos |
| JSONL, CSV | Registros originais com assinaturas; uma planilha com fórmulas protegidas | Exportar e verificar |
| Trecho da transferência | Apenas os chats, o período e as pessoas de que o destinatário precisa | Evidências |
| Exportação de bate-papo | Um chat assinado chat.json e chat.html |
Exportar um chat |
- Criptografar os downloads acima com uma senha (12 caracteres ou mais) salva um arquivo AES-256 ZIP que o 7-Zip ou o WinRAR abrem. O arquivo assinado dentro dele permanece inalterado. A senha não é armazenada.
- Quando a chave de sessão deste espaço de trabalho foi importada, as caixas de diálogo de exportação de conta e de bate-papo informam isso em uma linha: cópias dessa chave podem existir fora da lista de sessões do Telegram. A mesma linha oferece a opção Criar uma autorização independente, que abre a página de login com essa opção selecionada. Consulte contas.
- Uma exportação de bate-papo que falhe ou seja cancelada mantém o intervalo que foi salvo. A opção Capturar ou exportar um bate-papo oferece então as opções Retomar exportação e Recomeçar; consulte exportar um bate-papo.
- Enquanto a opção de exportação do chat exibe Baixar as mensagens lidas até agora, ela salva um arquivo ZIP cujas páginas são assinadas à medida que são gravadas; a linha abaixo conta o número de mensagens assinadas.
- As exportações preparadas mantêm até 20 arquivos com tamanho total de até 2 GiB, além do mais recente, para downloads repetidos, cada um com seu SHA-256 para que o destinatário possa comparar. Cada cartão indica o conteúdo do arquivo: Arquivo assinado (diário completo e sua contagem de registros), Relatório, Registros do diário ou Extrato de transferência , o título e o ID do caso, e a seleção de relatório com a qual foi criado (conversas, mensagens selecionadas, datas). A opção Mostrar restringe a lista a um único tipo quando há mais de um.
- Quando o navegador recusa a caixa de diálogo de salvamento, o painel recorre a um download comum.
- Sua identidade de assinatura exibe a impressão digital da chave. As opções “Salvar ponto de verificação” e “Baixar recibo de execução assinado” fornecem registros para serem mantidos fora do coletor. A opção “Preparar solicitação de carimbo de data/hora” cria uma solicitação RFC 3161 sem entrar em contato com nenhum serviço.
Configurações, contas e conexão#
- Configurações: objetivo, conexão, o que registrar e a interface. Consulte a primeira configuração e as definições.
- Contas: cada espaço de trabalho com seu estado, fontes, eventos e fila de anexos. Filtre por “Precisa de atenção”, “Em coleta”, “Offline” ou “Pausado” ou “Não conectado”, pause ou retome uma seleção, importe arquivos de contas em massa e gerencie grupos. Consulte contas.
- Conta: login e a rota de conexão desta conta. Direta, um perfil do WireGuard , seu próprio proxy, o pool público do MTProto ou o WARP; prepare e verifique uma rota, em seguida, aplique-a a esta conta, a um grupo ou a todas as contas. Consulte conexão e proxies e proxies. Segurança da conta → Sessões desta conta lista as sessões do Telegram, encerra uma ou todas elas e — para uma chave criada neste espaço de trabalho — oferece a opção Tornar esta a única sessão quando o Telegram permitir, o que repete essa ação após as 24 horas exigidas pelo Telegram e exibe a senha de duas etapas definida uma única vez. Consulte segurança da conta. Segurança da conta → Teste de testemunha usa um segundo espaço de trabalho para verificar se esta sessão recebe atualizações em tempo real; consulte teste de testemunha.
A pausa e a retomada em massa mantêm a seleção confirmada dentro da sessão em que foi aberta. Os controles permanecem desativados enquanto a confirmação ou a execução estiverem pendentes; a troca de áreas de trabalho ou o bloqueio do painel cancela os comandos restantes. Após a execução, o painel atualiza os estados das contas. Uma solicitação com falha é relatada como uma falha na solicitação, pois o servidor pode já ter aplicado o comando. Os comandos não são repetidos automaticamente.
Extras#
Opcional: basta uma conta e algumas fontes para começar a coletar. Apenas a opção que você escolher abre suas configurações, e nada é conectado automaticamente. O cartão “Nível de proteção”, na parte superior, mostra o modo de proteção.
| Cartão | O que ela oferece | Guia |
|---|---|---|
| Armazenamento e espaço em disco | Backups, transferência de arquivos mais antigos para sua nuvem, uma cópia de evidência que não pode ser excluída | Armazenamento |
| Objetivo e nível de proteção | Configurações sugeridas para sua meta e duas escalas | abaixo |
| Notificações | Problemas, mensagens alteradas e um resumo diário; seu próprio bot de controle | abaixo |
| Evidências e backups | Registros de data e hora, mais testemunhas e uma cópia criptografada armazenada externamente | abaixo |
| Servidor 24 horas por dia, 7 dias por semana | Um servidor na nuvem sem SSH, criado e excluído a partir do painel | Alta segurança |
| Testemunha independente | Verificações assinadas publicadas no seu canal do Telegram ou no Discord | Testemunha |
| Verificação de código | Compara o programa em execução com um commit público no GitHub | abaixo |
Objetivo e nível de proteção#
Quatro perguntas:
- Para que serve? Um registro pessoal, uma investigação ou provas para um caso.
- O que você pretende monitorar? Algumas conversas (até cerca de 50), muitas conversas (até cerca de 500) ou contas inteiras. Isso define o limite da lista de conversas para 1.000, 3.000 ou 20.000.
- Fotos e arquivos? Apenas texto, fotos e mídias curtas (fotos de até 20 MB, vídeos de até 100 MB) ou tudo (vídeos e documentos de até 1 GB cada). A opção “Tudo” com contas completas também mantém 4 GiB de espaço livre em disco.
- Onde ela será executada? Neste computador ou em um servidor que fica sempre ligado.
A sugestão lista carimbos de data/hora independentes, drand e a lista de dispositivos do Telegram, cada um
com uma linha explicando o que ele acrescenta. Os carimbos de data/hora são gerados a cada 60, 30 ou 10 minutos para um registro pessoal
, uma investigação ou prova; o drand e a lista de dispositivos precisam de carimbos de data/hora.
Aplique alterações apenas a esses itens, à política de anexos e aos dois parâmetros acima. Cada
alteração é um registro no diário, além de setup.applied. Notificações, uma cópia externa, um
servidor, DNS de gateway, a verificação de código e uma testemunha são oferecidos como próximas etapas com seus
próprios formulários.
Duas escalas são calculadas com base no que está definido, e não na meta:
| Escala | Pontos |
|---|---|
| Credibilidade | Diário assinado 1, carimbos de data/hora 3, drand 1, lista de dispositivos 1, verificação de código que corresponde a 1, sondagem de testemunhas 1, servidor atestado 2, log de DNS do Gateway 1 |
| Confiabilidade | Servidor sempre ativo 3, cópia externa 3, Object Lock 1, notificações de problemas 1 |
80% ou mais de leituras no máximo, 50% alto, 25% moderado, abaixo disso é básico. Atualmente, a confiabilidade leva em conta um servidor sempre ativo, conforme a resposta à pergunta 4, antes que qualquer servidor seja verificado.
Notificações#
As notificações são enviadas pelo Apprise para o Telegram, Discord, Slack, ntfy, e-mail, Matrix e mais de 100 outros serviços. Escolha um serviço, preencha um ou dois campos e envie um teste, ou cole os endereços do Apprise diretamente.
- Problemas: disco quase cheio, conta desconectada, erros de coleta, cópia ou registro de data e hora , uma nova sessão conectada à conta com as listas do Telegram de dispositivos, aplicativos e países, um código de login ou novo acesso que o Telegram relata durante a observação, e outra sessão após a opção Tornar esta a única sessão. Em um servidor selado, uma porta SSH aberta ou um login também constituem um problema.
- Alterações: mensagens excluídas, editadas e ausentes nos chats observados, agrupadas em uma notificação por verificação (a cada minuto, a menos que alterado em Parâmetros).
- Tarefas concluídas: histórico, exportações e cópias de armazenamento.
- Resultados da lista de observação: correspondências de listas de observação configuradas para enviar um alerta.
- Resumo diário na hora escolhida, de acordo com o horário do servidor.
As notificações exibem nomes de chats e contagens. Trechos de mensagens estão desativados por padrão; quando estão ativados, o texto das mensagens sai deste computador.
Seu bot operador é um bot criado por você mesmo no @BotFather que responde /status e
/stats, e, opcionalmente, /pause, /resume e /copy. Apenas o chat listado e os
IDs de usuário do Telegram podem usá-lo; o texto da conversa permanece no espaço de trabalho. Use um
bot separado se outro aplicativo já receber seus comandos. Consulte
notificações e bot operador.
Evidências e backups#
- Carimbos de data/hora independentes enviam apenas o SHA-256 de cada ponto de verificação assinado para as autoridades da RFC 3161 e para os calendários do OpenTimestamps, a cada 5 a 1,440 minutos. Um destinatário precisa dessa data/hora de terceiros como requisito mínimo para servir de evidência. O Anchor agora executa uma passagem. Consulte os carimbos de data/hora.
- Mais testemunhas, cada uma desativada até ser selecionada: a rodada mais recente do drand, a lista do Telegram de dispositivos conectados sem endereços IP e o log do Cloudflare Gateway das consultas DNS do servidor. Veja os registros opcionais.
- O backup criptografado copia o diário, os arquivos, os pontos de verificação e as exportações de bate-papos para um armazenamento compatível com S3 (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Tudo é criptografado primeiro nesta máquina. Baixe a chave de criptografia e mantenha-a em local separado: sem ela, a cópia não pode ser lida. O Object Lock no modo Governança ou Conformidade impede que os objetos sejam excluídos por um número definido de dias. Consulte a cópia externa.
Verificação de código#
Verifica se o programa instalado corresponde a uma versão publicada.
- Insira um repositório do GitHub (o oficial já está preenchido) e uma tag, um branch ou um commit.
- O `Check now` consulta a API do GitHub, por meio da rota deste espaço de trabalho para solicitações externas, para obter a lista de arquivos desse commit. Ele compara o ID do blob do Git de cada arquivo de programa avaliado com o commit. Uma cópia do Windows com finais de linha convertidos ainda é compatível.
- O resultado lista arquivos alterados, adicionais e ausentes (até 50 de cada) e é salvo como
um
source.checkedregistro de diário.
O resultado é considerado atual apenas enquanto os arquivos do programa em execução permanecerem inalterados: verifique novamente após uma atualização. Não é necessário nenhum token e apenas repositórios públicos funcionam; chats e credenciais não são enviados. Uma correspondência identifica o código no disco. Não se trata de atestado de hardware; para isso, consulte o Phala Cloud.
Modos de proteção#
O seletor ao lado do número da versão mostra o modo escolhido e quantas das 18
camadas de proteção estão ativas, por exemplo 🟠 Witnessed 9/18. Para alterar o modo em
Extras → Nível de proteção, abra o menu de opções. Cada modo descreve um alvo e lista o que
ainda está faltando; o registro, a assinatura e as configurações salvas são os mesmos em todos os modos.
| Modo | Para | Adiciona |
|---|---|---|
| 🟢 Fácil | Acompanhar um chat e manter uma cópia | Bate-papos, o diário e as exportações de bate-papos; a assinatura ocorre em segundo plano |
| 🟡 Assinado | Envia relatórios para uma plataforma, um provedor de hospedagem ou uma central de denúncias | Arquivo assinado, verificação de diário, pontos de verificação, extrato de transferência |
| 🟠 Testemunhado | Casos em que alguém pode alegar que o registro foi alterado | Uma testemunha independente que publica cabeçalhos de diário assinados |
| 🔴 Pronto para uso em tribunal | Provas para um advogado, a polícia ou um tribunal | Carimbos de data e hora, uma cópia criptografada armazenada externamente, detalhes do caso em relatórios |
| 🟣 Verificado pelo GitHub | Registros cujo software qualquer pessoa deve poder verificar | Verificação de código e captura do GitHub Actions |
| ⚫ Máximo | Casos de alto risco contra um adversário com recursos financeiros consideráveis | Um servidor seguro 24 horas por dia, 7 dias por semana, um endereço IP oculto e todas as 18 camadas |
As camadas: cada registro assinado e encadeado; um recibo de execução assinado; anexos salvos com SHA-256; pontos de verificação assinados; novas verificações; alertas de problemas; acesso de testemunha somente para leitura; uma testemunha realizando verificações conforme o cronograma; carimbos de data/hora RFC 3161; provas OpenTimestamps; um carimbo de data/hora mais recente verificado; uma cópia criptografada fora do local; detalhes do caso em relatórios; uma verificação de correspondência de código ; o Telegram nunca vê o IP desta máquina; solicitações externas por meio de um proxy; Object Lock na cópia; um servidor selado com registros do provedor. Uma camada desativada possui a opção “Configurar”, que abre seu formulário. Escolher um modo inferior solicita confirmação e não exclui nada.
Mais ferramentas#
Extras → Captura independente: conecte um navegador separado ou um gravador AyuGram, fixe sua chave de assinatura, selecione as opções de captura, inicie/pausar, tire capturas de tela e baixe arquivos assinados e verificados. Cada gravador possui seu próprio login manual, rota, registro e chave. Ambas as conexões vêm desativadas inicialmente. Consulte o guia de captura independente em inglês.
- Consulte o arquivo: pesquise observações salvas, analise as fontes e, em seguida, decida se deseja enviá-las a um modelo de IA. Veja a análise do arquivo e o OCR e a transcrição locais.
- Parâmetros: limites e ritmo de coleta, novas verificações, downloads, perfis, notificações e exportações. Pesquise por nome, exiba os valores de Apenas alterados e prepare as configurações padrão como um rascunho com Restaurar padrões…. Salvar parâmetros aplica os valores a partir do próximo uso, e cada alteração é um registro no diário.
- Acesso: tokens separados para revisores, analistas e operadores, limitados a determinados espaços de trabalho, chats e permissões. Consulte a seção de acesso.
- Log do sistema : o que este processo fez desde que foi iniciado (conexões, alterações de proxy, logins, recusas, alterações de configurações) com os endereços IP ocultos. A opção “Seguir novas linhas” mantém a linha mais recente em exibição. As mensagens permanecem apenas no diário.
- Integrações: o provedor de IA, conexões MCP somente leitura e webhooks assinados.
- Case Board: notas privadas da equipe, favoritos e trechos ao lado das evidências. Veja Case Board.
- Documentação: a aba do modo de investigação. Enquanto uma sessão documentada está sendo gravada, ela é movida para a barra lateral principal.
- Capturas do GitHub Actions em “Exports”: um chat capturado do seu fork. Veja captura selada.