TgWitness / Documentation

What has been tested →

Documentation / 01

Search & Analyze a Saved Telegram Archive

Find the message. Check the source. Build the case.

01Bring in the history

Pull past messages of your enabled sources into the workspace.

02Follow the sources

Search, then open the saved message behind every hit.

03Keep the handoff clear

Your analysis in one file, the signed evidence next to it.

Captured records, recognized text and analyst conclusions stay distinct.

Load past messages

  1. Sources → Chats in scope: check the enabled chats, start observation.
  2. Load full history. It takes the source list as it is right now.
  3. Pause history / Continue history any time. After a restart, resume by hand.
  4. Check results per source and the download queue, keep the signed progress report with the export.

This fills the workspace. A single-chat HTML/JSON export is a different thing. Details.

  1. Journal searches locally, filter by source and time.
  2. Search a phrase or domain, open the record and its versions.
  3. For AI, the admin sets up a provider in Integrations. Then Ask the archive, pick chats and a period, look at Data sent to the model and untick what shouldn't go out.
  4. Check the citations, save the answer as a report, add your notes.

Search needs no AI. Reports keep their sources and revisions, apart from the signed journal. Provider setup.

Choose the connection you need

TaskOpenSetup
Let an AI client read chosen chatsIntegrations → MCPInstall MCP, make a scoped token, connect
Recognize text in saved mediaA media.saved record → Recognize attachmentSet up the local Docker worker
Send events to n8n or a SIEMIntegrations → Outgoing webhooksAdd a receiver, check HMAC, dedupe IDs
Which access token goes where?

Panel access is for people. MCP gets its own read-only tokens, webhooks their own HMAC secret. None of them needs a Telegram session.

Share panel access or configure an MCP client.

Hand over sources and conclusions

Put the report next to the signed ZIP. The report is your reading of the sources, the ZIP is what the recipient verifies.

Export and verify · Work through a full investigation