# Telegram · Recursos e escopo

Canonical page: https://phishdestroy.io/tgwitness/pt/docs/reference/features/

O modelo atual de coleta, fluxos de trabalho com múltiplas contas, exportações e limites operacionais do TgWitness.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/pt/llms.txt)

O modelo atual de coleta, fluxos de trabalho com múltiplas contas, exportações e limites operacionais do TgWitness.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentação](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Referência do projeto](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Referência do projeto](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561)

O TgWitness preserva conversas do Telegram acessíveis às contas conectadas, registra alterações observadas e prepara exportações verificáveis. Esta referência descreve o modelo de coleta, os fluxos de trabalho atuais e seus limites.

**Nesta página**

- [Aplicativo independente](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#standalone-application)
- [Investigações compartilhadas](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#shared-investigations)
- [Ferramentas de arquivamento](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#archive-tools)
- [Extras opcionais](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#optional-extras)
- [Protocolo e fontes privadas](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#protocol-and-private-sources)
- [Várias contas](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#multiple-accounts)
- [Captura e atribuição](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#capture-and-attribution)
- [Capacidade e limites do Telegram](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#capacity-and-telegram-limits)
- [Confiabilidade e recuperação](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#reliability-and-recovery)
- [Modelo de evidências](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#evidence-model)
- [Exportação, implantação e transferência](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#export-deployment-and-handoff)
- [Critérios de lançamento estável](https://phishdestroy.io/tgwitness/pt/docs/reference/features/#stable-release-criteria)

## Aplicativo independente

O TgWitness possui instalação, diretório de dados e ciclo de vida de versões próprios. A interface web integrada cuida da configuração e da revisão; os registros exportados podem ser utilizados de forma independente.

O operador conecta suas contas, escolhe as fontes visíveis para cada uma delas e obtém um registro de observações salvo. O painel exibe o conteúdo, as alterações salvas, a proveniência das observações e as lacunas conhecidas. Outro investigador pode verificar o material exportado.

O painel distingue entre autorização da conta, acesso a uma fonte, atividade do coletor e cobertura registrada. Analise esses estados em conjunto ao avaliar um intervalo com poucas mensagens ou um problema de conexão.

## Investigações compartilhadas

Um administrador pode emitir [tokens de acesso](https://phishdestroy.io/tgwitness/pt/docs/reference/access/) restritos a espaços de trabalho e chats individuais, com permissões por ação, restrições de IP, validade, limites de login e controle de sessão. Um revisor com acesso somente leitura pode inspecionar um caso sem receber a autorização do Telegram ou a chave do painel principal. O acesso restrito ao chat permanece separado das configurações gerais da conta e das exportações completas do diário.

O MTProxy automático mantém rotas funcionais do Telegram a partir de quatro fontes públicas ou de um catálogo de operadores. [Os modos de IP](https://phishdestroy.io/tgwitness/pt/docs/reference/connection/#ip-modes) determinam se, em caso de falha, é necessário aguardar outro proxy ou se é possível utilizar uma rota direta explicitamente permitida. As solicitações HTTP externas possuem uma rota separada e um botão para desativá-las.

## Ferramentas de arquivamento

[A aquisição do histórico](https://phishdestroy.io/tgwitness/pt/docs/reference/history/), [a pesquisa e análise de arquivos](https://phishdestroy.io/tgwitness/pt/docs/reference/analysis/), [o MCP somente leitura](https://phishdestroy.io/tgwitness/pt/docs/reference/mcp/), [o OCR/transcrição local](https://phishdestroy.io/tgwitness/pt/docs/reference/media-analysis/) e [os webhooks de saída](https://phishdestroy.io/tgwitness/pt/docs/reference/webhooks/) foram incluídos a partir da versão 0.7.1. Relatórios analíticos e textos reconhecidos permanecem separados dos eventos capturados.

[O Case Board](https://phishdestroy.io/tgwitness/pt/docs/reference/case-board/) adiciona marcadores, citações, notas e coleções vinculadas às fontes dentro de um espaço de trabalho. O [construtor de relatórios](https://phishdestroy.io/tgwitness/pt/docs/reference/case-reports/) seleciona o material, as seções e um dos oito modelos para exportações em HTML/PDF compatíveis.

## Recursos opcionais

A configuração diária é: conta → fontes → observação. **Mais ferramentas → Extras** é um destino separado para captura independente, armazenamento, nível de objetivo e proteção, notificações, evidências e backups, um servidor sempre ativo, um bot testemunha do Telegram e uma verificação de código. Cada um indica sua disponibilidade e requisitos antes de exibir as configurações. Escolher um cartão abre as instruções; isso não inscreve nem inicia um serviço.

A configuração do bot tem três etapas: criar acesso somente leitura, escolher as configurações de publicação e iniciar no host da testemunha. Opções de rede e publicação, conexões existentes e comandos de verificação são divulgados sob demanda. A configuração baixada é distinta de uma testemunha em execução. A troca de extras mantém o rascunho; alterações na conta e bloqueio apagam o token temporário e o formulário. O guia integrado inclui instruções de inicialização. [O GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md), aberto a partir de Exports, inicia um coletor fixado a partir do seu fork, captura um chat e gera uma transferência criptografada com a proveniência do fluxo de trabalho.

## Protocolo e fontes privadas

**MTProto é o protocolo do Telegram; Telethon é a biblioteca Python que o TgWitness utiliza para comunicar-se via MTProto.** Não se trata de métodos alternativos de conexão. A coleta utiliza o MTProto; a testemunha opcional publica verificações assinadas por meio da API do bot.

Cada espaço de trabalho possui seu próprio cliente autorizado e fluxo de atualizações da conta. O TgWitness seleciona observações a partir de fontes configuradas e realiza solicitações explícitas e separadas para funções como instantâneos do histórico e downloads de mídia.

Uma fonte privada não necessita de nome de usuário público. O tipo de par do Telegram e o ID numérico são os identificadores; títulos e nomes de usuário podem ser alterados. O acesso depende da adesão e das permissões existentes. O TgWitness não adiciona fontes automaticamente nem contorna a aprovação de adesão. Um hash de acesso proveniente de outra conta não constitui um token de acesso universal.

O modelo de coleta deve levar em conta o histórico oculto anterior à adesão, as funções dos participantes/administradores, a revogação de sessões, a remoção ou alteração de permissões, a migração de grupo para supergrupo, tópicos/fóruns, discussões vinculadas, identidades de canais e anexos indisponíveis. Nem todas as combinações foram testadas em ambiente real.

A visibilidade da fonte é verificada no início do coletor. A ausência de uma fonte no resultado do diálogo delimitado significa que **o acesso não foi confirmado**, e não que a remoção tenha sido comprovada. Uma fonte indisponível não impede a observação de outras fontes acessíveis. Nunca coloque links de convite ou sessões reais em recursos públicos.

## Várias contas

O painel suporta qualquer número de **espaços de trabalho**, cada um com:

- Autorização, cofre criptografado e rota de conexão.
- Diário em SQLite e identidade de assinatura Ed25519.
- Fontes selecionadas, fila de mídia e configurações de captura.
- Estado de observação, erros, pontos de verificação e exportações.

A troca do espaço de trabalho exibido não interrompe outro coletor. A autorização de conta duplicada entre espaços de trabalho é rejeitada. Um registro já vinculado a uma conta do Telegram não pode ser reatribuído a outra; é permitido reconectar a mesma conta. Isso preserva a identidade da conta e o escopo relevante do ID da mensagem.

O aplicativo não define um número fixo de espaços de trabalho. Cada espaço de trabalho executa suas próprias tarefas do coletor para monitoramento de conexão, downloads de mídia, novas verificações e captação de novos chats dentro de um processo Python compartilhado e de um loop de eventos. A taxa de processamento depende da carga de trabalho. Para isolamento de processos, use instalações, portas e diretórios de dados separados.

Atribua a cada conta as fontes às quais ela tem acesso. Contas diferentes podem observar o mesmo grupo, mas suas observações permanecem separadas e mantêm sua origem. Duas contas em uma máquina controlada por um único operador não constituem duas testemunhas independentes. **A exportação do grupo** agrupa os arquivos ZIP das áreas de trabalho assinados separadamente com uma lista de arquivos assinada contendo seus IDs de área de trabalho, hashes e impressões digitais das chaves de assinatura. Cada diário mantém seu próprio limite. Crie uma linha do tempo combinada entre espaços de trabalho em notas de caso ou ferramentas de análise, mantendo essas referências de fonte.

## Captura e atribuição

A seção “Fontes” oferece opções por conta para novas mensagens, edições, exclusões, reações e participação em grupos. As predefinições retêm todas as categorias ou apenas mensagens/edições/exclusões. A política se aplica aos grupos selecionados do espaço de trabalho, permanece válida após a reinicialização e é assinada com as alterações antes e depois. As configurações padrão preservam todas as categorias. Desativar uma categoria não remove registros antigos; reativá-la não reconstrói eventos perdidos. Registros operacionais, outros eventos de serviço do grupo e instantâneos explícitos do histórico são separados. Objetos do Telegram capturados podem reter metadados incorporados, independentemente das opções de atualização separada. Ainda não há substituições de categoria por grupo.

| Material | Capturado agora | Limites |
| --- | --- | --- |
| Mensagem | Texto, IDs de pares/mensagens, metadados do remetente, respostas e envelope de atualização original | Preservado como uma observação visível na conta, assinada pelo coletor |
| Editar | Nova versão observada, versões capturadas anteriormente, hora de recepção e data de edição fornecida | As atualizações de mensagens e as entradas disponíveis no log de administração mantêm seus respectivos campos de atribuição |
| Exclusão | Notificação do Telegram, hora de recebimento e conteúdo capturado anteriormente | O ator e a hora da ação de origem são mantidos quando fornecidos por um registro separado do log de administração |
| Aviso de exclusão no nível da conta | Aviso original; os registros resolvidos incluem o chat salvo e o método de correlação | Requer exatamente uma correspondência de chat privado ou grupo comum previamente salva no escopo; outros IDs permanecem como “`deletion.unscoped`”. IDs de canais e supergrupos são excluídos dessa correlação |
| Reação | Contadores apresentados e identidades recentes visíveis | Uma lista completa dos reatores disponíveis requer consultas separadas; os canais podem ocultar identidades |
| Associação | Mensagens de serviço e atualizações enviadas aos participantes | A visibilidade depende da função e do tipo de chat; a participação é relatada a partir dos eventos entregues |
| Ações do administrador | Atualizações relevantes entregues e um instantâneo do log de administração nas exportações de bate-papos de canais/supergrupos | A exportação lê o log quando este estiver disponível para a conta de administrador responsável pela exportação |
| Anexo | Descritor da versão original, bytes baixados/SHA-256 e resultados das tentativas | A versão original permanece; uma versão posterior nunca a substitui |
| Histórico | Captura de tela explícita das mensagens visíveis no momento | A gravação ao vivo mantém as versões anteriores e os avisos de exclusão |
| Processo do coletor | Início/parada, heartbeat, erros, configurações, escopo e recibo de execução assinado | Inventário local; GitHub e TDX adicionam [verificações de ambiente independentes](https://phishdestroy.io/tgwitness/pt/docs/reference/evidence/#verification-scope) |

A interface identifica a conta fornecida no evento de origem e mantém os nomes e nomes de usuário observados. Quando o evento omite seu autor, o relatório deixa esse campo em branco.

## Capacidade e limites do Telegram

A capacidade é dimensionada por implantação. Ela depende do pico de eventos por segundo, do volume e dos tamanhos dos anexos, de RPCs adicionais, de contas ativas, da latência do disco/espaço livre, das condições da rede, dos limites do Telegram, do atraso aceitável e da profundidade da fila.

O Telegram distingue a entrega passiva da sondagem curta ativa. Sua documentação de atualização descreve chamadas adicionais de `updates.getChannelDifference` para canais abertos e supergrupos e recomenda no máximo **dez fontes sondadas simultaneamente por sondagem curta**. Isso se aplica à sondagem curta; o número de grupos selecionados é definido separadamente.

| Modo | Objetivo | Status |
| --- | --- | --- |
| Observação padrão | Registre as atualizações recebidas de fontes selecionadas | Implementado |
| Revisões prioritárias | As fontes marcadas com estrela utilizam seu próprio intervalo configurável e têm prioridade em cada etapa de verificação limitada | Implementado com consultas de histórico e mensagens |

A estrela de prioridade controla essas verificações adicionais. A consulta rápida adicional ``updates.getChannelDifference` ` não é disponibilizada como um modo de usuário separado.

A consulta arbitrária de alta frequência, ignorando o FloodWait ou presumindo capacidade linear de contas adicionais, não é um modelo de dimensionamento válido. Os limites padrão são os primeiros 1,000 diálogos listados, até 500 mensagens por instantâneo do histórico, 1–2,000 MiB por arquivo coletado por tipo e 4 GiB de conteúdo ZIP assinado não compactado; cada um é alterado por espaço de trabalho, tamanhos de arquivo em **Mais ferramentas → Fontes → Gravação** e os demais em **Mais ferramentas → Parâmetros**. As exportações não têm limite fixo de contagem de eventos. O fallback do navegador é limitado a 128 MiB por padrão; a CLI de streaming possui um limite de transferência configurável, de 5 GiB por padrão.

## Confiabilidade e recuperação

O comportamento implementado inclui WAL do SQLite/transações síncronas; gravações atômicas de mensagens e tarefas de mídia; tarefas persistentes e atrasos de repetição; descritores da versão original; retentativas limitadas; FloodWait de mídia persistida; downloads de mídia fora da espera de rede do evento de texto; exportações com prefixo estável enquanto gravações posteriores continuam; configurações atômicas e registros de auditoria; preservação da autorização ativa após falha no login de substituição; isolamento de um espaço de trabalho adicional danificado; tentativas explícitas de reconexão; relatórios distintos de perda de autorização; e detecção de alterações no relógio de parede por meio de um relógio monotônico.

Os pontos pts/qts/seq de contas e canais são salvos e retomados após uma reinicialização, e os chats monitorados são verificados novamente periodicamente; consulte [o formato de evidência](https://phishdestroy.io/tgwitness/pt/docs/reference/evidence/#durable-collection-and-process-receipts-02). Salvar a posição periodicamente não constitui uma confirmação atômica e sem perdas da aceitação do registro.

Cada início de processo registra o ponto inicial anterior e o limite offline. O histórico atual não é tratado como correção de lacunas. A retenção de diferenças do Telegram é finita; o `differenceTooLong` não pode reconstruir todo o conteúdo desaparecido. Lacunas irrecuperáveis devem permanecer explícitas, mesmo que um instantâneo posterior do histórico seja bem-sucedido.

## Modelo de evidências

Cada evento registra uma sequência, a hora de observação local em UTC, a hora da fonte (quando fornecida), o tipo, a fonte, o autor (quando fornecido), a carga útil original, o hash anterior e a assinatura. As observações de mensagens também retêm a conta do coletor e o contexto da execução.

O recibo de processo assinado contém um ID de execução aleatório; versões do TgWitness/Python/OS/dependências; valores SHA-256 dos arquivos-fonte e impressão digital agregada; conta inicial, escopo e configurações; leituras UTC/monotônicas; e o cabeçalho do registro anterior. Alterações nas configurações, início/parada e erros são registrados no mesmo diário. Os pontos de verificação são retidos na inicialização, a cada cinco minutos durante a observação (parâmetro alterável) e na parada ordenada. Um ponto de verificação local retido pode detectar um retrocesso para um prefixo de diário anterior.

| Mecanismo | O que ele estabelece |
| --- | --- |
| SHA-256 do arquivo | Os bytes correspondem a um resumo conhecido |
| Cadeia de hashes de eventos | Ordenação/associação de registros em relação a um limite conhecido |
| Ed25519 | Assinatura sob uma chave específica |
| Ponto de verificação mantido de forma independente | O material subsequente está de acordo com o limite estabelecido |
| Análise do arquivo do programa | Relatório do coletor sobre os arquivos medidos |
| Resposta válida e independente da TSA | Existência de bytes específicos no momento TSA sob pressupostos explícitos de confiança |

A preparação de solicitações RFC 3161 e a verificação de respostas são implementadas sem OpenSSL. O modo de evidência também envia os hashes dos pontos de verificação aos serviços de carimbo de tempo configurados. Guarde e verifique a resposta da autoridade para estabelecer uma âncora temporal independente. Veja [TIMESTAMP.md](https://phishdestroy.io/tgwitness/pt/docs/reference/timestamp/).

Mantenha pontos de verificação de forma independente, controle o acesso às chaves de assinatura, mantenha registros de transferência e verifique as exportações com software confiável. O [escopo da verificação](https://phishdestroy.io/tgwitness/pt/docs/reference/evidence/#verification-scope) explica como essas verificações se complementam e quais pressupostos de confiança se aplicam.

## Exportação, implantação e transferência

Um arquivo ZIP assinado contém os arquivos originais em JSONL, CSV e HTML, anexos preservados, hashes, um manifesto assinado e um verificador de conveniência. Abrange um espaço de trabalho e um prefixo fixo completo para o registro. Os filtros de pesquisa do painel não removem registros silenciosamente. Chaves secretas, tokens e sessões do Telegram são excluídos; as observações originais ainda podem conter informações pessoais e metadados do Telegram.

Mantenha o resumo do ZIP, a impressão digital confiável, o ponto de verificação, o recibo de processamento e o registro de transferência separadamente. Utilize um verificador proveniente de uma instalação confiável, em vez de confiar no código executável apenas porque ele aparece no ZIP examinado.

A interface do navegador é fornecida localmente, sem Node.js, CDNs ou fontes externas. Um token de operador controla a instalação. O acesso remoto requer HTTPS ou um túnel SSH. São fornecidas definições nativas em Python e para contêineres, com exemplos de serviços na pasta [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md); as verificações de plataforma executadas são listadas separadamente.

O espaço de trabalho padrão utiliza a raiz de dados; espaços de trabalho adicionais utilizam `profiles/<id>/`. O backup requer que o processo esteja parado e que o conjunto completo de dados/chaves esteja disponível. Os arquivos ZIP de evidências não são backups do aplicativo. Os segredos podem utilizar uma chave mestra externa para um novo diretório de dados; a criptografia do diário e da mídia é fornecida pelo disco/volume do operador. Consulte [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/pt/docs/reference/connection/) e [OPERATIONS.md](https://phishdestroy.io/tgwitness/pt/docs/reference/operations/).

## Critérios de lançamento estável

Antes do lançamento de uma versão estável, especifique:

1. Grupos privados reais, supergrupos, fóruns e canais com funções de membro/administrador e histórico oculto/visível, incluindo login/autenticação de duas etapas (2FA), revogação e perda de acesso.
2. Edições, exclusões, reações, participação e mídia controladas em relação a ações conhecidas.
3. Falhas no processo/servidor, falhas no disco/disco cheio, referências a arquivos expirados, FloodWait, perda de conexão de rede, arquivos corrompidos e reversão do banco de dados.
4. Uso contínuo de múltiplas contas com atrasos, filas, memória e espaço em disco controlados, incluindo fontes silenciosas e ruidosas em conjunto.
5. Interrupção entre o avanço do estado do MTProto e a aceitação do registro.
6. Instalação limpa na matriz de sistemas operacionais/contêineres pretendida e restauração de backup verificada.
7. Análise independente de segurança, assinaturas e alegações de atribuição/evidência.

O acesso restrito ao painel é descrito em [acesso e permissões](https://phishdestroy.io/tgwitness/pt/docs/reference/access/). Desde a versão 0.6, o TgWitness oferece suporte ao TData de conta única delimitada e à importação de arquivos de conta, conforme descrito em [ACCOUNTS.md](https://phishdestroy.io/tgwitness/pt/docs/reference/accounts/). Revise os termos da API do Telegram antes da publicação. As referências de pesquisa e as conclusões sobre a plataforma estão em [RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md).
