# Telegram · Come funziona la raccolta dei dati

Canonical page: https://phishdestroy.io/tgwitness/it/docs/reference/collection/

Ambito di osservazione, aggiornamenti in tempo reale, ricontrolli, allegati, azioni intraprese e significato delle lacune, record per record.

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

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

Translation coverage: this edition includes material from the English original.

Ambito di osservazione, aggiornamenti in tempo reale, ricontrolli, allegati, azioni intraprese e significato delle lacune, record per record.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Documentazione](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Raccolta](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

![Raccolta](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69)

TgWitness registra ciò che osserva un account Telegram connesso. Il monitoraggio in tempo reale conserva i messaggi, le modifiche acquisite, le notifiche di cancellazione e gli allegati con i relativi tempi di osservazione e il contesto di origine. Le letture della cronologia, i ricontrolli e i record disponibili del registro di amministrazione aggiungono a quel record osservazioni identificate separatamente.

**In questa pagina**

- [Dal login al diario](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#from-login-to-a-journal)
- [Ambito di osservazione: chat selezionate, una cartella o l’intero account](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)
- [Ambito e selezione degli eventi](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#scope-and-event-selection)
- [Azioni proprie](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#own-actions)
- [Modalità Investigazione: entrare a far parte di team e comunicare con i bot](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots)
- [Livelli di ricontrollo](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#recheck-tiers)
- [Cronologia dei messaggi e attribuzione](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#message-history-and-attribution)
- [Istantanee storiche](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#history-snapshots)
- [Gestione degli allegati](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#attachment-handling)
- [Metti in pausa, blocca, disconnetti e riavvia](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#pause-lock-disconnect-and-restart)
- [Isolamento e verifica dell’account](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#account-isolation-and-verification)

## Dall’accesso al registro

Per le foto e i file autodistruggibili, consultare [Media autodistruggibili](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Vengono spiegati il worker prioritario, i risultati salvati e non disponibili, nonché i limiti del blocco delle conferme di lettura nel collettore API.

Diagramma di flusso · Autorizzare un account utente → Selezionare gruppi e canali accessibili; Selezionare gruppi e canali accessibili → Salvare le impostazioni relative agli eventi e agli allegati; Salvare le impostazioni relative agli eventi e agli allegati → Avviare l’osservazione; Avviare l’osservazione → Riceva gli aggiornamenti dal client attivo; Riceva gli aggiornamenti dal client attivo → Applicare la politica relativa alle fonti e agli eventi; Applicare la politica relativa alle fonti e agli eventi → Aggiungere un’osservazione firmata; Aggiungere un’osservazione firmata → Visualizzare o esportare il registro; Aggiungere un’osservazione firmata → Elaborare qualsiasi allegato in coda; Elaborare qualsiasi allegato in coda → Allegare il risultato del download · Autorizzare un accountutente · Selezionare gruppi ecanali accessibili · Salvare leimpostazioni relativeagli eventi e agliallegati · Avviare l’osservazione · Riceva gliaggiornamenti dalclient attivo · Applicare la politicarelativa alle fonti eagli eventi · Aggiungereun’osservazionefirmata · Visualizzare oesportare il registro · Elaborare qualsiasiallegato in coda · Allegare il risultatodel download

**Diagramma sotto forma di testo**

1. Autorizzare un account utente → Selezionare gruppi e canali accessibili
2. Selezionare gruppi e canali accessibili → Salvare le impostazioni relative agli eventi e agli allegati
3. Salvare le impostazioni relative agli eventi e agli allegati → Avviare l’osservazione
4. Avviare l’osservazione → Riceva gli aggiornamenti dal client attivo
5. Riceva gli aggiornamenti dal client attivo → Applicare la politica relativa alle fonti e agli eventi
6. Applicare la politica relativa alle fonti e agli eventi → Aggiungere un’osservazione firmata
7. Aggiungere un’osservazione firmata → Visualizzare o esportare il registro
8. Aggiungere un’osservazione firmata → Elaborare qualsiasi allegato in coda
9. Elaborare qualsiasi allegato in coda → Allegare il risultato del download

L’autorizzazione, l’accesso a una fonte, un collettore in esecuzione e la consegna completa sono questioni distinte. Un accesso riuscito non garantisce l’accesso a tutti i gruppi. La consegna viene tracciata separatamente: i record di copertura, il recupero dei gap di aggiornamento e le ricontrolli mostrano ciò che è pervenuto.

## Ambito di monitoraggio: chat selezionate, una cartella o l’intero account

**Altri strumenti → Fonti → L’ambito** determina quali chat vengono registrate da un’area di lavoro.

La nuova configurazione inizia con **Scegli chat**. Le scelte già salvate vengono mantenute. Se si seleziona " **Tutte le chat"** nella procedura guidata di configurazione, viene richiesta una conferma quando l'elenco caricato contiene più di 50 chat; la stima delle dimensioni rimane un'operazione separata, basata su un campione.

| Modalità | Registrazioni | Nuove chat |
| --- | --- | --- |
| Chat selezionate (impostazione predefinita) | Solo le chat che aggiungete manualmente | Non viene mai aggiunto automaticamente |
| Cartella Telegram | Chat presenti in una delle cartelle dell’account: chat incluse in base al nome, più le categorie della cartella (contatti, non contatti, gruppi, canali, bot), meno le chat escluse e, se la cartella lo specifica, le chat archiviate | Le chat corrispondenti vengono aggiunte non appena diventano attive; le chat che si aggiungono alla cartella in Telegram vengono acquisite entro un’ora |
| Account completo | Ogni chat a cui l’account ha accesso | Ogni nuova chat, gruppo, chat privata o bot viene aggiunto non appena viene registrato il suo primo aggiornamento |

- **I tipi di fonte** (canali, gruppi, chat private, bot) limitano le modalità “cartella” e “intero account”. Le chat selezionate possono essere di qualsiasi tipo, comprese le chat private e i bot; i tipi di fonte non bloccano mai una chat aggiunta manualmente. La disattivazione di un tipo, un’esclusione o il passaggio alle chat selezionate interrompe le fonti aggiunte automaticamente non appena viene salvato, prima che l’elenco delle fonti venga ricalcolato e anche quando Telegram non è raggiungibile: i loro nuovi messaggi, la cronologia, la cronologia delle nuove chat, le impostazioni dei peer e le osservazioni sul profilo.
- **Le chat aggiunte manualmente** rimangono registrate nelle modalità “cartella” e “intero account” anche quando si trovano al di fuori della cartella; solo *le operazioni Escludi*, *Rimuovi* o una pausa ne interrompono la registrazione. Le chat aggiunte (*automaticamente*) in base all’ambito seguono la cartella: quelle che escono dalla cartella vengono messe in pausa al successivo ricalcolo.
- **Le chat escluse** non vengono mai registrate, in nessuna modalità. Nelle modalità “Cartella” e “Intero account”, *le opzioni Escludi* e *Rimuovi* su una chat di origine la inseriscono in questo elenco, in modo che lo scope non la aggiunga nuovamente. Selezionando nuovamente la chat manualmente (in «Fonti», da «Chat» o in «Impostazioni» → **Quali chat?**) viene rimossa dall’elenco. L’elenco può contenere fino a 5.000 chat; superato tale limite, *l’operazione Rimuovi* viene rifiutata e è invece possibile mettere in pausa la chat.
- **Azioni proprie** (attivate per impostazione predefinita): i messaggi inviati da questo account, le relative modifiche e le pressioni dei tasti della tastiera di risposta. Se disattivata, i messaggi in uscita e le modifiche vengono ignorati.
- Il passaggio a una cartella o all’intero account richiede una conferma: queste modalità registrano le chat private e i messaggi di terzi e devono essere utilizzate esclusivamente su un account dedicato. La conferma e ogni modifica dell’ambito sono registrate nei record `scope.changed`. Su un account configurato come principale, il modulo dell’ambito e la funzione «Investigation» non consentono di selezionare una cartella o l’intero account, così come non lo consente la funzione «Start»; è possibile utilizzarli solo per una copia una tantum senza registrazione.
- Le chat aggiunte dallo scope appaiono come sorgenti contrassegnate come *auto*, registrate come `scope.applied` (all'avvio e ogni ora) o `source.discovered` (una nuova chat durante l'osservazione). Tornando alle chat selezionate, tutte le sorgenti aggiunte automaticamente vengono messe in pausa contemporaneamente, senza leggere nuovamente l' elenco delle chat dell'account. Una chat esclusa smette di essere registrata non appena l’ambito viene salvato, e la sua sorgente viene messa in pausa anche quando Telegram non restituisce l’elenco delle chat. Durante l’ osservazione, il salvataggio dell’ambito lo applica nuovamente, anche se i valori non sono cambiati.

Ambito di applicazione di queste modalità:

- **Le chat segrete** utilizzano l'[integrazione pseudo-segreta](https://phishdestroy.io/tgwitness/it/docs/reference/secret-chats/) inclusa, con un modulo di protocollo installato dal pannello di controllo e un'opzione di abilitazione per ogni account. La cronologia su cloud e Takeout utilizzano un percorso di acquisizione separato.
- **Periodi offline.** Dopo un riavvio, TgWitness riprende dalla posizione di aggiornamento salvata, richiede a Telegram gli aggiornamenti mancanti e ricontrolla le chat. Telegram mantiene un backlog limitato, quindi dopo un’interruzione prolungata, i report e `verify.py` indicano l’intervallo rimanente come una lacuna (vedi [copertura](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)).
- All’inizio vengono elencate solo le prime 1,000 conversazioni (il limite è impostabile in **Altri strumenti → Parametri**); le chat più vecchie vengono aggiunte quando tornano attive. La cronologia precedente di una chat aggiunta non viene recuperata: crea uno snapshot della cronologia o esporta l’intera chat quando ne hai bisogno.
- Le condizioni delle cartelle soggette a continue variazioni (silenzioso, letto) non vengono applicate: tali chat rimangono sotto osservazione.
- **I pulsanti del bot in linea (callback)** premuti in un’altra app risultano invisibili a una seconda sessione; la risposta o la modifica del bot viene registrata. Le pressioni dei tasti di risposta arrivano come messaggi in uscita e sono contrassegnate con il codice `button_press`.
- Un numero maggiore di chat comporta un numero maggiore di richieste. Telegram limita gli account in caso di volumi che ritiene eccessivi, il che costituisce un motivo in più per utilizzare account dedicati.

### Chat selezionate con criteri rigorosi

**Modalità rigorosa: solo le chat selezionate** vengono visualizzate nella sezione **Chat selezionate** e questa opzione è disattivata per impostazione predefinita. È pensata per un'autorizzazione che copre esclusivamente le chat selezionate. Quando è attivata:

- Le notifiche di servizio di Telegram (777000) non vengono lette: né all'inizio né alla fine dell'osservazione, né ogni minuto durante l'osservazione. Non vengono scritti record relativi a `session.security_baseline` o `account.security_event`.
- L'elenco delle sessioni dell'account non viene letto: né all'inizio né alla fine dell'osservazione (viene saltata anche la domanda del pannello relativa alle altre sessioni per **le prove di un caso** e alle modalità di protezione delle prove), né ogni due minuti durante l'osservazione, né all'apertura di una connessione, né dal controllo della connessione, la cui *voce di autorizzazione Current*viene visualizzata come saltata. Anche lo stato della verifica in due passaggi utilizzato dal controllo di subentro non viene letto. Pertanto, `account.sessions`, `session.concurrent_at_start` e `session.takeover_risk` non vengono scritti, e una sessione terminata da un altro dispositivo non viene segnalata come `session_revoked_externally`.
- Sebbene questa sia l'unica sessione dell'account (**impostare questa come unica sessione** o la sua versione automatica), l' elenco delle sessioni viene comunque letto ogni due minuti durante il monitoraggio e quando si apre una connessione, in modo che venga registrato `session.exclusive_ended` quando compare un'altra sessione. 777000 rimane non letto in quel periodo, sebbene il record `session.exclusive_from` indichi che le notifiche di accesso a Telegram continuano a essere registrate.
- Le notifiche di cancellazione vengono confrontate con un controllo delle sessioni solo se ne è stato eseguito uno negli ultimi 10 minuti (purché si tratti dell’ unica sessione, oppure dopo aver aperto **le sessioni di questo account**). In caso contrario, a meno che l'ultimo controllo dei diritti non indichi che questo account non potesse eliminare il messaggio (cosa che non accade mai nelle chat private e nei gruppi ordinari), viene visualizzato il messaggio: *Non è noto chi lo abbia eliminato: potrebbe averlo eliminato anche lo stesso account, da un'altra sessione o da un altro dispositivo.*
- Con una chiave di sessione importata, nel registro non è indicato l'orario di accesso a tale sessione fino a quando non viene letta la lista delle sessioni (ad esempio nella sezione **Sessioni di questo account**). Fino a quel momento, le esportazioni delle chat e le esportazioni **automatiche** degli account utilizzano la sessione standard anziché Takeout, con il motivo `session_age_unknown`.
- Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history.
- L'impostazione relativa ai contenuti sensibili dell'account non viene né letta né modificata. Senza l'attivazione dell'opzione, l'accesso e ogni nuova connessione la attivano quando è disattivata e Telegram consente la modifica (`account.content_settings`); l'impostazione appartiene all'account e si applica in tutte le app di Telegram. I contenuti che Telegram contrassegna come sensibili potrebbero rimanere nascosti.
- Gli aggiornamenti relativi alle telefonate non vengono registrati come `account.phone_call`.
- L'interruzione dell'osservazione registra solo l'impronta digitale della chiave di sessione; non legge né l'elenco delle sessioni né il 777000.

Non limita ciò che Telegram invia: gli aggiornamenti di ogni chat continuano a raggiungere questa sessione, e solo le chat selezionate vengono registrate. L’elenco delle chat dell’account (fino **alle chat lette dall’elenco dell’account**) e le relative cartelle vengono ancora letti all’avvio, e nuovamente quando l’ambito viene salvato durante l’osservazione, per individuare le chat selezionate. Gli avvisi di cancellazione senza una chat (``deletion.unscoped``) vengono comunque registrati: contengono solo gli ID dei messaggi e possono appartenere a una chat privata selezionata o a un gruppo ordinario. Il controllo degli account congelati (`help.getAppConfig`), gli altri controlli di connessione e le funzionalità che si attivano manualmente (chiusura automatica di altre sessioni, la sonda testimone, le chat pseudo-segrete, **le sessioni di questo account** e l’elenco di Telegram dei dispositivi connessi alla voce **Altri testimoni**, che legge l’elenco delle sessioni ad ogni passaggio del timestamp e che imposta i tick per gli obiettivi **Segui le chat** e **Prove per un caso**) continuano a funzionare.

Attivalo prima di effettuare l'accesso; in caso contrario, l'accesso stesso verifica l'autorizzazione corrente e attiva i contenuti sensibili. Ogni modifica è rappresentata da un record firmato `scope.changed`, mentre `observation.started` contiene il valore come `scope.strict`. Passando a una cartella o all'intero account, la funzione viene disattivata.

## Ambito di applicazione e selezione degli eventi

Ogni area di lavoro dispone delle proprie fonti. TgWitness non si unisce a gruppi, non accetta inviti né elenca automaticamente tutti i membri. Le fonti devono essere già accessibili all’account. All’avvio, il collettore verifica le fonti selezionate rispetto alle chat visibili dell’account; vengono ispezionate le prime 1,000 chat, a meno che **la voce Altri strumenti → Parametri → Chat lette dall’elenco dell’account** non indichi diversamente. Una fonte assente viene contrassegnata come **accesso non confermato**, non si presume che ti abbia rimosso.

| Contesto | Raccoglie | Effetto in caso di disattivazione |
| --- | --- | --- |
| Nuovi messaggi | Messaggi ordinari inviati | Le modifiche o le cancellazioni successive potrebbero non avere testo acquisito in precedenza con cui effettuare un confronto. |
| Modifiche | Versioni modificate dei messaggi fornite | Le modifiche intermedie non vengono ricostruite in un secondo momento. |
| Cancellazioni | Notifiche di cancellazione con ambito specifico e notifiche a livello di account senza ambito specifico | Le notifiche di cancellazione non vengono aggiunte al registro. |
| Reazioni | Istantanee delle reazioni fornite | Non vengono aggiunti aggiornamenti separati relativi alle reazioni. |
| Iscrizione | Invio di messaggi relativi al servizio di abbonamento e aggiornamenti ai partecipanti | Tali osservazioni relative all’iscrizione non vengono aggiunte. |

Le impostazioni si applicano a tutte le fonti selezionate nell’area di lavoro. Salvi il modulo per applicare le modifiche; queste vengono registrate con valori «prima» e «dopo» firmati. La disattivazione di una categoria non comporta la rimozione dei record precedenti. La sua riattivazione non recupera gli aggiornamenti mancanti.

I registri operativi e altri eventi relativi ai servizi di gruppo rimangono distinti da queste impostazioni. I messaggi relativi al servizio di iscrizione possono generare registrazioni dei messaggi quando l’iscrizione è abilitata, anche se la normale acquisizione dei nuovi messaggi è disabilitata. Gli oggetti Telegram acquisiti conservano i metadati incorporati; un’impostazione non costituisce una regola di oscuramento.

**Le cancellazioni nelle chat private e nei gruppi ordinari** arrivano come ID di messaggio senza una chat associata. Queste chat condividono un’unica sequenza di ID di messaggio a livello di account, quindi quando un messaggio con quell’ID è stato salvato in precedenza, la sua chat è nota: la cancellazione viene registrata in quella chat con il `chat_resolution` che ne spiega il motivo. Gli ID mai salvati rimangono una **cancellazione senza ambito** con una chat esplicitamente non risolta. Si tratta di notifiche di cancellazione di Telegram, conservate anche quando la loro chat non può ancora essere correlata. Lo schema della notifica contiene gli ID; il registro aggiunge l’ora di ricezione ed eventuali contesti dei messaggi salvati, incluso il `deleted_message_was_outgoing`. Le voci disponibili nel registro di amministrazione forniscono una fonte separata dell’azione, dell’autore e dell’ora di origine.

## Azioni proprie

I messaggi inviati dall’account monitorato sono contrassegnati con `outgoing`. Una modifica di un messaggio in uscita indica che nelle chat private e nei gruppi solo il suo autore può modificarlo, mentre i post nei canali possono essere modificati da altri amministratori. Quando un messaggio in uscita ripete il testo di un pulsante presente nella tastiera delle risposte salvate più recenti in quella chat, viene contrassegnato con `button_press`, con un link al registro della tastiera.

L’esclusione delle proprie azioni si applica anche alle verifiche in background e alla cronologia automatica delle nuove chat. I messaggi in uscita saltati fanno avanzare la posizione di verifica, in modo che non possano bloccare i messaggi in arrivo successivi. Le azioni esplicite effettuate dal pannello e le istantanee della cronologia richieste manualmente rimangono registrate.

## Modalità di indagine: entrare a far parte di team e interagire con i bot

**Altri strumenti → Fonti → Ambito → La modalità Investigazione** prepara l’ambito per un account dedicato che si unisce alle chat di gruppo, avvia i bot e scrive su di essi: l’intero account, ogni tipo di fonte, le proprie azioni e, per ogni chat o bot che appare, il suo profilo e i suoi ultimi 200 messaggi visibili. Rivedere il modulo e premere **Salva ambito**; il passaggio all’intero account richiede la consueta conferma.

- **Pulsanti.** I pulsanti presenti sotto un messaggio vengono conservati insieme ad esso e visualizzati nelle **chat**: link, app web, link di accesso, testi da copiare, dati di richiamata, query in linea, richieste di un numero di telefono o di una posizione. I link vengono visualizzati come testo e non vengono mai aperti dal pannello. Quando un bot modifica solo i pulsanti (ad esempio, un nuovo link di pagamento), si tratta di una nuova versione del messaggio, sia in caso di aggiornamenti in tempo reale che di ricontrolli.
- **Nuove chat e bot.** Nelle modalità «per cartella» e «intero account», **quando compare una nuova chat o un nuovo bot**, viene salvata immediatamente dopo la sua comparsa:

  - il suo profilo come record `source.profile`: descrizione del bot e comandi, il testo «Informazioni su» di un utente, gruppo o canale, membri, chat collegata e link di invito quando Telegram ne fornisce uno;
  - i suoi ultimi messaggi visibili (fino a 1.000) come istantanea della cronologia contrassegnata con `new_chat`: i messaggi precedenti di una chat di gruppo a cui si è appena aderito, oppure ciò che un bot ha detto prima che l’osservazione rilevasse la chat. I messaggi già salvati in tempo reale non vengono ripetuti.

  Le chat appena selezionate utilizzano queste impostazioni quando viene applicato l’ambito, comprese le chat già presenti nell’elenco delle conversazioni dell’account. Il caricamento iniziale del profilo e della cronologia viene eseguito per un massimo di tre chat contemporaneamente; le operazioni relative alla stessa chat vengono eseguite in ordine. Ogni fase della cronologia/del profilo utilizza il timeout di operazione configurato, quindi le richieste bloccate liberano il proprio worker. La cronologia viene salvata prima della lettura opzionale del profilo; un errore nel profilo non impedisce l’acquisizione della cronologia. Le fasi fallite vengono riprovate dopo 5 secondi, raddoppiando fino a un massimo di 5 minuti senza occupare un worker durante il ritardo. Gli ID in sospeso, le scadenze per i tentativi e le fasi completate vengono salvati localmente. Un riavvio riprende solo le fasi non completate; un nuovo tentativo di lettura del profilo non ripete una lettura della cronologia già completata. Le fonti disabilitate prima del loro turno vengono saltate. La panoramica mostra i caricamenti delle chat attivi, in sospeso e in fase di riprova separatamente dai download degli allegati. Un FloodWait mette in pausa questo lavoro, che riprende in seguito; gli errori vengono registrati e la registrazione in tempo reale della chat continua. Ciò include le attese durante la risoluzione dell’identità della nuova chat: l’attività in sospeso relativa al profilo/alla cronologia viene mantenuta per un nuovo tentativo, mentre un’attesa esistente più lunga a livello di account non viene abbreviata. I worker condividono questa attesa; la concorrenza non aggira i limiti di richiesta di Telegram. - **Profili su richiesta.** **Chat → Profilo → Salva profilo ora** salva il profilo corrente di qualsiasi fonte; quello più recente viene visualizzato sopra i messaggi. - **Istantanee dello stato delle chat (anteprima).** Lo stato al di fuori del flusso dei messaggi cambia senza un messaggio: sbloccare ogni messaggio non lascia tracce a livello di messaggio, un amministratore perde i diritti, un regalo viene nascosto, convertito, aggiornato o rimborsato. Durante l’osservazione, ogni fonte abilitata viene letta periodicamente e salvata come un record firmato `chat.state` : titolo, nomi utente, descrizione, numero di membri e amministratori, chat collegate, modalità lenta, ID dei messaggi fissati (fino a 100), amministratori con i relativi diritti e titoli, e regali visualizzati sui canali e sui profili utente (fino a 100). Ogni record elenca le differenze rispetto all’istantanea precedente: campi modificati con i valori precedenti e successivi, messaggi in evidenza aggiunti o rimossi, amministratori e regali aggiunti, modificati o non più elencati. - Una parte che Telegram rifiuta (ad esempio l’elenco degli amministratori di un canale per un membro che non è amministratore) viene indicata in `errors`; il suo valore precedente viene mantenuto ed elencato in `carried_forward`, senza mai essere segnalata come rimossa. - Un record le cui uniche modifiche riguardano i conteggi, e una verifica che non ha rilevato alcuna modifica, si riferiscono all’ ultimo stato completo con `state_seq` e cumulativo `state_overrides`. Uno stato completo viene salvato almeno ogni sette giorni e ogni volta che cambia qualcosa che non sia un conteggio. - `parts_complete` contrassegna gli elenchi con limite massimo. Le aggiunte richiedono un elenco precedente completo, le rimozioni richiedono un elenco attuale completo, mentre i valori vuoti espliciti indicano la cancellazione dei record. - **Altri strumenti → Parametri → Stato della chat** consente di impostare l’intervallo (12 ore per impostazione predefinita, 0 disattiva le istantanee ), la pausa tra le fonti, quali parti vengono lette e se i controlli che non hanno rilevato alcuna modifica vengono registrati. `FLOOD_WAIT` e `FLOOD_PREMIUM_WAIT` interrompono le restanti richieste di snapshot, mantengono eventuali scadenze più lunghe a livello di account e lasciano la chat interrotta idonea per un altro tentativo dopo tale attesa. - **Non visibile.** I pulsanti in linea (callback) premuti in un’altra app di Telegram, il popup o il link con cui un bot risponde a tale pressione e i link di invito utilizzati in un’altra app non raggiungono TgWitness. Ciò che il bot invia o modifica in seguito viene registrato.

### Intervento dal panel

**La sezione «Chat»** include ora un mini-client che utilizza l’account Telegram dell’area di lavoro selezionata:

- Scriva un messaggio in testo semplice oppure selezioni **«Rispondi»** sotto un messaggio salvato. Il messaggio in uscita generato viene registrato anche quando l’ambito di analisi esclude gli aggiornamenti in uscita.
- Premere **il pulsante «Press»** sotto un pulsante di callback o di testo attivo. Il server recupera nuovamente il messaggio e rifiuta l’azione se la digitazione differisce dalla versione salvata. Le conferme di ricezione dei callback conservano il testo del popup di Telegram, il flag di avviso e l’URL; la risposta viene inoltre visualizzata sotto la conversazione. Gli URL rimangono testo selezionabile e non vengono aperti automaticamente.
- Premi **+** → **Apri link Telegram**, inserisci `@username`, un link pubblico `https://t.me/name`, `https://t.me/+invite` / `joinchat/invite`, oppure un link bot con `?start=parameter`, quindi premi **Salva anteprima**. Il link originale e l'anteprima di Telegram vengono firmati prima dell'adesione. **Entra / apri e osserva**: a questo punto l'utente entra nel gruppo/canale oppure apre l'utente/bot, aggiunge la chat come fonte abilitata e invia `/start` a un bot, includendo il suo parametro di avvio. Una richiesta di adesione in attesa dell'approvazione dell'amministratore viene registrata come in sospeso, non come adesione effettiva.

Attivare **Avvia osservazione** per acquisire in tempo reale le risposte in arrivo. Le azioni del pannello funzionano mentre l’osservazione è in pausa; il pannello salva quindi le proprie risposte dirette, mentre l’ osservazione in tempo reale acquisisce il resto della conversazione. Le fonti appena aggiunte utilizzano l’acquisizione del profilo/cronologia configurata quando l’osservazione è in esecuzione. Quando una fonte è in pausa, abilitarla in **Altri strumenti → Fonti** prima di inviare o premere i relativi pulsanti.

`interaction.preview`, `interaction.requested` e `interaction.result` sono normali eventi del registro firmati inclusi nelle esportazioni delle prove. Le richieste identificano l’account, il messaggio/pulsante o il record di anteprima e indicano se l’osservazione era in esecuzione. Le conferme distinguono tra esito positivo, rifiuto, approvazione in sospeso e esito sconosciuto. Una richiesta interrotta potrebbe essere giunta a Telegram: si prega di controllare la chat prima di avviare una nuova azione. Il riutilizzo di un ID di richiesta consente di recuperare la relativa ricevuta salvata senza ripetere l’azione, anche dopo il riavvio. Il pannello conserva l’ ID in caso di risposta ambigua per la stessa azione durante la sessione corrente della pagina. Conserva inoltre tale ID quando l’aggiornamento della visualizzazione fallisce dopo un’azione riuscita: la ricevuta rimane visibile e, cliccandoci nuovamente, la si recupera. Gli RPC di callback e join dispongono di un unico tentativo; le letture riprovabili mantengono la politica di riprova configurata. Il passaggio a un’altra chat cancella immediatamente la bozza e il destinatario della risposta e disabilita l’invio fino al caricamento della nuova conversazione.

Questo mini-client gestisce i pulsanti di testo e di callback. I pulsanti delle mini-applicazioni attivano l'opzione **Apri mini-app**, che avvia l'applicazione in un browser isolato ([Mini-applicazioni](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Le richieste di accesso, di numero di telefono e di posizione, i pagamenti, le query in linea e gli allegati richiedono comunque un client Telegram; i metadati dei pulsanti salvati rimangono visibili. I nuovi controlli utilizzano testo in inglese.

## Livelli di ricontrollo

I ricontrolli richiedono nuovamente a Telegram i messaggi mancanti, le modifiche e i messaggi che non restituisce più. Le fonti contrassegnate da una stella sono fonti **prioritarie**, ricontrollate ogni 15 minuti per impostazione predefinita; tutte le altre fonti ogni 6 ore. Le chat selezionate partono come fonti prioritarie, mentre quelle aggiunte tramite una cartella o l’intero account come fonti regolari. Vengono ricontrollate al massimo 30 fonti per ogni ciclo e le restanti attendono il minuto successivo; dopo una riconnessione, le fonti prioritarie vengono elaborate per prime. Entrambi gli intervalli sono impostati in **Altri strumenti → Fonti → Registrazione → Ricontrollo** (0 disattiva un livello) e vengono registrati come `recheck.changed`.

I messaggi persi vengono recuperati a partire dal punto in cui si era interrotto il passaggio precedente, fino a un massimo di **Altri strumenti → Parametri → Messaggi persi recuperati per chat e passaggio** (1,000 per impostazione predefinita). Dopo una lunga interruzione, la ricontrollo colma quindi l’intero gap, anche quando i messaggi in tempo reale più recenti rispetto al gap sono stati salvati per primi. Una chat che sta ancora recuperando il ritardo viene ricontrollata nuovamente nel minuto successivo invece di attendere il proprio intervallo di livello; `recheck.completed` mostra `continues_after` fino al completamento dell’operazione.

I confronti includono il testo dei messaggi, le entità, le sequenze di tastiera (compresa la cancellazione) e il contenuto/l’identità degli allegati. La semplice modifica degli hash di accesso ai file o dei riferimenti ai file non costituisce una modifica, né lo è ciò che Telegram inserisce autonomamente: il caricamento dell’anteprima di un link, le visualizzazioni delle storie, i contenuti multimediali a pagamento sbloccati da questo account, la ricezione di una fattura. Ogni versione salvata in «Chat» rimanda al relativo record completo nel registro, compresi i metadati dei contenuti multimediali.

## Cronologia dei messaggi e attribuzione

Supponiamo che il sistema di raccolta rilevi «Riunione alle 10:00», poi rilevi «Riunione alle 11:00» e infine riceva una notifica di cancellazione. Il sistema aggiunge tre osservazioni distinte: il testo originale rimane, la modifica costituisce una versione separata e la notifica registra che è stata rilevata una cancellazione.

Se la raccolta è iniziata dopo la scomparsa della prima versione, tale testo non è disponibile. Se sono state apportate diverse modifiche mentre il processo era offline, è possibile salvare solo le versioni osservate successivamente. Una notifica di cancellazione non consente di recuperare contenuti mai acquisiti.

Il record combina diverse fonti:

| Fonte | Informazioni conservate |
| --- | --- |
| Messaggio in tempo reale o aggiornamento di modifica | ID del messaggio, metadati del mittente, versione acquisita, ora di ricezione e data di invio/modifica del messaggio Telegram. |
| Notifica di cancellazione in tempo reale | ID dei messaggi segnalati, ora di ricezione, notifica grezza e link a contenuti salvati in precedenza. |
| Log di amministrazione disponibile | Azione, autore, data di origine e contenuto del messaggio fornito, letti da un account dotato dei diritti necessari. |
| Interazione con il pannello | L’azione richiesta e il relativo risultato registrato nell’ambito dell’account selezionato. |
| Ricontrollare | Risposta attuale di Telegram rispetto al messaggio salvato in precedenza. |

`observed_at` è l'ora in cui il record è stato scritto sull'orologio del collettore e aumenta con `seq`. Anche i record scritti durante la gestione di un aggiornamento in tempo reale riportano `received_at`, ovvero il momento in cui l'aggiornamento ha raggiunto il collettore, e `processing_delay_ms`, il tempo trascorso dalla ricezione alla scrittura; gli aggiornamenti trattenuti mentre iniziano le osservazioni vengono elaborati in ordine di arrivo prima di quelli successivi. `source_at` conserva una data di origine qualora l’evento ne fornisca una. Le osservazioni relative all’offset dell’orologio dei telegrammi, i record di discontinuità dell’orologio e [i controlli temporali esterni](https://phishdestroy.io/tgwitness/it/docs/reference/timestamp/) forniscono il contesto temporale associato. I campi di una normale notifica di messaggio descrivono tale notifica; i record del registro di amministrazione e di interazione conservano le proprie attribuzioni.

## Istantanee storiche

Uno snapshot richiede gli ultimi messaggi visibili da una fonte abilitata, fino a 500 per richiesta. I risultati vengono etichettati come osservazioni storiche. Gli snapshot manuali vengono eseguiti parallelamente alle osservazioni. Le osservazioni ripetute vengono conservate come record separati. L'attivazione di una fonte comporta anche l'acquisizione di uno snapshot di r`baseline`, a meno che non sia attiva [l'opzione Chat selezionate](https://phishdestroy.io/tgwitness/it/docs/reference/collection/#strict-chosen-chats).

Gli snapshot vengono interrotti se la fonte viene disabilitata durante la lettura. Le risposte devono appartenere alla chat richiesta e contenere ID di messaggio positivi in ordine rigorosamente decrescente, inferiori al limite richiesto. Una risposta non valida interrompe lo snapshot prima che quel messaggio venga salvato; i messaggi già conservati rimangono nel giornale firmato insieme alla registrazione dell'interruzione.

Le istantanee rispettano la politica relativa agli allegati, ma rimangono separate dagli eventi in tempo reale. Non ricostruiscono i messaggi cancellati né le versioni intermedie mancanti. È possibile richiederne una mentre il sistema è in pausa; eventuali allegati in coda attendono l’inizio dell’osservazione e l’esecuzione del processo di download.

L’esecuzione **Cronologia** è un’attività esclusiva separata: legge le fonti selezionate e scarica in sequenza gli allegati in coda, senza avviare il monitoraggio. La pausa libera l’account; la ripresa continua l’esecuzione salvata. Per filtri di data, lingua e risposte su più account liberi, vedi [Esportazione distribuita delle chat](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md).

## Gestione degli allegati

Il download degli allegati è attivo per impostazione predefinita e viene sospeso quando lo spazio libero su disco è inferiore a 1 GiB. Il collettore esegue contemporaneamente l’ osservazione dei messaggi e l’operazione di download. L’operazione conserva il descrittore multimediale originale e le impostazioni relative alle dimensioni, pertanto un allegato modificato in un secondo momento non viene sostituito in modo silenzioso.

I download vengono eseguiti dopo l’acquisizione dei messaggi. Un download completato crea un record `media.saved` con il relativo SHA-256 e il conteggio dei byte. Le operazioni saltate, fallite, riprovate e interrotte hanno esiti distinti; un file è considerato conservato quando esiste il relativo record `media.saved` . Il file completato deve inoltre corrispondere al conteggio dei byte presente nel descrittore dell’allegato osservato originariamente . Una risposta breve o inaspettatamente lunga non viene registrata come contenuto multimediale conservato.

Il file e la relativa voce nella cartella vengono salvati su disco prima che venga scritto il campo `media.saved`. Quando il processo del collector precedente si è terminato senza un arresto ordinato, al successivo avvio vengono letti tutti i file registrati come salvati durante quell’esecuzione. Un file mancante o i cui byte differiscono dallo SHA-256 registrato riceve un record `media.missing_after_restart`, il suo download viene rimesso in coda e i byte divergenti vengono spostati nella cartella `media-damaged/`. I file spostati nell’archivio esterno non vengono letti.

All’interno di uno stesso spazio di lavoro, i processi in coda in contemporanea relativi alla stessa rappresentazione di allegato attendono il trasferimento attivo, quindi ricontrollano i byte salvati prima di riutilizzarli. Ciascun processo conserva il proprio risultato con segno e il riferimento al precedente record del file salvato. L’annullamento di un processo in attesa non annulla il trasferimento attivo; se tale trasferimento fallisce o viene annullato, il processo successivo può riprovare. È possibile scaricare contemporaneamente allegati diversi.

I processi con lo stesso account, la stessa rappresentazione, la stessa dimensione prevista e la stessa azione di acquisizione rimangono in coda mentre è in esecuzione un processo corrispondente. Non occupano slot di download, quindi è possibile avviare altri file anche quando la coda contiene inizialmente molte copie di un file lento. Il completamento di un tentativo riattiva la coda. Le corsie prioritarie, i ritardi di riprova salvati e la proprietà della cronologia rimangono validi; ogni osservazione riceve il proprio risultato.

Le esportazioni via chat condividono inoltre un trasferimento attivo per le rappresentazioni ripetute dei file all’interno della stessa directory di esportazione. Ogni messaggio conserva il proprio riferimento all’allegato e il riutilizzo richiede una nuova verifica delle dimensioni e dell’hash SHA-256. È possibile controllare file diversi in parallelo senza mantenere un blocco di trasferimento comune. I percorsi temporanei di download e copia sono univoci per ciascuna operazione; in caso di annullamento, il sistema attende che eventuali lettori di file locali attivi abbiano terminato l’operazione prima di procedere alla pulizia. L’indice dei file di esportazione serializza solo l’accesso ai metadati, non l’hash dei file né i download.

Anche le letture dell'hash sul server relative a diversi allegati vengono eseguite in parallelo, condividendo i tre slot di richiesta file del client con i download di byte. Le letture ripetute della stessa rappresentazione riutilizzano solo un risultato completo presente nella cache. Le letture dei file lasciano libera la coda delle richieste ordinaria; le scadenze FloodWait salvate vengono ricontrollate quando una richiesta ottiene uno slot.

I limiti sono impostati **per tipo**: foto, video, GIF e animazioni, messaggi video circolari, messaggi vocali, musica e audio, adesivi e file. Ogni tipo può essere disattivato e presenta un proprio limite di dimensione compreso tra 1 e 2.000 MiB; i nuovi spazi di lavoro partono con 20 MiB per le foto, 100 MiB per i video, 50 MiB per file, audio e video circolari, 20 MiB per messaggi vocali e GIF e 5 MiB per gli adesivi. Nei nuovi spazi di lavoro, le GIF e gli adesivi rimangono disattivati finché non vengono attivati. Gli spazi di lavoro con criteri salvati prima dell’introduzione dei limiti per tipo mantengono tutti i tipi abilitati e conservano il loro unico limite per ciascun tipo. *La dimensione massima dei file* viene impostata contemporaneamente per tutti i tipi. Un tipo disattivato genera un record `media.skipped`; i file di dimensioni sconosciute o eccessive non vengono scaricati. Ai file di grandi dimensioni viene assegnato un tempo di download aggiuntivo in base alle loro dimensioni e a una velocità di base di 256 KiB/s. I processi sopravvivono al riavvio, ma i riferimenti scaduti, l’accesso perso o i file eliminati possono comunque impedire il recupero. I processi in attesa mantengono il limite salvato con essi, pertanto un aumento del limite si applica solo ai nuovi file. La disattivazione di un tipo o la riduzione del relativo limite comporta inoltre il salto dei file in attesa da esso esclusi, ciascuno con un record `media.skipped`; la disattivazione dei download mette in pausa la coda fino a quando non vengono riattivati.

## Messa in pausa, blocco, disconnessione e riavvio

| Azione o condizione | Effetto |
| --- | --- |
| Cambia area di lavoro | Modifica la visualizzazione del pannello; gli altri collettori mantengono il proprio stato. |
| Bloccare il pannello o chiudere una scheda | Il server e il sistema di monitoraggio rimangono attivi. |
| Osservazione in pausa | Interrompe il funzionamento di quel collettore e preserva il lavoro relativo agli allegati in coda. |
| Disattivare una fonte | Blocca la futura acquisizione mirata; i processi multimediali in coda relativi a tale funzione rimangono in attesa finché essa rimane disabilitata. |
| Rimuovere una fonte | Se lo si esclude come fonte e si eliminano i profili degli utenti, le registrazioni già salvate rimangono nel registro a scrittura sola. Gli allegati ancora in attesa vengono registrati come non riusciti (`source_removed`). Viene escluso anche nelle modalità «cartella» e «intero account». |
| Modificare il percorso di connessione | Richiede una pausa, chiude i client obsoleti e annulla gli accessi non completati. |
| Arrestare il processo Python | Blocca tutti gli spazi di lavoro; non vengono effettuate osservazioni mentre è offline. |
| Riavvio dopo un periodo di osservazione attiva | Tenta di riprendere l’ambito salvato utilizzando la sessione salvata. Una pausa manuale annulla tale intento. |

Il collettore registra le disconnessioni rilevate, i tentativi di riconnnessione, gli errori, gli avvii/arresti e gli heartbeat. Brevi interruzioni possono sfuggire ai controlli periodici di connettività. Dopo un riavvio, gli aggiornamenti mancanti vengono richiesti a partire dalla posizione di aggiornamento salvata e le chat osservate vengono ricontrollate periodicamente; si veda [il formato delle prove](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#durable-collection-and-process-receipts-02). Uno snapshot aggiunge lo stato corrente come contesto e il divario rimane registrato.

## Isolamento e verifica degli account

Ogni spazio di lavoro dispone di un proprio registro, autorizzazione, chiave di firma, politica e coda. Solo il suo client attivo può contribuire con osservazioni in tempo reale. I client rifiutati, in sospeso, sostituiti e quelli in fase di test di connessione non possono inserire aggiornamenti in tempo reale nel relativo registro. Account diversi possono osservare lo stesso gruppo, ma i loro registri rimangono separati.

Ogni evento include l’hash precedente e una firma Ed25519. Le esportazioni coprono l’ intero registro dell’area di lavoro tramite un numero di sequenza fisso. I filtri del pannello non filtrano l’esportazione; la raccolta può proseguire oltre i suoi limiti mentre è in fase di preparazione.

**Il registro di verifica** controlla la catena di eventi e le firme entro i limiti visualizzati. Il risultato viene azzerato quando l’area di lavoro cambia e il pannello identifica i nuovi record aggiunti dopo la verifica. L’esportazione in formato ZIP verifica anche i file multimediali raccolti.

Mantenere separatamente le impronte digitali e i checkpoint. Consultare la sezione ["Ambito di verifica](https://phishdestroy.io/tgwitness/it/docs/reference/evidence/#verification-scope)" per i controlli di acquisizione in ciascuna modalità, e la sezione ["Operazioni quotidiane](https://phishdestroy.io/tgwitness/it/docs/reference/operations/)" per la raccolta di routine.
