TgWitness / Documentation

Repository / docs/wiki/Collection.md

Collection and coverage

Choose what to preserve. Sources, captured changes and coverage.

01 · CONNECT AND CAPTURE · All guides · Get help

On this page

It records what the connected account gets.

Illustrated workflow: captured versions remain in the journal.

Select the scope#

Scope Appropriate starting point
Chosen chats A short, explicit list
Telegram folder Everything in one folder
Whole account A dedicated account, new chats included

Pick the scope in More tools → Sources → Scope, then chat types, exclusions and whether to keep your own outgoing messages. Broad scopes pull in private chats and bots, make sure you want that.

Event types are separate switches: messages, edits, deletions, reactions, joins/leaves. Attachments by type and size. Hit Save, then Start observation.

Check capture with a controlled conversation#

  1. From another account of yours, send a recognizable test message into a selected chat.
  2. Wait for it in Chats and Journal.
  3. Edit it, you should get a second version.
  4. Delete it, the old text should still be there next to the deletion.
  5. For attachments wait for the finished receipt, queued isn't saved.
  6. Export and verify.

Keep test material away from real case stuff.

Understand the record#

Record Meaning
New message / edit A version the account saw
Deletion notice Telegram said it was deleted, earlier content may be unknown
Missing at recheck A later query didn't return it. Not the same as a deletion
History snapshot What the account can see right now
Coverage gap A recorded break or uncertainty

Rechecks catch some of what was missed, never all in-between edits or deletions. Priority chats get rechecked more often, see More tools → Sources → Recording → Recheck and the collection reference.

Pause, lock and restart#

Pause observation stops collecting. Lock and closing the browser don't. While the app is stopped nothing is collected. After a restart check the account, observation state, gaps and download queues.

Load older messages#

More tools → Sources → Chats in scope → Load full history pulls the history of enabled sources, with pause/resume and a signed progress report. Attachments finish separately. See history acquisition.

Next: Investigations · Exports · Collection reference