TgWitness / Documentação

O que foi testado →

Referência / Configuração

Telegram · Primeira configuração e ajustes

O assistente de configuração, as metas, os níveis de interface, as rotas de conexão e as configurações compartilhadas por um grupo de contas.

TgWitness / Documentação · Introdução

Introdução

Contas · Conexão · Acesso

Uma nova área de trabalho é aberta /first-run. A primeira tela pergunta o que o(a) senhor(a) deseja fazer: Apenas baixar, Acompanhar conversas ou Provas para um caso. A escolha define o objetivo e o nível da interface: Simples para “Apenas baixar”, Padrão para as outras duas opções. O nível determina quantos campos cada formulário exibe; todas as páginas permanecem no menu. Mais opções na mesma tela definem explicitamente o nível, o tema e o fuso horário; a lista de idiomas está no cabeçalho do assistente. As telas seguintes abordam a conexão, o Telegram e os chats. As rotas de conexão permanecem ocultas enquanto a verificação automática está em andamento e se abrem quando ela falha. Uma barra de progresso de cinco etapas retorna às etapas concluídas. Cada resposta é salva no servidor assim que é alterada; portanto, ao recarregar a página, a mesma etapa é retomada. A última tela lista as respostas e permite que o usuário retorne a qualquer uma delas.

O idioma, o fuso horário da IANA, o tema e o nível são armazenados por operador e por espaço de trabalho. Os padrões são o idioma do navegador, o fuso horário do dispositivo, o tema do sistema e a interface simples. A alteração do idioma mantém a sessão do painel. Os horários no diário assinado nunca mudam.

/settings edita os mesmos registros que o assistente. A pesquisa abrange os campos principais, os parâmetros e os formulários estendidos; um campo oculto pode ser aberto sem mudar o nível. Os níveis mudam apenas o que é exibido: o servidor verifica as permissões por conta própria. Uma seção cujas configurações estão todas acima do nível escolhido as exibe mesmo assim. As configurações de coleta e a primeira conexão cabem ao administrador do espaço de trabalho.

A página de configurações é uma lista. O cartão da conta, no topo, abre Conta do Telegram. Abaixo, cada linha nomeia uma seção e o valor em uso: Quais chats? e Conexão em Conta; Objetivo, Gravação e arquivos, Proteção do registro e Notificações e cópia externa em Gravação; Idioma, horário e aparência em Painel; e as páginas avançadas em Mais ferramentas. Ao lado da lista, um cartão informa se os valores recomendados estão ativos, com os valores principais e Desfazer a última alteração, e Alterações recentes lista as últimas edições.

Uma seção é aberta em uma janela sobre a lista e possui seu próprio endereço, como /settings/connection. A seta para trás, o botão Fechar, a tecla Escape, um clique fora da janela e o botão Voltar do navegador levam de volta à lista. A opção Quais bate-papos? é mantida com Salvar seleção de bate-papos; ao fechar com alterações não salvas, o sistema pergunta primeiro. O salvamento mantém os tipos de fonte, bate-papos excluídos, ações próprias e configurações de novo bate-papo de Mais ferramentas → Fontes → Escopo; um bate-papo escolhido aqui é removido da lista de bate-papos excluídos e registrado como uma fonte selecionada manualmente. Cada alteração exibe Desfazer por 20 segundos, e cada entrada em Alterações recentes pode ser desfeita posteriormente. Um “desfazer” restaura apenas as configurações que essa entrada alterou, incluindo limites personalizados de arquivos. Quando uma alteração posterior afeta as mesmas configurações, o “desfazer” é recusado e nada muda. Um “desfazer” é um novo registro settings.changed no diário.

Nível Campos Barra lateral
Simples Apenas o essencial Página inicial, Bate-papos, Diário, Exportações, Contas e Configurações
Padrão Configurações comuns com explicações Adiciona Painel de Casos, Fontes, Acesso e Documentação em Mais ferramentas
Especialista Todos os campos, limites e detalhes técnicos Além disso, adiciona Mapa do sistema, Topologia de rede, Extras, Pergunte ao arquivo, Parâmetros, Conta, Log do sistema e Integrações na seção Mais ferramentas

Os nomes das seções permanecem os mesmos em todos os níveis. Abra Aparência na parte inferior da barra lateral para alterar o nível. O guia do painel descreve cada seção.

Objetivos#

Objetivo Coleção Arquivos Serviços externos Endereço do servidor
Só baixar A exportação única é iniciada a partir da tela de configuração final; a coleta contínua permanece desativada Fotos de até 20 MB Registros de data e hora Automático
Acompanhar conversas Contínuo Fotos e vídeos de até 60 segundos / 20 MB Registros de data e hora e notificações de problemas Automático
Provas para um caso Contínuo Todos os arquivos de até 1 GB Carimbos de data/hora, drand, notificações Não, ocultar

Recomenda-se a cópia externa, o bot testemunha e a verificação de código como evidências. Os endereços de armazenamento e notificação precisam primeiro de um destino. Um recurso que se comunica com um serviço externo solicita permissão para enviar solicitações fora do Telegram; desativá-lo oferece a opção de desativar, junto com ele, os carimbos de data e hora, as notificações e a cópia externa.

Alterar a meta mostra a diferença em primeiro lugar, e as alterações manuais podem ser mantidas. Um campo que difere da meta é marcado como “Alterado por você” e pode ser restaurado. A revisão das configurações impede que uma diferença revisada seja aplicada sobre uma alteração feita em outra aba.

Conexão#

Até que uma rota seja escolhida aqui, uma nova área de trabalho utiliza o MTProxy Automático · listas públicas com a opção Ocultar o endereço (segurança da conexão). A opção Automático abaixo é uma etapa de configuração separada.

O Automatic tenta primeiro o WARP, depois os servidores públicos do MTProxy e, por fim, uma conexão direta, sendo que esta última só é utilizada quando o endereço do servidor puder ser exibido. O Automatic e o WARP podem instalar componentes com verificação de hash e registrar o servidor no Cloudflare; sem esse consentimento, o Automatic ignora o WARP. O WARP utiliza o gerenciador wgcf/wireproxy existente e uma porta SOCKS5 local; a tabela de roteamento do sistema não é alterada.

A importação em massa solicita a rota antes que qualquer sessão chegue ao Telegram: WARP (padrão), MTProxy público ou direta. A verificação da sessão usa o mesmo tipo de rota, e cada conta importada recebe seu próprio túnel WARP antes do primeiro login.

Seu próprio proxy aceita tg://proxy, socks5://, http:// e https://. O certificado de um proxy HTTPS é verificado antes que as credenciais sejam enviadas a ele.

Uma verificação de conexão é válida por cinco minutos e está vinculada à rota, à política e às respostas do assistente; alterar qualquer um desses itens exige uma nova verificação. A opção “Continuar sem verificar” está disponível e não substitui o login no Telegram. A rota escolhida é verificada novamente em segundo plano, e o recurso “Automático” executa sua cadeia novamente após uma perda de conexão. Quando nenhum proxy público responde, a contagem fica em vermelho com as ações WARP e reverificação.

Grupos de contas#

As contas de um grupo compartilham suas configurações. Abra Contas → Grupos e configurações compartilhadas → Configurações compartilhadas ou Configurações do grupo na página de configurações de uma conta.

O grupo compartilha a meta, arquivos salvos, registros de data e hora, drand, notificações de problemas, cópia externa, solicitações fora do Telegram, modo IP, o que registrar, a programação de reverificação, regras de notificação, configurações de relatório, parâmetros e a rota de conexão. Os destinos de notificação, as credenciais de proxy e o login permanecem por conta, assim como o início e a pausa da coleta.

  • Todos os membros seguem o grupo. Em “Configurações”, marque um valor 🔗 do grupo ou ✏️ um valor próprio; a opção “Retornar ao valor do grupo” o restabelece.
  • Uma alteração lista as contas afetadas (aplica-se a 2 das 3 contas) e solicita confirmação por conta antes de substituir um valor próprio. As contas desmarcadas mantêm seus valores.
  • Um parâmetro que o grupo não compartilha permanece como “Não compartilhado”: cada conta mantém seu próprio valor até que você pressione “Compartilhar este valor”.
  • Ao copiar as configurações de uma conta, os valores da conta escolhida passam a ser os do grupo.
  • Quando uma conta é movida para um grupo, é perguntado: “Adotar os valores do grupo?”. Caso contrário, ela mantém seus próprios valores, marcados com ✏️. As contas adicionadas posteriormente começam com os valores do grupo.
  • Uma conta de observação mantém seu modo de IP até ser pausada.

Cada alteração é registrada no diário assinado do espaço de trabalho principal e de cada membro ao qual ela chega. A exclusão de um grupo mantém suas contas e seus valores atuais.

A página do grupo /groups/<id> mostra os membros, o que precisa de atenção e os chats que várias contas visualizam. Veja grupos de contas.

Espaços de trabalho existentes#

Uma área de trabalho com uma sessão ou uma configuração concluída anteriormente não exibe o assistente. Seus valores não são substituídos por uma meta quando a página é carregada. Ocultar um campo não desativa o recurso nem exclui seu valor. Abrir a primeira configuração em “Configurações” exibe as mesmas telas novamente; concluí-las não inicia nenhuma nova exportação ou observação e isso é informado, e uma seleção de bate-papo alterada só é mantida ao clicar em Salvar seleção de bate-papo.

A estimativa de tamanho e tempo considera até três conversas selecionadas e até 20 mensagens de cada uma. Trata-se de uma estimativa: ela não prevê os limites do Telegram, a velocidade de um determinado servidor nem os arquivos presentes em cada conversa.