Referência / Coletar
Telegram · Como funciona a coleta
Escopo de observação, atualizações em tempo real, novas verificações, anexos, ações próprias e o que significa uma lacuna, registro por registro.
TgWitness / Documentação · Coleção
O TgWitness registra o que uma conta conectada do Telegram observa. O monitoramento em tempo real preserva mensagens, edições capturadas, notificações de exclusão e anexos com seus horários de observação e contexto de origem. Leituras do histórico, novas verificações e registros disponíveis do log de administração adicionam observações identificadas separadamente a esse registro.
Nesta página
- Do login ao diário
- Escopo da observação: chats selecionados, uma pasta ou toda a conta
- Escopo e seleção de eventos
- Ações próprias
- Modo de investigação: ingressando em equipes e conversando com bots
- Níveis de verificação
- Histórico de mensagens e atribuição
- Instantâneos históricos
- Tratamento de anexos
- Pausar, bloquear, desconectar e reiniciar
- Isolamento e verificação de contas
Do login ao registro#
Para fotos e arquivos autodestrutíveis, consulte Mídia autodestrutível. Isso explica o trabalhador prioritário, os resultados salvos e indisponíveis, e os limites do bloqueio de confirmação de leitura no coletor da API.
Diagrama em formato de texto
- Autorizar uma conta de usuário → Selecione grupos e canais acessíveis
- Selecione grupos e canais acessíveis → Salvar configurações de eventos e anexos
- Salvar configurações de eventos e anexos → Iniciar observação
- Iniciar observação → Receba atualizações do cliente ativo
- Receba atualizações do cliente ativo → Aplique a política de fontes e eventos
- Aplique a política de fontes e eventos → Anexar uma observação assinada
- Anexar uma observação assinada → Revisar ou exportar o registro
- Anexar uma observação assinada → Processar qualquer anexo em fila
- Processar qualquer anexo em fila → Anexe o resultado do download
Autorização, acesso a uma fonte, um coletor em execução e entrega completa são questões distintas. Um login bem-sucedido não concede acesso a todos os grupos. A entrega é rastreada separadamente: registros de cobertura, recuperação de lacunas de atualização e novas verificações mostram o que chegou.
Âmbito de observação: conversas selecionadas, uma pasta ou toda a conta#
Mais ferramentas → Fontes → O escopo determina quais conversas um espaço de trabalho registra.
A nova configuração começa com a opção Escolher bate-papos. As opções salvas anteriormente são mantidas. Ao selecionar Todos os bate-papos no assistente de configuração, é solicitada uma confirmação quando a lista carregada contiver mais de 50 bate-papos; a estimativa de tamanho continua sendo uma operação separada, baseada em amostragem.
| Modo | Registros | Novas conversas |
|---|---|---|
| Conversas selecionadas (padrão) | Apenas os chats que o senhor adicionar manualmente | Nunca adicionado automaticamente |
| Pasta do Telegram | Conversas em uma das pastas da conta: conversas incluídas por nome, além das categorias da pasta (contatos, não contatos, grupos, canais, bots), excluindo as conversas excluídas e, se a pasta assim o indicar, as conversas arquivadas | As conversas correspondentes são adicionadas assim que se tornam ativas; as conversas que o senhor adicionar à pasta no Telegram são capturadas em até uma hora |
| Conto completo | Todas as conversas que a conta recebe | Cada novo chat, grupo, chat privado ou bot é adicionado no momento em que sua primeira atualização é recebida |
- Os tipos de fonte (canais, grupos, conversas privadas, bots) restringem os modos de pasta e de conta inteira. As conversas selecionadas podem ser de qualquer tipo, incluindo conversas privadas e bots; os tipos de fonte nunca bloqueiam uma conversa que você adicionou manualmente. A desativação de um tipo, uma exclusão ou a mudança para “chats selecionados” interrompe as fontes adicionadas automaticamente assim que for salva, antes mesmo de a lista de fontes ser recalculada e também quando não for possível acessar o Telegram: suas novas mensagens, histórico de interações, histórico de novos chats, configurações de pares e observações de perfil.
- As conversas adicionadas manualmente permanecem registradas nos modos “pasta” e “conta inteira”, mesmo quando estão fora da pasta; somente as opções Excluir, Remover ou uma pausa as interrompem. As conversas adicionadas (automaticamente) seguem a pasta: aquela que sair dela será colocada em pausa no próximo recálculo.
- As conversas excluídas nunca são registradas, em nenhum modo. Nos modos “Pasta” e “Conta inteira”, as opções Excluir e Remover em uma fonte colocam a conversa nessa lista, de modo que o escopo não a adiciona novamente. Selecionar o chat novamente manualmente (em “Fontes”, em “Chats” ou em “Configurações” → Quais chats?) o retira da lista. A lista comporta até 5.000 chats; além desse limite, a opção Remover é recusada e o chat pode ser pausado em vez disso.
- Ações próprias (ativadas por padrão): mensagens enviadas por esta conta, suas edições e seus toques no botão do teclado de resposta. Quando desativado, as mensagens enviadas e as edições são ignoradas.
- Ao mudar para uma pasta ou para toda a conta, é solicitada uma confirmação: esses modos registram
conversas privadas e mensagens de terceiros e devem ser utilizados apenas em uma conta dedicada.
A confirmação e todas as alterações de escopo são registradas em registros do tipo
scope.changed. Em uma conta configurada como sua conta principal, o formulário de escopo e a Investigação recusam uma pasta ou a conta inteira, assim como o “start”; apenas uma cópia única, sem gravação, pode utilizá-las. - As conversas adicionadas pelo escopo aparecem como fontes marcadas como auto, registradas como
scope.applied(no início e a cada hora) ousource.discovered(uma nova conversa durante a observação). Ao voltar para as conversas selecionadas, todas as fontes adicionadas automaticamente são pausadas de uma só vez, sem que a lista de conversas da conta seja lida novamente. Um chat excluído deixa de ser registrado assim que o escopo é salvo, e sua fonte é pausada mesmo quando o Telegram não retorna a lista de chats. Durante a observação, salvar o escopo o aplica novamente, mesmo quando os valores não mudaram.
Escopo desses modos:
- As conversas secretas utilizam a integração Pseudo-secret incluída, com um módulo de protocolo instalado a partir do painel e um botão de ativação por conta. O histórico na nuvem e o Takeout utilizam um caminho de aquisição separado.
- Períodos offline. Após uma reinicialização, o TgWitness retoma a posição de atualização salva, solicita
ao Telegram as atualizações perdidas e verifica novamente os chats. O Telegram mantém um backlog limitado; portanto, após
uma longa interrupção, os relatórios e o
verify.pylistam o intervalo restante como uma lacuna (consulte cobertura). - Apenas as primeiras 1,000 conversas são listadas inicialmente (o limite está em Mais ferramentas → Parâmetros); conversas mais antigas são adicionadas quando se tornam ativas novamente. O histórico anterior de uma conversa adicionada não é recuperado — faça um instantâneo do histórico ou uma exportação completa da conversa quando necessário.
- Condições de pastas que mudam constantemente (silenciadas, lidas) não são aplicadas: tais conversas continuam sendo monitoradas.
- Os botões do bot embutidos (callback) pressionados em outro aplicativo são invisíveis para uma segunda
sessão; a resposta ou edição do bot é registrada. As teclas pressionadas no teclado de resposta chegam como mensagens enviadas
e são identificadas como
button_press. - Mais conversas significam mais solicitações. O Telegram restringe contas cujo volume considera excessivo, o que constitui mais um motivo para utilizar contas dedicadas.
Bate-papos cuidadosamente selecionados#
Rigoroso: apenas os chats selecionados aparecem na seção Chats selecionados e essa opção vem desativada por padrão. Ela se destina a uma permissão que abrange apenas os chats selecionados. Quando está ativada:
- As notificações de serviço do Telegram (777000) não são lidas: nem quando a observação começa ou termina, nem a cada
minuto durante a observação. Nenhum registro de `
session.security_baseline` ou `account.security_event` é gravado. - A lista de sessões da conta não é lida: nem quando a observação começa ou termina (a pergunta do painel sobre
outras sessões para Evidências de um caso e os modos de proteção de evidências também é ignorada), nem a cada dois
minutos durante a observação, nem quando uma conexão é estabelecida, nem pela verificação de conexão, cuja entrada de autorização Atual
é exibida como ignorada. O status da verificação em duas etapas usado pela verificação de assunção de controle também não é
lido. Portanto,
account.sessions,session.concurrent_at_startesession.takeover_risknão são gravados, e uma sessão encerrada em outro dispositivo não é relatada comosession_revoked_externally. - Embora esta seja a única sessão da conta (faça com que esta seja a única sessão ou sua versão automática), a
lista de sessões continua sendo lida a cada dois minutos durante a monitorização e quando uma conexão é estabelecida, de modo que
o evento `
session.exclusive_ended` é registrado quando surge outra sessão. 777000 permanece não lido nesse período, embora o registro `session.exclusive_from` indique que os avisos de login do Telegram continuam sendo registrados. - Os avisos de exclusão são comparados com uma verificação de sessão somente se uma tiver sido executada nos últimos 10 minutos (desde que essa seja a única sessão ou após a abertura das Sessões desta conta). Caso contrário, a menos que a última verificação de direitos mostre que essa conta não poderia excluir a mensagem (o que nunca ocorre em conversas privadas e grupos comuns), a mensagem exibe: Não se sabe quem a excluiu: a própria conta, a partir de outra sessão ou dispositivo, também poderia tê-la excluído.
- Com uma chave de sessão importada, nada no diário indica a hora em que essa sessão foi iniciada até que a
lista de sessões seja lida (por exemplo, em Sessões desta conta). Até então, as exportações de bate-papo e as exportações automáticas
de conta utilizam a sessão regular em vez do Takeout, com o motivo
session_age_unknown. - Ativar um chat não faz com que as mensagens anteriores sejam lidas. Sem essa opção, cada chat ativado (em Fontes, em
“Bate-papos”, seja ao entrar pelo painel ou pelo assistente de configuração) recebe um instantâneo de
baselinedas mensagens mais recentes, até o limite definido em Mais ferramentas → Parâmetros → Maior instantâneo do histórico (500 por padrão), quando a observação for executada novamente. Um instantâneo em espera que venha a ser gerado enquanto a opção estiver ativada é descartado. Um chat acessado pelo painel também não tem suas mensagens mais recentes lidas como um novo chat (a contagem Quando um novo chat ou bot aparece, 100 por padrão), e abrir um chat selecionado sem mensagens salvas em “Chats” não carrega automaticamente suas últimas 100 mensagens. O histórico e os instantâneos que você mesmo inicia ainda exibem o histórico. - A configuração de conteúdo sensível da conta não é lida nem alterada. Sem o botão, o login e cada nova
conexão ativam essa configuração quando ela está desativada, e o Telegram permite a alteração (
account.content_settings); a configuração pertence à conta e se aplica a todos os aplicativos do Telegram. O conteúdo que o Telegram marca como sensível pode permanecer oculto. - As atualizações relacionadas a chamadas telefônicas não são registradas como
account.phone_call. - A interrupção da observação grava apenas a impressão digital da chave da sessão; ela não lê a lista de sessões nem o 777000.
Isso não restringe o que o Telegram envia: as atualizações de todos os chats ainda chegam a esta sessão, e apenas os
chats selecionados são registrados. A lista de chats da conta (até os chats lidos da lista da conta) e suas pastas são
ainda lidas no início e novamente quando o escopo é salvo durante a observação, para localizar os chats selecionados. Notificações de
exclusão sem um chat específico (`deletion.unscoped`) ainda são registradas: elas contêm apenas IDs de mensagens e podem pertencer a
um chat privado selecionado ou a um grupo comum. A verificação de conta congelada (help.getAppConfig), as outras verificações de conexão
e os recursos que você mesmo ativa (encerramento automático de outras sessões, a sonda de testemunha,
chats pseudo-secretos, “Sessões desta conta” e a lista do Telegram de dispositivos conectados em “Mais
testemunhas, que lê a lista de sessões a cada passagem de carimbo de data/hora e cuja configuração contribui para as metas “Acompanhar bate-papos”
e “Provas para um caso”) continuam funcionando.
Ative-o antes de fazer login; caso contrário, o próprio login verifica a autorização atual e ativa o conteúdo sensível.
Cada alteração é um registro assinado de `scope.changed`, e `observation.started` contém o valor como
`scope.strict`. Ao alternar para uma pasta ou para toda a conta, ele é desativado.
Escopo e seleção de eventos#
Cada espaço de trabalho possui suas próprias fontes. O TgWitness não entra em grupos, não aceita convites nem enumera todos os membros automaticamente. As fontes já devem estar acessíveis à conta. Na inicialização, o coletor verifica as fontes selecionadas em relação aos diálogos visíveis da conta; os primeiros 1,000 diálogos são inspecionados, a menos que a opção Mais ferramentas → Parâmetros → Bate-papos lidos da lista da conta indique o contrário. Uma fonte ausente é marcada como acesso não confirmado, não se presume que ela tenha removido você.
| Contexto | Coleta | Efeito quando desativado |
|---|---|---|
| Novas mensagens | Mensagens entregues normalmente | Edições ou exclusões posteriores podem não ter texto capturado anteriormente para comparação. |
| Edições | Versões editadas das mensagens fornecidas | Alterações intermediárias não são reconstruídas posteriormente. |
| Exclusões | Notificações de exclusão com escopo definido e notificações sem escopo definido no nível da conta | Notificações de exclusão não são adicionadas ao registro. |
| Reações | Instantâneos de reações fornecidos | Não são adicionadas atualizações separadas sobre reações. |
| Associação | Envio de mensagens de serviço aos membros e atualizações aos participantes | Essas observações sobre a adesão não foram incluídas. |
As configurações se aplicam a todas as fontes selecionadas na área de trabalho. Salve o formulário para aplicar as alterações; as alterações são registradas com valores assinados de “antes” e “depois”. Desativar uma categoria não remove registros anteriores. Reativá-la não repõe as atualizações perdidas.
Registros operacionais e outros eventos de serviço do grupo permanecem separados dessas configurações. Mensagens de serviço relacionadas à adesão podem criar registros de mensagens quando a adesão estiver ativada, mesmo que a captura padrão de novas mensagens esteja desativada. Objetos do Telegram capturados mantêm metadados incorporados; uma configuração não constitui uma regra de supressão.
Exclusões em chats privados e grupos comuns chegam como IDs de mensagem sem um chat associado.
Esses chats compartilham uma sequência de IDs de mensagem válida para toda a conta; portanto, quando uma mensagem com esse ID foi
salva anteriormente, seu chat é conhecido: a exclusão é registrada nesse chat com
o chat_resolution, explicando como. IDs nunca salvos permanecem como uma exclusão sem escopo, com um
chat explícito não resolvido. Essas são notificações de exclusão do Telegram, preservadas mesmo
quando seu chat ainda não pode ser correlacionado. O esquema da notificação contém IDs;
o diário adiciona a hora de recebimento e qualquer contexto da mensagem salva, incluindo
deleted_message_was_outgoing. As entradas disponíveis no log de administração fornecem uma fonte separada
da ação, do autor e da hora de origem.
Ações próprias#
As mensagens enviadas pela conta observada são identificadas como outgoing. Uma edição de uma mensagem enviada
indica que, em chats privados e grupos, apenas seu autor pode editá-la, enquanto as postagens em canais
podem ser editadas por outros administradores. Quando uma mensagem enviada repete o texto de um botão
do teclado de respostas mais recente salvo naquele chat, ela recebe a marcação button_press, acompanhada de um link para
o registro do teclado.
A exclusão de ações próprias também se aplica a novas verificações em segundo plano e ao histórico automático de novas conversas. As mensagens enviadas que foram ignoradas avançam a posição da nova verificação, de modo que não possam bloquear mensagens recebidas posteriormente. Ações explícitas no painel e instantâneos do histórico solicitados manualmente permanecem registrados.
Modo de investigação: ingressar em grupos e interagir com bots#
Mais ferramentas → Fontes → Escopo → O modo de investigação prepara o escopo para uma conta dedicada que participa de chats de equipe, inicia bots e escreve neles: toda a conta, todos os tipos de fonte, ações próprias e, para cada chat ou bot que aparecer, seu perfil e suas últimas 200 mensagens visíveis. Revise o formulário e clique em Salvar escopo; a mudança para toda a conta solicita a confirmação de praxe.
- Botões. Os botões abaixo de uma mensagem são mantidos junto a ela e exibidos em “Chats”: links, aplicativos web, links de login, textos para copiar, dados de retorno de chamada, consultas embutidas, solicitações de número de telefone ou localização. Os links são exibidos como texto e nunca são abertos pelo painel. Quando um bot altera apenas os botões (um novo link de pagamento), isso constitui uma nova versão da mensagem, tanto em atualizações em tempo real quanto em novas verificações.
-
Novos chats e bots. Nos modos “pasta” e “conta inteira”, quando um novo chat ou bot aparece, ele é salvo imediatamente após seu surgimento:
- seu perfil como um registro
source.profile: descrição do bot e comandos, o texto “Sobre” de um usuário, grupo ou canal, membros, chat vinculado e link de convite quando o Telegram fornecer um; - suas mensagens visíveis mais recentes (até 1.000) como um instantâneo do histórico marcado como
new_chat: as mensagens anteriores de um chat em grupo ao qual acabou de entrar, ou o que um bot disse antes que a observação percebesse o chat. Mensagens já salvas em tempo real não são repetidas.
Os chats recém-selecionados utilizam essas configurações quando o escopo é aplicado, incluindo chats já presentes na lista de diálogos da conta. O carregamento inicial do perfil e do histórico ocorre em até três chats simultaneamente; as tarefas relacionadas ao mesmo chat são executadas em ordem. Cada etapa do histórico/perfil utiliza o tempo limite de operação configurado; assim, as solicitações paralisadas liberam seu processador. O histórico é salvo antes da leitura opcional do perfil; uma falha no perfil não impede essa captura do histórico. Etapas com falha são repetidas após 5 segundos, dobrando o tempo até um máximo de 5 minutos sem ocupar um processador durante o atraso. IDs pendentes, prazos de repetição e etapas concluídas são salvos localmente. Uma reinicialização retoma apenas as etapas não concluídas; uma repetição do perfil não repete uma leitura de histórico já concluída. Fontes desativadas antes de sua vez são ignoradas. A visão geral mostra carregamentos de bate-papos ativos, pendentes e em repetição separadamente dos downloads de anexos. Um FloodWait pausa esse trabalho, que é retomado posteriormente; as falhas são registradas e a gravação ao vivo do chat continua. Isso inclui esperas durante a resolução da identidade do novo chat: a tarefa pendente de perfil/histórico é mantida para nova tentativa, e uma espera já existente mais longa em toda a conta não é encurtada. Os trabalhadores compartilham essa espera; a concorrência não contorna os limites de solicitações do Telegram. - Perfis sob solicitação. Chats → Perfil → Salvar perfil agora salva o perfil atual de qualquer fonte; o mais recente é exibido acima das mensagens. - Instantâneos do estado do chat (pré-visualização). O estado fora do fluxo de mensagens muda sem uma mensagem: desfixar todas as mensagens não deixa rastros no nível da mensagem, um administrador perde seus direitos, um presente é ocultado, convertido, atualizado ou reembolsado. Durante a observação, cada fonte habilitada é lida periodicamente e salva como um registro assinado
chat.state: título, nomes de usuário, descrição, contagem de membros e administradores, chat vinculado, modo lento, IDs de mensagens fixadas (até 100), administradores com seus direitos e títulos, e presentes exibidos nos canais e perfis de usuário (até 100). Cada registro lista as diferenças em relação ao instantâneo anterior: campos alterados com os valores anteriores e posteriores, mensagens fixadas adicionadas ou removidas, administradores e presentes adicionados, alterados ou que não constam mais na lista. - Uma parte que o Telegram recusa (por exemplo, a lista de administradores de um canal para um membro que não é administrador) é indicada emerrors; seu valor anterior é mantido e listado emcarried_forward, nunca sendo relatada como removida. - Um registro cujas únicas alterações sejam contagens, e uma verificação que não encontrou nenhuma alteração, refere-se ao último estado completo comstate_seqe cumulativostate_overrides. Um estado completo é gravado pelo menos a cada sete dias e sempre que algo além de uma contagem for alterado. -parts_completemarca listas com limite máximo. Adições exigem uma lista anterior completa, remoções exigem uma lista atual completa, e valores vazios explícitos indicam a limpeza do registro. - Mais ferramentas → Parâmetros → Estado do chat define o intervalo (12 horas por padrão; 0 desativa os instantâneos ), a pausa entre fontes, quais partes são lidas e se as verificações que não encontraram alterações são registradas.FLOOD_WAITeFLOOD_PREMIUM_WAITinterromper as demais solicitações de instantâneos, preservar qualquer prazo mais longo válido para toda a conta e deixar o chat interrompido apto para outra tentativa após esse tempo de espera. - Não visível. Botões embutidos (de retorno de chamada) pressionados em outro aplicativo do Telegram, o pop-up ou link com que um bot responde a tal pressão e links de convite usados em outro aplicativo não chegam ao TgWitness. O que o bot envia ou edita posteriormente é registrado. - seu perfil como um registro
Ato do painel#
A seção “Bate-papos” agora inclui um minicliente que utiliza a conta do Telegram do espaço de trabalho selecionado:
- Escreva uma mensagem em texto simples ou selecione “Responder” em uma mensagem salva. A mensagem de saída gerada é registrada mesmo quando o escopo exclui atualizações de saída.
- Pressione o botão “Press” abaixo de um botão de retorno de chamada ou de texto atual. O servidor busca a mensagem novamente e recusa a ação se o conteúdo digitado diferir da versão salva. Os recibos de retorno de chamada mantêm o texto do pop-up do Telegram, o sinalizador de alerta e a URL; a resposta também é exibida abaixo da conversa. As URLs permanecem como texto selecionável e não são abertas automaticamente.
- Pressione + → Abrir link do Telegram, insira
@username, um link públicohttps://t.me/name,https://t.me/+invite/joinchat/inviteou um link de bot com?start=parametere pressione Salvar pré-visualização. O link original e a pré-visualização do Telegram são assinados antes da adesão. Entrar/abrir e observar: em seguida, o usuário entra no grupo/canal ou abre o usuário/bot, adiciona o bate-papo como fonte habilitada e envia/startpara um bot, incluindo seu parâmetro de início. Uma solicitação de adesão aguardando aprovação do administrador é registrada como pendente, e não como adesão.
Ative Iniciar observação para capturar respostas recebidas em tempo real. As ações do painel funcionam enquanto a observação está pausada; o painel então salva suas respostas diretas, e a observação em tempo real captura o restante da conversa. Fontes recém-adicionadas utilizam a configuração de perfil/histórico definida quando a observação está em execução. Quando uma fonte estiver pausada, ative-a em Mais ferramentas → Fontes antes de enviar ou pressionar seus botões.
interaction.preview, interaction.requested e interaction.result são eventos comuns assinados
do diário incluídos nas exportações de evidências. As solicitações identificam a conta, a mensagem/botão
ou o registro de visualização e se a observação estava em execução. Os recibos distinguem entre sucesso,
rejeição, aprovação pendente e um resultado desconhecido. Uma solicitação interrompida pode ter chegado
ao Telegram: verifique o chat antes de iniciar uma nova ação. Reutilizar um ID de solicitação recupera seu
recibo salvo sem repetir a ação, inclusive após a reinicialização. O painel retém o
ID após uma resposta ambígua para a mesma ação durante a sessão da página atual.
Ele também retém esse ID quando a atualização da visualização falha após uma ação bem-sucedida: o recibo
permanece visível, e clicar novamente o recupera. Os RPCs de callback e de adesão têm uma única
tentativa; as leituras com possibilidade de repetição mantêm sua política de repetição configurada. A troca de chats limpa imediatamente
o rascunho e o destinatário da resposta e desativa o envio até que a nova conversa seja carregada.
Este minicliente lida com botões de texto e de retorno de chamada. Os botões de miniaplicativos exibem a opção Abrir miniaplicativo, que executa o aplicativo em um navegador isolado (Miniaplicativos). Solicitações de login, de número de telefone e de localização, pagamentos, consultas embutidas e anexos ainda exigem um cliente do Telegram; os metadados salvos dos botões permanecem visíveis. Os novos controles utilizam texto em inglês.
Níveis de verificação#
As novas verificações solicitam novamente ao Telegram mensagens perdidas, edições e mensagens que ele não retorna mais.
Fontes marcadas com um asterisco são fontes prioritárias, verificadas novamente a cada 15 minutos por padrão;
todas as outras fontes, a cada 6 horas. Os chats selecionados começam como fontes prioritárias; chats adicionados por uma
pasta ou pela conta inteira são considerados fontes regulares. No máximo, 30 fontes são verificadas novamente por ciclo e
o restante aguarda até o minuto seguinte; após uma reconexão, as fontes prioritárias são verificadas primeiro. Ambos os
intervalos são definidos em Mais ferramentas → Fontes → Gravação → Verificação adicional (0 desativa uma camada) e são
registrados como recheck.changed.
As mensagens perdidas são recuperadas a partir do ponto em que a passagem anterior parou, no máximo
Mais ferramentas → Parâmetros → Mensagens perdidas recuperadas por chat e passagem (1,000 por padrão). Após uma longa interrupção, a
reverificação, portanto, preenche toda a lacuna, mesmo quando mensagens em tempo real mais recentes do que a lacuna foram salvas
primeiro. Um chat que ainda está se atualizando é verificado novamente no minuto seguinte, em vez de
esperar pelo seu intervalo de nível; recheck.completed mostra continues_after até que seja concluído.
As comparações incluem o texto das mensagens, entidades, teclados (incluindo remoção) e conteúdo/identidade dos anexos. A simples alteração de hashes de acesso a arquivos ou de referências a arquivos não constitui uma edição, nem o que o Telegram preenche automaticamente: o carregamento de uma pré-visualização de link, visualizações de stories, mídias pagas desbloqueadas por esta conta, o recebimento de uma fatura. Cada versão salva em “Chats” possui um link para seu registro completo no diário, incluindo metadados de mídia.
Histórico de mensagens e atribuição#
Suponha que o coletor observe “Reunião às 10h”, depois veja “Reunião às 11h” e, em seguida, receba um aviso de exclusão. Ele anexa três observações distintas. O texto original permanece, a edição é uma versão separada e o aviso registra que foi observada uma exclusão.
Caso a coleta tenha começado após o desaparecimento da primeira versão, esse texto não estará disponível. Caso tenham ocorrido várias edições enquanto o processo estava offline, apenas as versões observadas posteriormente podem ser salvas. Um aviso de exclusão não permite recuperar conteúdo que nunca foi capturado.
O registro combina várias fontes:
| Fonte | Informações preservadas |
|---|---|
| Mensagem ao vivo ou atualização de edição | ID da mensagem, metadados do remetente, versão capturada, hora de recebimento e data de envio/edição da mensagem do Telegram. |
| Notificação de exclusão em tempo real | IDs das mensagens relatadas, hora de recebimento, notificação bruta e links para conteúdo salvo anteriormente. |
| Log de administração disponível | Ação, agente, data de origem e conteúdo da mensagem fornecida, lidos por uma conta com os direitos necessários. |
| Interação com o painel | A ação solicitada e seu resultado registrado na conta selecionada. |
| Verificar novamente | Resposta atual do Telegram comparada com a mensagem salva anteriormente. |
observed_at é o tempo em que o registro foi gravado no relógio do coletor e
aumenta com seq. Os registros gravados durante o processamento de uma atualização em tempo real também contêm
received_at, a hora em que a atualização chegou ao coletor, e
processing_delay_ms, o tempo decorrido entre a recepção e a gravação; as atualizações retidas durante o
início da observação são processadas na ordem de chegada, antes das posteriores. source_at
mantém uma data de origem quando o evento a fornece. Observações de deslocamento do relógio do telegrama,
registros de descontinuidade do relógio e verificações de tempo externas fornecem o
contexto temporal associado. Os campos de uma notificação de mensagem comum descrevem
essa notificação; os registros do log de administração e de interação mantêm suas próprias atribuições.
Instantâneos do histórico#
Um instantâneo solicita as mensagens visíveis mais recentes de uma fonte ativada, até
500 por solicitação. Os resultados são identificados como observações do histórico. Os instantâneos manuais
são executados paralelamente às observações. As observações repetidas
são mantidas como registros separados. Ao ativar uma fonte, também é gerado um instantâneo debaseline, a menos que
a opção chats selecionados esteja ativada.
Os instantâneos são interrompidos se a fonte for desativada durante a leitura. As respostas devem pertencer ao chat solicitado e conter IDs de mensagem positivos estritamente decrescentes, abaixo do limite solicitado. Uma resposta inválida interrompe o instantâneo antes que essa mensagem seja salva; as mensagens já preservadas permanecem no diário assinado com o registro da interrupção.
Os instantâneos seguem a política de anexos, mas permanecem separados das alternâncias de eventos em tempo real. Eles não reconstroem mensagens excluídas nem versões intermediárias perdidas. É possível solicitar um instantâneo enquanto o sistema estiver em pausa; quaisquer anexos na fila aguardam até que a observação comece e o processo de download seja executado.
A execução de Histórico é uma tarefa exclusiva e separada: lê as fontes selecionadas e baixa seus anexos pendentes sequencialmente, sem iniciar o monitoramento. Pausar libera a conta; retomar continua a execução salva. Para filtros de data, idioma e respostas em várias contas livres, consulte Exportação distribuída de chats.
Tratamento de anexos#
O download de anexos está ativado por padrão e é pausado quando resta menos de 1 GiB de espaço livre em disco. O coletor realiza o registro das mensagens e a tarefa de download simultaneamente. A tarefa mantém o descritor de mídia original e a política de tamanho, de modo que um anexo editado posteriormente não seja substituído silenciosamente.
Os downloads são executados após a captura da mensagem. Um download concluído cria um registro media.saved
com seu SHA-256
e contagem de bytes. Trabalhos ignorados, com falha, repetidos e interrompidos
têm resultados distintos; um arquivo é considerado preservado quando seu registro media.saved
existe.
O arquivo concluído também deve corresponder à contagem de bytes no descritor do anexo observado original.
Uma resposta curta ou inesperadamente longa não é registrada como mídia preservada.
O arquivo e sua entrada na pasta são gravados no disco antes que `media.saved` seja gravado. Quando o processo coletor anterior
foi encerrado sem uma parada ordenada, a próxima inicialização lê todos os arquivos registrados como salvos durante aquela execução. Um arquivo
que esteja faltando ou cujos bytes difiram do SHA-256 registrado recebe um registro media.missing_after_restart, seu
download é colocado na fila novamente e os bytes divergentes são movidos para a pasta media-damaged/. Arquivos movidos para armazenamento externo
não são lidos.
Dentro de um espaço de trabalho, tarefas em fila simultâneas para a mesma representação de anexo aguardam a transferência ativa e, em seguida, verificam novamente os bytes salvos antes de reutilizá-los. Cada tarefa mantém seu próprio resultado assinado e uma referência ao registro anterior do arquivo salvo. O cancelamento de uma tarefa em espera não cancela a transferência ativa; se essa transferência falhar ou for cancelada, a próxima tarefa poderá tentar novamente. Diferentes anexos podem ser baixados simultaneamente.
Tarefas com a mesma conta, representação, tamanho esperado e ação de captura permanecem na fila enquanto uma tarefa correspondente estiver em execução. Elas não ocupam vagas de download, portanto, outros arquivos podem ser iniciados mesmo quando a fila começa com muitas cópias de um arquivo lento. A conclusão de uma tentativa reativa a fila. As faixas de prioridade, os atrasos de repetição salvos e a propriedade do histórico continuam válidos; cada observação recebe seu próprio resultado.
As exportações do chat também compartilham uma transferência ativa para representações repetidas de arquivos dentro do mesmo diretório de exportação. Cada mensagem mantém sua referência de anexo, e a reutilização requer uma nova verificação de tamanho e SHA-256. Arquivos diferentes podem ser verificados em paralelo sem manter um bloqueio de transferência comum. Os caminhos temporários de download e cópia são exclusivos para cada operação; o cancelamento aguarda a conclusão de qualquer leitor de arquivo local ativo antes da limpeza. O índice de arquivos de exportação serializa apenas o acesso aos metadados, não o hash dos arquivos nem os downloads.
As leituras de hash no servidor para diferentes anexos também são executadas simultaneamente, compartilhando os três slots de solicitação de arquivo do cliente com downloads de bytes. Leituras repetidas da mesma representação reutilizam apenas um resultado completo armazenado em cache. As leituras de arquivo deixam a fila de solicitações comum livre; os prazos salvos do FloodWait são verificados novamente quando uma solicitação obtém um slot.
Os limites são definidos por tipo: fotos, vídeos, GIFs e animações, mensagens de vídeo circulares,
mensagens de voz, música e áudio, adesivos e arquivos. Cada tipo pode ser desativado e possui
seu próprio limite de tamanho, variando de 1 a 2.000 MiB; novos espaços de trabalho começam com 20 MiB para fotos,
100 MiB para vídeos, 50 MiB para arquivos, áudio e vídeos circulares, 20 MiB para mensagens de voz e GIFs e
5 MiB para adesivos. Novos espaços de trabalho mantêm GIFs e adesivos desativados até que sejam ativados. Espaços de trabalho
com políticas salvas antes da implementação dos limites por tipo mantêm todos os tipos ativados e conservam seu único
limite para cada tipo. O tamanho máximo de arquivo define todos os tipos de uma só vez. Um tipo desativado gera
um registro media.skipped; arquivos de tamanho desconhecido ou acima do limite não são baixados. Arquivos grandes recebem
tempo extra de download com base em seu tamanho e em uma velocidade de referência de 256 KiB/s. As tarefas sobrevivem
à reinicialização, mas referências expiradas, acesso perdido ou arquivos excluídos ainda podem impedir a recuperação.
Tarefas em espera mantêm o limite salvo com elas, de modo que um aumento no limite se aplica apenas a novos arquivos.
Desativar um tipo ou reduzir seu limite também ignora os arquivos em espera que ele exclui, cada um com
um registro media.skipped; desativar os downloads pausa a fila até que sejam reativados.
Pausar, bloquear, desconectar e reiniciar#
| Ação ou condição | Efeito |
|---|---|
| Alternar entre áreas de trabalho | Altera a exibição do painel; os demais coletores mantêm seu estado. |
| Bloqueie o painel ou feche uma aba | Mantém o servidor e a observação em funcionamento. |
| Observação sobre a pausa | Interrompe esse coletor e preserva o trabalho de anexos em fila. |
| Desativar uma fonte | Interrompe futuras capturas programadas; as tarefas de mídia agendadas para essa função ficam em espera enquanto ela estiver desativada. |
| Remover uma fonte | A ferramenta desconsidera-a como fonte e exclui os perfis de seus usuários; os registros já salvos permanecem no diário de gravação exclusiva. Seus anexos ainda pendentes são registrados como falhados (source_removed). Nos modos “pasta” e “conta inteira”, ela também é excluída. |
| Alterar a rota de conexão | Exige uma pausa, encerra clientes antigos e cancela logins inacabados. |
| Encerre o processo do Python | Interrompe todas as áreas de trabalho; nenhuma observação é feita enquanto estiver offline. |
| Reinício após observação ativa | Tenta retomar o escopo salvo utilizando a sessão salva. Uma pausa manual cancela essa intenção. |
O coletor registra desconexões detectadas, novas tentativas, erros, inícios/paradas e heartbeats. Interrupções curtas podem passar despercebidas pelas verificações periódicas de conectividade. Após uma reinicialização, as atualizações perdidas são solicitadas a partir da posição de atualização salva e os chats observados são verificados novamente periodicamente; consulte o formato de evidência. Um snapshot adiciona o estado atual como contexto, e a lacuna permanece registrada.
Isolamento e verificação de contas#
Cada espaço de trabalho possui seu próprio diário, autorização, chave de assinatura, política e fila. Apenas seu cliente ativo pode contribuir com observações em tempo real. Clientes rejeitados, pendentes, substituídos e em teste de conexão não podem gravar atualizações em tempo real em seu diário. Contas diferentes podem observar o mesmo grupo, mas seus diários permanecem separados.
Cada evento inclui o hash anterior e uma assinatura Ed25519. As exportações abrangem todo o diário da área de trabalho por meio de um número de sequência fixo. Os filtros do painel não filtram a exportação; a coleta pode continuar além de seus limites enquanto ela está sendo preparada.
A verificação do registro verifica a cadeia de eventos e as assinaturas por meio do limite exibido. Seu resultado é apagado quando o espaço de trabalho é alterado, e o painel identifica novos registros adicionados após a verificação. A exportação em ZIP também verifica as mídias coletadas.
Mantenha as impressões digitais e os pontos de verificação de forma independente. Consulte o escopo de verificação para verificações de aquisição em cada modo, e operações diárias para coleta de rotina.