Alcune parti di questa pagina sono ancora in inglese: il testo originale in inglese è stato modificato dopo la traduzione.
Riferimento / Prove
Telegram · Esportazione dell’account
Esporta ciò che un account può leggere al momento: ambito, attività riprendibili, un archivio firmato e copie di condivisione ridotte al minimo.
TgWitness / Documentazione · Prove e verifica
L'esportazione di un account riserva lo slot di acquisizione dell'account. L'osservazione in tempo reale può proseguire mentre l'archivio viene individuato, scaricato, verificato e compresso. Metti in pausa un altro processo di cronologia o di esportazione prima di avviare un'acquisizione in concorrenza. Mettendo in pausa l'archivio, l'osservazione continua a funzionare, mentre mettendo in pausa l'osservazione si mantiene il processo di archiviazione.
Le esportazioni su account diversi possono essere eseguite contemporaneamente. Un processo “solo Takeout” in attesa di approvazione libera il proprio account, consentendo così l’avvio di un’esportazione separata in sessione normale mentre l’approvazione è in sospeso. Un’acquisizione attiva continua invece a riservare quell’account.
In qualità di amministratore dell’installazione, seleziona Home → Esporta il mio account, oppure Esportazioni → Account Telegram → Configura esportazione account. Effettua l’accesso se necessario, verifica l’ambito e avvia esplicitamente l’esportazione. Non è richiesta un’osservazione continua. Le osservazioni salvate costituiscono un’esportazione separata del registro esistente; il relativo file ZIP include tutte le fonti indipendentemente dai filtri del registro. Ogni area di lavoro dispone di propri processi, identità di firma e spazio di archiviazione. L’accesso al pannello concesso, compresa un’autorizzazione illimitata all’esportazione ordinaria, non consente di aprire questi percorsi a livello di account.
I filtri per mittente e testo si espandono sotto «Filtra per mittente» o «Testo del messaggio». La sezione «Dati account e metodo di connessione» contiene categorie di account opzionali e la scelta tra Takeout e sessione regolare; il suo riepilogo mostra le opzioni attive anche quando la finestra è chiusa. Chiudendo queste sezioni, le impostazioni vengono mantenute. Le bozze di esportazione e dei report rimangono nella sessione corrente del pannello anche quando si cambia vista; non vengono salvate al ricaricamento del browser. I lavori esistenti rimangono accessibili da entrambe le opzioni di esportazione.
Questo flusso di lavoro esporta i dati attualmente accessibili all’account collegato. Il metodo predefinito Automatico inizia con Telegram Takeout, che restituisce la cronologia accessibile nel suo stato attuale, inclusi i canali abbandonati, i contatti salvati e altri dati dell’account. Se Telegram impone un periodo di attesa prima dell’avvio di Takeout, il metodo «Automatico» prosegue immediatamente con la sessione regolare; il registro registra account_export.transport e l’inventario firmato indica il metodo utilizzato ed elenca la modifica come omissione. La sessione Telegram Takeout attende invece solo l’approvazione, mentre la sessione Regolare non richiede mai l’utilizzo di Takeout. Le chat segrete vengono registrate in tempo reale dal modulo Secret Chat, mentre le modifiche vengono rilevate tramite osservazione in tempo reale. La sessione regolare ha una copertura diversa e registra categorie non supportate.
Home → Esporta tutto avvia un’esportazione che include ogni tipo di chat, ogni tipo di allegato, il profilo, i contatti, le foto del profilo, le storie, i metadati della sessione e altri dati dell’account, in tutti i formati: l’archivio TgWitness firmato con le visualizzazioni JSON e HTML di Telegram Desktop. Scegli cosa esportare apre il modulo sottostante con le stesse impostazioni predefinite.
Takeout è l’API di esportazione ufficiale utilizzata anche da Telegram Desktop. TgWitness può scrivere JSON compatibile con Desktop direttamente dalla propria acquisizione; non è necessario importare l’ archivio di qualcun altro. Gli ID delle chat e dei messaggi sono disponibili tramite entrambi i canali di trasmissione. La velocità di esportazione e il ritardo di approvazione di Takeout dipendono dai limiti imposti da Telegram per l’account, dal fatto che una chat sia pubblica o inoltrabile. Misurare lo stesso ambito e le stesse impostazioni multimediali prima di confrontare la velocità.
Per un massimo di 20 ID di chat selezionati esplicitamente, l’esportazione tramite API standard risolve tali peer
direttamente prima di prendere in considerazione l’inventario completo delle conversazioni dell’account. Un canale pubblico
leggibile può quindi essere esportato senza doversi unire ad esso, anche quando è assente
dall’elenco delle conversazioni. I peer non memorizzati nella cache ricorrono all’inventario ordinario. Il
filtro di archiviazione rimane attivo: se Telegram non restituisce una conversazione e le
chat archiviate sono escluse, lo stato di archiviazione sconosciuto viene registrato come omissione.
Takeout mantiene la sua procedura di inventario a intervallo diviso. Nessuno dei due percorsi entra nelle chat né
modifica i permessi di inoltro.
Nel formato JSON compatibile con Desktop, i canali che Telegram contrassegna come left compaiono sotto
left_chats, compresi i canali pubblici leggibili a cui l’account non si è unito.
Sia FLOOD_WAIT che FLOOD_PREMIUM_WAIT sospendono le richieste per l’intero periodo richiesto dal server.
La scadenza dell’account viene mantenuta anche in caso di ricollegamenti e riavvii; un’attesa successiva più breve
non può accorciarla. I tentativi sono limitati, la cancellazione preserva le pagine sigillate
e le credenziali API non vengono ruotate per aggirare un limite di frequenza. Non viene effettuato alcun acquisto Premium.
Scegli cosa raccogliere#
| Contesto | Significato |
|---|---|
| Scopo | Indica il motivo per cui questa acquisizione è necessaria. Non inserire qui nomi non necessari o dettagli sensibili relativi al caso. |
| Lingua del report | Scegli la lingua delle etichette del report leggibile. Il testo originale del messaggio rimane invariato; le etichette del modello non tradotte utilizzano l’inglese. La lingua viene fissata tramite le opzioni del processo firmato. |
| Tipi di chat / ID delle chat | Tutti i tipi selezionati o solo le chat elencate; i «Messaggi salvati» appartengono alle chat private. Le chat archiviate sono selezionabili separatamente. |
| Date | UTC. Sono incluse entrambe le date del calendario "Da" e "Fino a" del pannello. L’API utilizza date inclusive from_utc ed esclusive to_utc; il pannello invia l’inizio del giorno successivo alla data "Through". Un limite vuoto lascia quel lato senza restrizioni. |
| ID mittente | Solo i messaggi dei mittenti elencati; un elenco vuoto include tutti i mittenti. |
| Il testo contiene | Frasi letterali che non distinguono tra maiuscole e minuscole, abbinate con OR. Le condizioni relative a mittente/data/messaggio proprio si combinano con AND. |
| Messaggi propri | Conserva solo i messaggi in uscita. |
| Tipi di file multimediali | Seleziona le categorie di allegati oppure deseleziona tutto per evitare il download dei file dei messaggi. |
| Limiti relativi ai file e ai contenuti multimediali complessivi | MiB per file e GiB totali di contenuti multimediali scaricati. Testo, ricevute, report leggibili e overhead ZIP richiedono spazio su disco aggiuntivo. |
| Categorie di account | Profilo, contatti, foto del profilo, storie, metadati delle sessioni e altri dati Takeout dispongono di controlli separati. |
Il preset della raccolta «Minimize» disabilita i file e i metadati degli account. I filtri relativi al mittente e al contenuto vengono applicati prima della conservazione delle pagine dei messaggi e del download dei file multimediali. Telegram continua a trasmettere le pagine della cronologia API contenenti i messaggi necessari per valutare tali filtri: il filtraggio non garantisce che i messaggi non selezionati non entrino mai nella memoria di processo. Ogni altra osservazione in corso nell’area di lavoro ha le proprie impostazioni relative all’ambito e alla conservazione.
La cronologia delle foto del profilo, le storie, i metadati delle sessioni e altri dati dell’account sono selezionati per impostazione predefinita. Disattivarli, insieme al profilo e ai contatti, qualora il caso richieda esclusivamente i messaggi. Se gli allegati o i metadati non sono necessari, escluderli durante l’acquisizione evita di conservare un’altra copia privata in questa esportazione.
I payload delle foto utilizzano la variante di immagine fissa identificata nei relativi metadati e nei manifest di hash, comprese le foto con una variante di avatar animato. Tale animazione non viene sostituita dall’immagine fissa selezionata. Un payload più corto o più lungo rispetto alla dimensione osservata viene registrato come allegato non riuscito, mentre una rappresentazione modificata durante il rinnovo del riferimento al file viene rifiutata. Questi errori lasciano l’archivio parziale, pur conservando i record dei messaggi. La verifica indipendente rifiuta inoltre gli allegati salvati la cui lunghezza firmata contraddice la loro dimensione o rappresentazione osservata, anche negli archivi più vecchi.
Se una connessione dedicata ai media si interrompe temporaneamente, le operazioni di lettura degli allegati utilizzano la connessione standard per i file. Dopo un minuto, la connessione dedicata viene riprovata in secondo piano mentre i download proseguono. Questo meccanismo di ripristino mantiene il limite di connessione configurato e si applica separatamente a ciascun data center. Le attese dovute a un sovraccarico di messaggi su Telegram e gli errori di autorizzazione continuano a propagarsi.
Numeri dei messaggi e mappa delle attività#
Ogni archivio di account contiene message-gaps.json e map.html. I canali e i supergruppi numerano i propri messaggi per ogni singola chat, pertanto ogni numero mancante tra il primo e l’ultimo messaggio esportato corrisponde a un messaggio di quella chat. Le chat private, i bot e i gruppi di base condividono un’unica sequenza numerica per l’intero account: un numero mancante in tale contesto apparteneva a una chat qualsiasi. La chat di appartenenza viene accertata quando una risposta esportata o un pin rimanda a quel numero; in caso contrario, si stima quali chat fossero attive nel periodo compreso tra i messaggi adiacenti, e il resto viene attribuito alle chat non incluse nell’esportazione. Ogni esecuzione presenta la propria finestra temporale, i messaggi adiacenti, le quote per chat e un’etichetta di affidabilità. Viene specificato un ambito limitato (filtri, chat non selezionate), poiché in tal caso i numeri mancanti includono messaggi al di fuori della selezione.
map.html Mostra un calendario, le chat nel tempo e griglie suddivise per giorno della settimana e ora per i messaggi e per i numeri mancanti, con tabelle di ogni chat e delle sequenze più lunghe. Le pagine delle chat mostrano il proprio calendario, i partecipanti nel tempo per i gruppi e un contrassegno nella trascrizione nei punti in cui mancano i messaggi. verify.py ricalcola message-gaps.json a partire dalle pagine firmate e rifiuta un file modificato.
La mappa delle attività elenca le lacune più estese relative ai canali e ai supergruppi, compresi i relativi intervalli di numeri e gli orari dei messaggi adiacenti. Aprendo un intervallo si passa alla posizione contrassegnata nella trascrizione suddivisa in pagine. Questi contrassegni registrano i numeri mancanti tra i messaggi adiacenti salvati; gli eventi di cancellazione, i relativi orari e i testi dei messaggi provengono esclusivamente dai record salvati. Le tabelle di grandi dimensioni scorrono all’interno delle rispettive schede sugli schermi di piccole dimensioni.
Le trascrizioni lunghe includono un indice delle pagine con gli intervalli di date dei messaggi e un calendario. Scegli un mese per aprire il primo record in ordine di pagina acquisita. Il conteggio dei mesi si basa sulle date dei messaggi registrate in UTC; i record senza data rimangono nella trascrizione. La navigazione tra le pagine include la prima, l'ultima e le pagine vicine, e apre direttamente la sezione del messaggio. L'indice funziona offline senza JavaScript.
Riepilogo, copertura e verifica#
Ogni processo blocca le proprie opzioni e l’identità dell’account. L’inventario e le pagine acquisite vengono firmate; le ricevute delle pagine registrano hash, cursori, orari, esiti degli allegati e la ricevuta precedente. Solo le pagine confermate fanno avanzare lo stato di avanzamento. Il riavvio/ripresa verifica tali registrazioni prima di proseguire. Un account modificato, una pagina firmata modificata o una catena di ricevute incoerente vengono rifiutati. Le opzioni non possono essere modificate a metà di un’acquisizione: avviare un altro processo per un altro ambito.
La funzione “Pausa” interrompe l’operazione in corso sull’account. Il riavvio dell’applicazione lascia il lavoro incompiuto disponibile per una ripresa esplicita. Una sessione Takeout scaduta richiede una ripresa esplicita; la modifica degli intervalli di suddivisione di Telegram può richiedere una nuova acquisizione. La ripresa conserva le osservazioni precedenti, quindi un’esportazione di lunga durata non costituisce un’istantanea atomica. Altre operazioni di cambio di account ed esportazioni in conflitto vengono bloccate durante l’acquisizione. Attendere il completamento del packaging prima di eliminare un’area di lavoro.
L'opzione "Riprendi" mostra immediatamente il messaggio Verifica dei dati di esportazione salvati… e controlla il contenuto salvato in background prima di contattare Telegram. Il pannello rimane disponibile durante la verifica. L'opzione "Pausa" attende che il processo di verifica si concluda in modo sicuro prima di sbloccare l'account; funziona anche se selezionata immediatamente dopo l'avvio o la ripresa dell'operazione. Su dispositivi di archiviazione lenti, tale attesa può risultare lunga. I controlli di integrità falliti generano un'operazione non riuscita con una spiegazione e conservano i relativi file.
Se Telegram interrompe l'autorizzazione dell'account durante l'acquisizione dell'inventario, della cronologia o degli allegati, l'operazione viene messa in pausa senza contrassegnare come completata la pagina non terminata. Riconnettiti allo stesso account e riprendi l'operazione per continuare dall'ultima pagina salvata. I segnaposto dei messaggi non disponibili fanno avanzare il cursore della cronologia ma non completano la lettura: i messaggi disponibili più vecchi vengono comunque richiesti e un segnaposto non viene presentato come messaggio acquisito o come cancellazione confermata.
The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: Coverage and missing material. Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed.
I file ZIP completati rimangono disponibili per download ripetuti e tramite HTTP-range. Un archivio dell’account contiene manifest.json, manifest.sig, job.json firmato, inventory.json, receipts/, data/*.jsonl autorevoli, media/ selezionati, HTML leggibile e un verificatore. Fissare l’impronta digitale del collettore tramite un canale indipendente, quindi verificare utilizzando un’installazione affidabile. Il pannello salva l’archivio come tgwitness-account-export-EXPORT_ID.zip; una cattura sigillata lo include nel proprio archivio di prove come account-export.zip. Utilizza il nome del file in tuo possesso:
python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256
Per gli archivi il cui contenuto espanso supera i 4 GiB, impostare esplicitamente un limite adeguato --max-gib. Il pannello verifica i propri archivi locali autenticati e completati utilizzando la dimensione espansa dichiarata e il digest pubblicato ZIP; la CLI esterna mantiene il proprio limite di dimensione indipendente. Verificare prima di aprire l’HTML leggibile. Il verificatore integrato nell’archivio è comodo, ma un verificatore ottenuto in modo indipendente evita di affidarsi al codice eseguibile fornito insieme alle prove.
La firma Ed25519 e gli hash SHA-256 rilevano le modifiche successive al commit dei byte rilevanti da parte del collettore. Esaminare tale risultato insieme all’ambito di raccolta registrato, agli intervalli di acquisizione, alle ricevute di timestamp esterni e ai controlli di provenienza disponibili per la distribuzione selezionata. Le osservazioni successive vengono registrate separatamente, conservando le versioni acquisite in precedenza.
Preparare una comunicazione per un avvocato o un altro destinatario#
Dopo aver scaricato un’esportazione completata, conservare l’ZIP originale e aprire index.html
da una copia estratta. Il rapporto illustra l’ambito di applicazione, la copertura disponibile e i
limiti. I riferimenti del registro combinano il riferimento all’archivio, il percorso del documento e il
numero di registrazione, in modo che il destinatario possa individuare la stessa voce nel codice HTML o nella stampa.
Per un esempio pratico, apri il rapporto fittizio.
Da un'esportazione dell'account completata, seleziona «Prepara una copia da condividere». In questo modo viene creato un derivato separato e firmato. Il file sorgente ZIP rimane invariato e privato; non inviarlo insieme a un derivato ridotto a meno che il destinatario non sia autorizzato a riceverne l'intero contenuto. Scegli separatamente la lingua del report. La modifica della lingua o di qualsiasi impostazione di selezione richiede un'altra anteprima prima della creazione.
- Inserisci lo scopo della divulgazione e seleziona le date, gli ID dei mittenti e i criteri relativi al testo letterale.
- È possibile scegliere se mantenere le identità, rivelare solo i partecipanti elencati o pseudonimizzare tutti. In entrambe le modalità di pseudonimizzazione, vengono sostituiti anche gli ID/titoli delle chat e gli ID dei messaggi. Gli pseudonimi rimangono invariati all’interno di una singola divulgazione e cambiano tra divulgazioni preparate in modo indipendente.
- È possibile mantenere il testo del messaggio, ometterlo completamente oppure aggiungere nomi o frasi letterali da mascherare. Nelle modalità private, lo strumento maschera anche i nomi noti dei mittenti nascosti e i nomi utente alternativi, gli ID mittente composti da token interi, i nomi delle chat dirette, i link, gli indirizzi e-mail e le stringhe simili a numeri di telefono. La corrispondenza dei nomi noti gestisce la conversione maiuscolo/minuscolo Unicode, inclusi
Straße/STRASSE. I titoli generici di gruppi/canali non vengono rimossi automaticamente dal testo del messaggio. Se viene superato il limite di mascheramento delle identità note, restringere l’esportazione di origine oppure omettere il testo; lo strumento rifiuta di saltare silenziosamente i nomi successivi. Si tratta di regole applicate al meglio, non di un’anonimizzazione generale. - Non includere i file a meno che il destinatario non ne abbia bisogno. Gli originali inclusi mantengono i propri pixel, audio, testo e metadati. Non vengono resi anonimi dallo strumento.
- Visualizza in anteprima i conteggi, gli avvisi e i messaggi trasformati di esempio, quindi conferma esplicitamente la creazione. Gli esempi sono limitati a 12 messaggi e 2.000 caratteri di testo ciascuno. Si tratta di un esempio, non di una revisione completa del risultato. La modifica delle impostazioni richiede un’altra anteprima. Un’anteprima scade dopo 15 minuti ed è vincolata a quella sessione dell’amministratore e all’ZIP originale esatto; non può essere riutilizzata dopo la creazione. Una nuova anteprima invalida quella precedente per lo stesso lavoro e la stessa sessione.
- Esamina il risultato completo
index.htmlemessages.jsonla livello locale prima di consegnarlo. Se rivela informazioni non necessarie, crea una nuova divulgazione con esclusioni più rigorose. Non modificare l'ZIP firmato in loco.
Messaggi esclusi dalla selezione#
Anteprima. Una divulgazione non appare completa quando non lo è. All’interno di ogni chat che contiene almeno un messaggio divulgato, i messaggi esclusi dalla selezione appaiono come indicatori, [withheld by selection — rule: sender] (oppure text, period). Scegliere «Messaggi esclusi dalla selezione»: un indicatore per ogni serie di messaggi esclusi consecutivi (impostazione predefinita) oppure uno per ogni singolo messaggio. Gli indicatori riportano solo la regola e un conteggio, mai il testo, il mittente, la data o i file. Le chat prive di messaggi divulgati vengono escluse interamente, pertanto il pacchetto non ne rivela l’esistenza.
Le risposte divulgate indicano a cosa si riferiscono: un messaggio incluso in questa copia, un messaggio escluso dalla selezione o un messaggio che non è presente nell’esportazione di origine (cancellato prima dell’esportazione o mai esportato; l’esportazione non è in grado di distinguere tra le due eventualità). Un messaggio escluso a cui risponde una risposta divulgata riceve sempre un proprio indicatore, in modo che la risposta rimandi a un record che spiega perché è vuoto. Questi tre stati sono distinti dalle cancellazioni e dalle lacune nella raccolta, che appartengono all’esportazione originale.
In messages.jsonl (formato tgwitness-account-disclosure-v2) ogni messaggio ha state: disclosed, oppure withheld con rules e count. Una risposta divulgata ha reply_to con il destinatario id e state (disclosed, withheld, not_in_source). Il manifesto conta i messaggi, le chat, i contenuti multimediali e i withheld messaggi. verify.py Rifiuta un marcatore che contiene contenuto e una risposta che punta a un record mancante dal pacchetto; i pacchetti della versione 1 vengono verificati come in precedenza.
Il formato ridotto omette i profili strutturati degli account, i contatti, gli avatar, le sessioni, le storie, gli oggetti Telegram grezzi, le intestazioni di inoltro, le citazioni nelle risposte, le schede dei contatti e i metadati di localizzazione. Esclude i file JSONL originali, le impostazioni dei filtri privati, la chiave dello pseudonimo e la mappa delle identità. Il testo selezionato, le identità esplicitamente conservate e i file inclusi possono comunque contenere gli stessi nomi, ID o frasi utilizzati in tali filtri; richiedono una revisione separata. La politica privata e la chiave pseudonima vengono conservate in forma crittografata nel vault locale del processo; l’eliminazione del processo cancella i relativi record di divulgazione privata. La politica pubblica registra il numero di filtri anziché i valori dei filtri. Lo scopo dichiarato è pubblico nel manifesto e nell’HTML: i criteri privati espliciti e, nelle modalità pseudonimizzate, anche le identità nascoste note vengono mascherate in tali documenti, anche quando il testo del messaggio viene omesso. Mantenere lo scopo libero da dettagli personali non necessari; il contesto identificativo sconosciuto può rimanere.
Il suo manifesto associa i file derivati, la politica pubblica e l'hash del file ZIP originale. La verifica consente di accertare l'integrità e, se la fonte è fornita localmente, la corrispondenza dei collegamenti alla fonte. Il pannello salva la copia condivisa con il nome tgwitness-disclosure-DISCLOSURE_ID.zip:
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip
Il collegamento alla fonte indica da quale archivio e da quale chiave del collector proviene la divulgazione. La divulgazione contiene solo i contenuti selezionati; verifica la selezione e la rimozione dei dettagli identificativi confrontandole con l’esportazione originale.
Condivisione e acquisizione in hosting#
Selezionare i messaggi e i file necessari al destinatario, esaminare la copia completa condivisa e conservare separatamente la fonte. Registrare l’hash del file ZIP consegnato in modo che il destinatario possa identificare e verificare quella copia esatta. La pseudonimizzazione sostituisce gli identificatori selezionati; il testo incluso e i file originali rimangono parte della revisione.
GitHub Actions supporta l’esportazione dell’intero account e di chat selezionate tramite Takeout o l’API standard, oltre a un registro degli eventi relativo a una singola chat. La guida alla cattura ospitata spiega la verifica delle impostazioni e il limite di 120 minuti. Per verificare una copia condivisa derivata dalla cattura ospitata, confrontare l’hash della fonte con l’archivio originale e verificare l’attestazione di tale archivio con i controlli specifici della modalità .