Documentazione / 14

Scoprite cosa è andato storto

Si parta dal sintomo. Si verifichi un livello alla volta.

Il pannello richiede un token

Utilizzi il token del pannello presente nel file locale visualizzato dal programma di avvio. Per Docker, esegua il comando docker compose exec tgwitness cat /data/panel-token.txt. Un codice di accesso a Telegram, un token BotFather e un token witness in sola lettura hanno finalità diverse.

Telegram non si connette

Apra le impostazioni di connessione ed esegua il controllo della connessione. Se utilizza un proxy pubblico, provi un’altra voce e salvi esplicitamente il percorso. Verifichi il tipo di proxy e il formato del segreto supportato. L’aggiornamento di un elenco pubblico non modifica il percorso dell’account.

Connesso, ma nessun nuovo messaggio

1. Verifichi che l’osservazione sia in esecuzione nell’area di lavoro corretta.
2. Si prega di verificare che la fonte sia selezionata e visibile a tale account.
3. Inviate un nuovo messaggio univoco in un gruppo controllato e cercate proprio quel testo.
4. Si prega di esaminare il registro operativo per individuare eventuali interruzioni, ritardi nell’elaborazione o errori di Telegram.

Le istantanee storiche e gli eventi relativi ai nuovi messaggi sono distinti. È possibile collegare una fonte inattiva senza generare nuovi messaggi. Si raccomanda di utilizzare un test di consegna controllata quando è fondamentale garantire la completezza dei dati.

FloodWait o un intervallo dopo un riavvio

FloodWait indica che Telegram richiede una pausa. Attenda il periodo indicato e verifichi il carico di lavoro della raccolta; i tentativi ripetuti di riconnettersi non eliminano il limite. Lo stato degli aggiornamenti salvati consente di recuperare il ritardo dopo un riavvio, ma gli aggiornamenti scaduti e alcune finestre di interruzione rimangono dei limiti. Registri l’intervallo piuttosto che considerare il registro come completo.

Il bot è configurato ma non pubblica nulla

Si assicuri che il processo di Witness sia effettivamente in esecuzione, che il bot possa pubblicare nel canale e che Witness possa raggiungere il collector e l’API del bot. Verifichi il registro per individuare eventuali pubblicazioni non andate a buon fine. Il solo esito positivo di un’interrogazione del collector non conferma la pubblicazione nel canale.

Dove si trova l’integrazione del token GitHub?

In fase di pianificazione. La sezione «Extras» descrive il flusso di lavoro proposto per il fork e la verifica della compilazione. Attualmente non è disponibile alcun modulo per il token GitHub né alcuna attestazione automatica che confermi la corrispondenza tra un’installazione in esecuzione e un repository. Si prega di consultare lo stato attuale delle funzionalità.

Quando si segnala un problema, si prega di indicare la versione, il sistema operativo, i passaggi seguiti e un messaggio di errore oscurato. Si prega di non menzionare sessioni, token, messaggi privati e la directory dei dati nelle segnalazioni pubbliche.