# Telegram · Cách thức thu thập dữ liệu

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

Phạm vi quan sát, cập nhật trực tiếp, kiểm tra lại, tệp đính kèm, các hành động của người dùng và ý nghĩa của “khoảng trống”, được ghi lại theo từng bản ghi.

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

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

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

Phạm vi quan sát, cập nhật trực tiếp, kiểm tra lại, tệp đính kèm, các hành động của người dùng và ý nghĩa của “khoảng trống”, được ghi lại theo từng bản ghi.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Bộ sưu tập](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

![Bộ sưu tập](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69)

TgWitness ghi lại những gì một tài khoản Telegram được kết nối quan sát được. Giám sát trực tiếp lưu giữ tin nhắn, các chỉnh sửa được ghi lại, thông báo xóa và tệp đính kèm cùng với thời gian quan sát và bối cảnh nguồn của chúng. Các lần đọc lịch sử, kiểm tra lại và các bản ghi nhật ký quản trị có sẵn sẽ bổ sung các quan sát được xác định riêng biệt vào bản ghi đó.

**Trên trang này**

- [Từ đăng nhập đến nhật ký](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#from-login-to-a-journal)
- [Phạm vi quan sát: các cuộc trò chuyện được chọn, một thư mục hoặc toàn bộ tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)
- [Phạm vi và lựa chọn sự kiện](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#scope-and-event-selection)
- [Các hành động riêng](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#own-actions)
- [Chế độ điều tra: tham gia các nhóm và trò chuyện với bot](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots)
- [Các cấp độ kiểm tra lại](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#recheck-tiers)
- [Lịch sử tin nhắn và nguồn gốc](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#message-history-and-attribution)
- [Ảnh chụp lịch sử](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#history-snapshots)
- [Xử lý tệp đính kèm](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#attachment-handling)
- [Tạm dừng, khóa, ngắt kết nối và khởi động lại](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#pause-lock-disconnect-and-restart)
- [Cách ly và xác minh tài khoản](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#account-isolation-and-verification)

## Từ quá trình đăng nhập đến sổ ghi chép

Đối với ảnh và tệp tự hủy, xem [Tệp đa phương tiện tự hủy](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Phần này giải thích về công việc ưu tiên, các kết quả đã lưu và không khả dụng, cũng như các giới hạn của tính năng chặn xác nhận đã đọc trong trình thu thập API.

Sơ đồ quy trình · Xác thực tài khoản người dùng → Chọn các nhóm và kênh có thể truy cập; Chọn các nhóm và kênh có thể truy cập → Lưu cài đặt sự kiện và tệp đính kèm; Lưu cài đặt sự kiện và tệp đính kèm → Bắt đầu quan sát; Bắt đầu quan sát → Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động; Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động → Áp dụng chính sách về nguồn và sự kiện; Áp dụng chính sách về nguồn và sự kiện → Thêm một ghi chú có chữ ký; Thêm một ghi chú có chữ ký → Xem lại hoặc xuất sổ nhật ký; Thêm một ghi chú có chữ ký → Xử lý mọi tệp đính kèm đang chờ xử lý; Xử lý mọi tệp đính kèm đang chờ xử lý → Thêm kết quả tải xuống · Xác thực tài khoảnngười dùng · Chọn các nhóm và kênhcó thể truy cập · Lưu cài đặt sự kiện vàtệp đính kèm · Bắt đầu quan sát · Nhận thông tin cậpnhật từ ứng dụng kháchđang hoạt động · Áp dụng chính sách vềnguồn và sự kiện · Thêm một ghi chú cóchữ ký · Xem lại hoặc xuất sổnhật ký · Xử lý mọi tệp đính kèmđang chờ xử lý · Thêm kết quả tải xuống

**Sơ đồ dưới dạng văn bản**

1. Xác thực tài khoản người dùng → Chọn các nhóm và kênh có thể truy cập
2. Chọn các nhóm và kênh có thể truy cập → Lưu cài đặt sự kiện và tệp đính kèm
3. Lưu cài đặt sự kiện và tệp đính kèm → Bắt đầu quan sát
4. Bắt đầu quan sát → Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động
5. Nhận thông tin cập nhật từ ứng dụng khách đang hoạt động → Áp dụng chính sách về nguồn và sự kiện
6. Áp dụng chính sách về nguồn và sự kiện → Thêm một ghi chú có chữ ký
7. Thêm một ghi chú có chữ ký → Xem lại hoặc xuất sổ nhật ký
8. Thêm một ghi chú có chữ ký → Xử lý mọi tệp đính kèm đang chờ xử lý
9. Xử lý mọi tệp đính kèm đang chờ xử lý → Thêm kết quả tải xuống

Ủy quyền, quyền truy cập vào nguồn, bộ thu thập đang hoạt động và việc chuyển giao hoàn chỉnh là những vấn đề khác nhau. Việc đăng nhập thành công không đồng nghĩa với việc được cấp quyền truy cập vào mọi nhóm. Việc chuyển giao được theo dõi riêng biệt: các bản ghi phạm vi phủ sóng, khôi phục khoảng trống cập nhật và kiểm tra lại cho thấy những gì đã được chuyển đến.

## Phạm vi giám sát: các cuộc trò chuyện được chọn, một thư mục hoặc toàn bộ tài khoản

**Các công cụ khác → Nguồn → Phạm vi** quyết định các cuộc trò chuyện mà không gian làm việc sẽ ghi lại.

Quá trình thiết lập mới bắt đầu từ mục **Chọn các cuộc trò chuyện**. Các lựa chọn đã lưu trước đó sẽ được giữ nguyên. Khi chọn **Tất cả các cuộc trò chuyện** trong trình hướng dẫn thiết lập, hệ thống sẽ yêu cầu xác nhận nếu danh sách được tải lên chứa hơn 50 cuộc trò chuyện; việc ước tính dung lượng vẫn là một thao tác riêng biệt, dựa trên mẫu.

| Chế độ | Ghi lại | Các cuộc trò chuyện mới |
| --- | --- | --- |
| Các cuộc trò chuyện được chọn (mặc định) | Chỉ các cuộc trò chuyện mà quý vị thêm vào thủ công | Không bao giờ được thêm tự động |
| Thư mục Telegram | Các cuộc trò chuyện trong một trong các thư mục của tài khoản: bao gồm các cuộc trò chuyện được liệt kê theo tên, cộng với các danh mục của thư mục (liên hệ, không phải liên hệ, nhóm, kênh, bot), trừ đi các cuộc trò chuyện bị loại trừ và, nếu thư mục có ghi rõ, các cuộc trò chuyện đã được lưu trữ | Các cuộc trò chuyện phù hợp sẽ được thêm vào ngay khi chúng trở nên hoạt động; các cuộc trò chuyện mà quý vị thêm vào thư mục trong Telegram sẽ được hệ thống thu thập trong vòng một giờ |
| Toàn bộ tài khoản | Mọi cuộc trò chuyện mà tài khoản này tiếp nhận | Mọi cuộc trò chuyện, nhóm, cuộc trò chuyện riêng tư hoặc bot mới đều được thêm vào ngay khi có bản cập nhật đầu tiên |

- **Các loại nguồn** (kênh, nhóm, cuộc trò chuyện riêng tư, bot) giới hạn chế độ thư mục và chế độ toàn tài khoản. Các cuộc trò chuyện được chọn có thể thuộc bất kỳ loại nào, bao gồm cả cuộc trò chuyện riêng tư và bot; các loại nguồn không bao giờ ngăn chặn một cuộc trò chuyện mà bạn đã thêm thủ công. Việc tắt một loại, thêm ngoại lệ hoặc chuyển sang chế độ “cuộc trò chuyện đã chọn” sẽ ngừng các nguồn được thêm tự động ngay khi được lưu, trước khi danh sách nguồn được tính toán lại và cả khi không thể kết nối với Telegram: các tin nhắn mới, lịch sử đã qua, lịch sử cuộc trò chuyện mới, cài đặt đồng đẳng và thông tin hồ sơ của họ.
- **Các cuộc trò chuyện mà bạn thêm thủ công** sẽ vẫn được ghi lại trong chế độ thư mục và chế độ toàn tài khoản ngay cả khi chúng nằm ngoài thư mục; chỉ có *các thao tác Loại trừ*, *Xóa* hoặc tạm dừng mới có thể ngừng việc ghi lại này. Các cuộc trò chuyện được thêm theo phạm vi (*tự động*) sẽ tuân theo thư mục: cuộc trò chuyện nào rời khỏi thư mục sẽ bị tạm dừng tại lần tính toán lại tiếp theo.
- **Các cuộc trò chuyện bị loại trừ** sẽ không bao giờ được ghi lại, ở bất kỳ chế độ nào. Trong chế độ theo thư mục và toàn tài khoản, khi bạn chọn *Loại trừ* hoặc *Xóa* trên một nguồn, cuộc trò chuyện đó sẽ được thêm vào danh sách này, do đó phạm vi ghi sẽ không thêm nó vào lần nữa. Việc chọn lại cuộc trò chuyện bằng tay (trong phần Nguồn, từ mục Cuộc trò chuyện hoặc trong Cài đặt → **Chọn cuộc trò chuyện nào?**) sẽ loại bỏ nó khỏi danh sách. Danh sách này có thể chứa tối đa 5.000 cuộc trò chuyện; nếu vượt quá số lượng này, *thao tác Xóa* sẽ bị từ chối và thay vào đó, bạn có thể tạm dừng cuộc trò chuyện đó.
- **Các hành động của chính tài khoản** (mặc định là bật): các tin nhắn mà tài khoản này gửi đi, các thao tác chỉnh sửa và các lần nhấn phím trên bàn phím trả lời. Khi tắt tính năng này, các tin nhắn gửi đi và các thao tác chỉnh sửa sẽ bị bỏ qua.
- Việc chuyển sang một thư mục hoặc toàn bộ tài khoản sẽ yêu cầu xác nhận: các chế độ này ghi lại các cuộc trò chuyện riêng tư và tin nhắn của bên thứ ba, và chỉ nên được sử dụng trên một tài khoản chuyên dụng. Việc xác nhận và mọi thay đổi phạm vi đều được ghi lại dưới dạng các bản ghi `scope.changed`. Trên một tài khoản được thiết lập làm tài khoản chính của bạn, biểu mẫu phạm vi và tính năng Điều tra sẽ từ chối cho phép truy cập vào một thư mục hoặc toàn bộ tài khoản, giống như khi bắt đầu; chỉ có thể sử dụng chúng thông qua một lần sao chép duy nhất mà không ghi lại.
- Các cuộc trò chuyện được phạm vi thêm vào sẽ xuất hiện dưới dạng các nguồn được đánh dấu là *auto*, được ghi lại dưới dạng `scope.applied` (khi bắt đầu và mỗi giờ) hoặc `source.discovered` (một cuộc trò chuyện mới trong quá trình quan sát). Việc chuyển trở lại các cuộc trò chuyện đã chọn sẽ tạm dừng tất cả các nguồn được thêm tự động cùng lúc, mà không cần đọc lại danh sách cuộc trò chuyện của tài khoản. Một cuộc trò chuyện bị loại trừ sẽ ngừng được ghi lại ngay khi phạm vi được lưu, và nguồn của nó sẽ bị tạm dừng ngay cả khi Telegram không trả về danh sách cuộc trò chuyện. Trong khi quan sát, việc lưu phạm vi sẽ áp dụng lại phạm vi đó, ngay cả khi các giá trị không thay đổi.

Phạm vi của các chế độ này:

- **Tính năng Trò chuyện bí mật** sử dụng [tích hợp Pseudo-secret](https://phishdestroy.io/tgwitness/vi/docs/reference/secret-chats/) đi kèm, với mô-đun giao thức được cài đặt từ bảng điều khiển và công tắc kích hoạt cho từng tài khoản. Lịch sử trên đám mây và Takeout sử dụng một đường dẫn thu thập dữ liệu riêng biệt.
- **Các khoảng thời gian ngoại tuyến.** Sau khi khởi động lại, TgWitness sẽ tiếp tục từ vị trí cập nhật đã lưu, yêu cầu Telegram cung cấp các bản cập nhật bị bỏ lỡ và kiểm tra lại các cuộc trò chuyện. Telegram duy trì một danh sách công việc tồn đọng có giới hạn, do đó sau một thời gian ngừng hoạt động dài, các báo cáo và `verify.py` sẽ liệt kê khoảng thời gian còn lại dưới dạng một khoảng trống (xem [phạm vi bao phủ](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)).
- Chỉ có 1,000 cuộc trò chuyện đầu tiên được liệt kê khi bắt đầu (giới hạn này nằm trong **mục Công cụ khác → Tham số**); các cuộc trò chuyện cũ hơn sẽ được thêm vào khi chúng hoạt động trở lại. Lịch sử trước đó của một cuộc trò chuyện đã thêm sẽ không được lấy về — hãy tạo một bản chụp lịch sử hoặc xuất toàn bộ cuộc trò chuyện khi bạn cần.
- Các điều kiện của thư mục thay đổi liên tục (bị tắt tiếng, đã đọc) sẽ không được áp dụng: các cuộc trò chuyện đó vẫn tiếp tục được theo dõi.
- **Các nút bot nhúng (callback)** được nhấn trong một ứng dụng khác sẽ không hiển thị trong phiên làm việc thứ hai; phản hồi hoặc thao tác chỉnh sửa của bot sẽ được ghi lại. Các thao tác nhấn phím trên bàn phím để trả lời sẽ được gửi dưới dạng tin nhắn đi và được gắn nhãn `button_press`.
- Càng nhiều cuộc trò chuyện đồng nghĩa với việc càng có nhiều yêu cầu. Telegram sẽ hạn chế các tài khoản có khối lượng tin nhắn mà nền tảng này coi là quá mức, đây chính là một lý do nữa để sử dụng các tài khoản chuyên dụng.

### Các cuộc trò chuyện được chọn lọc kỹ lưỡng

**Nghiêm ngặt: Chỉ các cuộc trò chuyện đã chọn mới** xuất hiện trong **phần Cuộc trò chuyện đã chọn** và tùy chọn này bị tắt theo mặc định. Tùy chọn này dành cho quyền truy cập chỉ áp dụng cho các cuộc trò chuyện đã chọn. Khi tùy chọn này được bật:

- Các thông báo dịch vụ của Telegram (777000) không được đọc: không được đọc khi bắt đầu hoặc kết thúc quá trình quan sát, cũng như không được đọc mỗi phút trong quá trình quan sát. Không có bản ghi nào thuộc loại ``session.security_baseline`` hoặc ``account.security_event`` được ghi lại.
- Danh sách phiên của tài khoản không được đọc: không được đọc khi bắt đầu hoặc kết thúc quá trình quan sát (câu hỏi trên bảng điều khiển về các phiên khác liên quan đến **Bằng chứng cho một vụ án** và các chế độ bảo vệ bằng chứng cũng bị bỏ qua), không được đọc cứ sau hai phút trong quá trình quan sát, không được đọc khi kết nối được thiết lập, và cũng không được đọc bởi quá trình kiểm tra kết nối — trong đó *mục*được hiển thị là đã bỏ qua. Trạng thái xác minh hai bước được sử dụng bởi quá trình kiểm tra tiếp quản cũng không được đọc. Do đó, các trường `account.sessions`, `session.concurrent_at_start` và `session.takeover_risk` không được ghi, và một phiên kết thúc từ thiết bị khác không được báo cáo dưới dạng `session_revoked_externally`.
- Mặc dù đây là phiên duy nhất của tài khoản (**Đặt đây là phiên duy nhất** hoặc phiên tự động), danh sách phiên vẫn được đọc mỗi hai phút trong quá trình theo dõi và khi có kết nối được thiết lập, do đó giá trị ``session.exclusive_ended`` sẽ được ghi lại khi có phiên khác xuất hiện. 777000 vẫn chưa được đọc trong khoảng thời gian đó, mặc dù bản ghi ``session.exclusive_from`` cho thấy các thông báo đăng nhập của Telegram vẫn tiếp tục được ghi lại.
- Các thông báo xóa chỉ được so sánh với kiểm tra phiên làm việc nếu có một phiên được thực hiện trong 10 phút qua (khi đây là phiên duy nhất, hoặc sau khi mở **các phiên làm việc của tài khoản này**). Nếu không, trừ khi lần kiểm tra quyền gần nhất cho thấy tài khoản này không thể xóa tin nhắn (điều này không bao giờ xảy ra trong các cuộc trò chuyện riêng tư và nhóm thông thường), thông báo sẽ hiển thị: *Không rõ ai đã xóa tin nhắn này: chính tài khoản này, từ một phiên làm việc hoặc thiết bị khác, cũng có thể đã xóa nó.*
- Với khóa phiên đã được nhập vào, không có thông tin nào trong nhật ký cho biết thời gian phiên này đăng nhập cho đến khi danh sách phiên được đọc (ví dụ: trong phần **Các phiên của tài khoản này**). Cho đến lúc đó, các bản xuất tin nhắn trò chuyện và các bản xuất tài khoản **tự động** sẽ sử dụng phiên thông thường thay vì Takeout, với lý do là `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.
- Cài đặt nội dung nhạy cảm của tài khoản sẽ không bị đọc hay thay đổi. Nếu không bật công tắc này, mỗi lần đăng nhập và mỗi lần kết nối mới sẽ kích hoạt cài đặt này khi nó đang tắt, và Telegram cho phép thay đổi (`account.content_settings`); cài đặt này thuộc về tài khoản và được áp dụng trên mọi ứng dụng Telegram. Nội dung mà Telegram đánh dấu là nhạy cảm có thể vẫn bị ẩn.
- Các cập nhật từ cuộc gọi điện thoại không được ghi lại dưới dạng ``account.phone_call``.
- Việc dừng quan sát chỉ ghi lại dấu vân tay của khóa phiên; nó không đọc danh sách phiên hay 777000.

Tính năng này không giới hạn những gì Telegram gửi: các cập nhật của mọi cuộc trò chuyện vẫn được chuyển đến phiên làm việc này, và chỉ những cuộc trò chuyện đã chọn mới được ghi lại. Danh sách cuộc trò chuyện của tài khoản (bao gồm **các cuộc trò chuyện đã đọc trong danh sách tài khoản**) và các thư mục của nó vẫn được đọc khi bắt đầu, và một lần nữa khi phạm vi được lưu lại trong quá trình theo dõi, nhằm tìm ra các cuộc trò chuyện đã chọn. Các thông báo xóa không kèm theo cuộc trò chuyện (`deletion.unscoped`) vẫn được ghi lại: chúng chỉ chứa ID tin nhắn và có thể thuộc về một cuộc trò chuyện riêng tư đã chọn hoặc một nhóm thông thường. Kiểm tra tài khoản bị đóng băng (`help.getAppConfig`), các kiểm tra kết nối khác và các tính năng bạn tự bật (tự động kết thúc các phiên khác, kiểm tra nhân chứng, cuộc trò chuyện bí mật giả, **Các phiên của tài khoản này** và danh sách thiết bị đã đăng nhập của Telegram trong **mục Thêm nhân chứng**, tính năng này đọc danh sách phiên tại mỗi lần qua dấu thời gian và thiết lập các mốc thời gian cho các mục tiêu **Theo dõi các cuộc trò chuyện** và **Bằng chứng cho một vụ việc**) vẫn tiếp tục hoạt động.

Hãy bật tính năng này trước khi đăng nhập; nếu không, chính quá trình đăng nhập sẽ kiểm tra quyền truy cập hiện tại và kích hoạt nội dung nhạy cảm. Mỗi thay đổi là một bản ghi `scope.changed` đã được ký, và `observation.started` chứa giá trị này dưới dạng `scope.strict`. Việc chuyển sang một thư mục hoặc toàn bộ tài khoản sẽ tắt tính năng này.

## Phạm vi và việc lựa chọn sự kiện

Mỗi không gian làm việc có các nguồn riêng. TgWitness không tham gia nhóm, chấp nhận lời mời hoặc liệt kê tự động mọi thành viên. Các nguồn phải đã có sẵn cho tài khoản. Khi khởi động, bộ thu thập kiểm tra các nguồn đã chọn so với các cuộc trò chuyện hiển thị của tài khoản; 1,000 cuộc trò chuyện đầu tiên sẽ được kiểm tra trừ khi **cài đặt trong Công cụ khác → Thông số → Cuộc trò chuyện được đọc từ danh sách tài khoản** quy định khác. Một nguồn vắng mặt sẽ được đánh dấu là **chưa xác nhận quyền truy cập**, chứ không được coi là đã xóa bạn.

| Bối cảnh | Thu thập | Tác động khi bị vô hiệu hóa |
| --- | --- | --- |
| Tin nhắn mới | Các tin nhắn đã được gửi đi thông thường | Các thao tác chỉnh sửa/xóa sau này có thể không có văn bản đã được ghi lại trước đó để so sánh. |
| Các chỉnh sửa | Cung cấp các phiên bản tin nhắn đã được chỉnh sửa | Các thay đổi ở giai đoạn trung gian sẽ không được tái tạo lại sau này. |
| Các hành động xóa | Thông báo xóa có phạm vi cụ thể và thông báo cấp tài khoản không có phạm vi cụ thể | Các thông báo xóa tin nhắn sẽ không được thêm vào sổ ghi chép. |
| Phản hồi | Các bản chụp nhanh phản ứng đã được cung cấp | Các bản cập nhật phản hồi riêng lẻ sẽ không được bổ sung. |
| Thành viên | Đã gửi các thông báo về dịch vụ thành viên và thông tin cập nhật cho người tham gia | Các quan sát liên quan đến tư cách thành viên không được bổ sung vào đây. |

Các cài đặt này áp dụng cho tất cả các nguồn đã chọn trong không gian làm việc. Vui lòng lưu biểu mẫu để áp dụng các thay đổi; các thay đổi sẽ được ghi lại kèm theo các giá trị trước và sau đã được ký xác thực. Việc vô hiệu hóa một danh mục sẽ không xóa các bản ghi trước đó. Việc kích hoạt lại danh mục này sẽ không khôi phục các bản cập nhật đã bỏ lỡ.

Các bản ghi hoạt động và các sự kiện dịch vụ nhóm khác vẫn được tách biệt với các tùy chọn này. Các tin nhắn dịch vụ thành viên có thể tạo bản ghi tin nhắn khi tính năng thành viên được kích hoạt, ngay cả khi tính năng ghi lại tin nhắn mới thông thường bị tắt. Các đối tượng Telegram được ghi lại vẫn giữ nguyên siêu dữ liệu nhúng; một tùy chọn không phải là quy tắc che giấu thông tin.

**Các thao tác xóa trong cuộc trò chuyện riêng tư và nhóm thông thường** được gửi dưới dạng ID tin nhắn mà không kèm theo cuộc trò chuyện. Các cuộc trò chuyện này chia sẻ một chuỗi ID tin nhắn chung cho toàn tài khoản, do đó khi một tin nhắn có ID đó đã được lưu trước đó, cuộc trò chuyện của nó sẽ được xác định: thao tác xóa được ghi lại trong cuộc trò chuyện đó kèm theo tham số `chat_resolution` giải thích cách thức. Các ID chưa từng được lưu sẽ là thao tác **xóa không xác định phạm vi** với một cuộc trò chuyện chưa được xác định rõ ràng. Đây là các thông báo xóa của Telegram, được lưu giữ ngay cả khi cuộc trò chuyện liên quan chưa thể được xác định. Cấu trúc của thông báo chứa các ID; nhật ký bổ sung thời gian nhận và bất kỳ bối cảnh tin nhắn đã lưu nào, bao gồm `deleted_message_was_outgoing`. Các mục nhật ký quản trị có sẵn cung cấp một nguồn riêng biệt về hành động, người thực hiện và thời gian nguồn.

## Các hành động của chính mình

Các tin nhắn được gửi từ tài khoản đang được theo dõi sẽ được gắn nhãn `outgoing`. Việc chỉnh sửa một tin nhắn gửi đi ghi chú rằng trong các cuộc trò chuyện riêng tư và nhóm, chỉ tác giả của tin nhắn đó mới có thể chỉnh sửa, trong khi các bài đăng trên kênh có thể được chỉnh sửa bởi các quản trị viên khác. Khi một tin nhắn gửi đi lặp lại nội dung của một nút từ bàn phím trả lời được lưu gần đây nhất trong cuộc trò chuyện đó, tin nhắn này sẽ mang mã `button_press` kèm theo liên kết đến bản ghi của bàn phím đó.

Việc loại trừ các hành động do chính người dùng thực hiện cũng áp dụng cho việc kiểm tra lại nền và lịch sử cuộc trò chuyện mới tự động. Các tin nhắn gửi đi bị bỏ qua sẽ làm dịch chuyển vị trí kiểm tra lại, do đó chúng không thể chặn các tin nhắn đến sau đó. Các thao tác rõ ràng trên bảng điều khiển và các bản chụp lịch sử được yêu cầu thủ công vẫn được ghi lại.

## Chế độ điều tra: tham gia các nhóm và trao đổi với các bot

**Các công cụ khác → Nguồn → Phạm vi → Chế độ điều tra** chuẩn bị phạm vi cho một tài khoản chuyên dụng tham gia các cuộc trò chuyện nhóm, khởi chạy bot và gửi tin nhắn đến chúng: toàn bộ tài khoản, mọi loại nguồn, các hành động của chính tài khoản, và đối với mỗi cuộc trò chuyện hoặc bot xuất hiện, hồ sơ của nó cùng 200 tin nhắn hiển thị gần nhất. Kiểm tra biểu mẫu và nhấn **Lưu phạm vi**; việc chuyển sang toàn bộ tài khoản sẽ yêu cầu xác nhận thông thường.

- **Các nút.** Các nút nằm dưới một tin nhắn sẽ được giữ nguyên cùng với tin nhắn đó và hiển thị trong **phần Trò chuyện**: các liên kết, ứng dụng web , liên kết đăng nhập, văn bản cần sao chép, dữ liệu gọi lại, truy vấn nội tuyến, yêu cầu cung cấp số điện thoại hoặc vị trí. Các liên kết được hiển thị dưới dạng văn bản và không bao giờ được bảng điều khiển mở ra. Khi một bot chỉ thay đổi các nút (ví dụ: một liên kết thanh toán mới), đó được coi là một phiên bản mới của tin nhắn, áp dụng cho cả các bản cập nhật trực tiếp lẫn các lần kiểm tra lại.
- **Các cuộc trò chuyện và bot mới.** Ở chế độ theo thư mục và toàn bộ tài khoản, **khi một cuộc trò chuyện hoặc bot mới xuất hiện**, hệ thống sẽ lưu lại ngay lập tức sau khi nó xuất hiện:

  - hồ sơ của nó dưới dạng bản ghi `source.profile`: mô tả bot và các lệnh, phần giới thiệu về người dùng, nhóm hoặc kênh, danh sách thành viên, liên kết cuộc trò chuyện và liên kết mời khi Telegram cung cấp liên kết đó;
  - các tin nhắn hiển thị gần đây nhất (tối đa 1.000 tin nhắn) dưới dạng bản chụp lịch sử được đánh dấu là `new_chat`: các tin nhắn trước đó trong một cuộc trò chuyện nhóm vừa tham gia, hoặc những gì bot đã nói trước khi hệ thống giám sát phát hiện ra cuộc trò chuyện đó. Các tin nhắn đã được lưu trữ trực tiếp sẽ không được lặp lại.

  Các cuộc trò chuyện vừa được chọn sẽ sử dụng các cài đặt này khi phạm vi được áp dụng, bao gồm cả các cuộc trò chuyện đã có sẵn trong danh sách hội thoại của tài khoản. Quá trình tải hồ sơ và lịch sử ban đầu diễn ra đồng thời cho tối đa ba cuộc trò chuyện; các tác vụ liên quan đến cùng một cuộc trò chuyện vẫn được thực hiện theo thứ tự. Mỗi giai đoạn xử lý lịch sử/hồ sơ sử dụng thời gian chờ hoạt động đã được cấu hình, do đó các yêu cầu bị đình trệ sẽ giải phóng công nhân của chúng. Lịch sử được lưu trước khi đọc hồ sơ (tùy chọn); việc đọc hồ sơ thất bại không ngăn cản việc ghi lại lịch sử đó. Các giai đoạn thất bại sẽ thử lại sau 5 giây, thời gian chờ tăng gấp đôi lên tối đa 5 phút mà không chiếm dụng nhân viên xử lý trong thời gian trì hoãn. ID đang chờ xử lý, thời hạn thử lại và các giai đoạn đã hoàn thành được lưu trữ cục bộ. Khi khởi động lại, hệ thống chỉ tiếp tục các giai đoạn chưa hoàn thành; việc thử lại hồ sơ không lặp lại quá trình đọc lịch sử đã hoàn tất. Các nguồn bị vô hiệu hóa trước khi đến lượt sẽ bị bỏ qua. Bảng tổng quan hiển thị các cuộc trò chuyện đang hoạt động, đang chờ xử lý và đang thử lại riêng biệt với việc tải xuống tệp đính kèm. FloodWait tạm dừng công việc này và nó sẽ tiếp tục sau đó; các lỗi được ghi lại và việc ghi lại trực tiếp cuộc trò chuyện vẫn tiếp tục. Điều này bao gồm thời gian chờ trong khi xác định danh tính của cuộc trò chuyện mới: tác vụ hồ sơ/lịch sử đang chờ xử lý được giữ lại để thử lại, và thời gian chờ dài hơn hiện có trên toàn tài khoản sẽ không bị rút ngắn. Các công nhân chia sẻ thời gian chờ này; tính đồng thời không vượt qua giới hạn yêu cầu của Telegram. - **Hồ sơ theo yêu cầu.** **Trò chuyện → Hồ sơ → Lưu hồ sơ hiện** lưu hồ sơ hiện tại của bất kỳ nguồn nào; hồ sơ mới nhất được hiển thị phía trên các tin nhắn. - **Ảnh chụp nhanh trạng thái cuộc trò chuyện (bản xem trước).** Trạng thái bên ngoài luồng tin nhắn thay đổi mà không cần tin nhắn: việc gỡ ghim mọi tin nhắn không để lại dấu vết ở cấp độ tin nhắn, một quản trị viên mất quyền, một món quà bị ẩn, chuyển đổi, nâng cấp hoặc hoàn tiền. Trong quá trình quan sát, mọi nguồn được kích hoạt đều được đọc định kỳ và lưu dưới dạng bản ghi có chữ ký `chat.state` : tiêu đề, tên người dùng, mô tả, số lượng thành viên và quản trị viên, cuộc trò chuyện được liên kết, chế độ chậm, ID tin nhắn được ghim (tối đa 100), quản trị viên cùng quyền hạn và chức danh của họ, cũng như quà tặng hiển thị trên các kênh và hồ sơ người dùng (tối đa 100). Mỗi bản ghi liệt kê các điểm khác biệt so với bản chụp nhanh trước đó: các trường đã thay đổi kèm theo giá trị trước và sau, tin nhắn được ghim được thêm hoặc xóa, quản trị viên và quà tặng được thêm, thay đổi hoặc không còn được liệt kê. - Phần mà Telegram từ chối cung cấp (ví dụ: danh sách quản trị viên của một kênh đối với một thành viên không phải là quản trị viên) sẽ được nêu tên trong `errors`; giá trị trước đó của nó được giữ lại và liệt kê trong `carried_forward`, không bao giờ được báo cáo là đã bị xóa. - Một bản ghi mà những thay đổi duy nhất là số lượng, và một kiểm tra không phát hiện thay đổi nào, sẽ tham chiếu đến trạng thái đầy đủ cuối cùng với `state_seq` và tích lũy `state_overrides`. Một trạng thái đầy đủ được ghi lại ít nhất mỗi bảy ngày và bất cứ khi nào có thay đổi nào khác ngoài số lượng. - `parts_complete` đánh dấu các danh sách có giới hạn. Việc thêm vào yêu cầu phải có danh sách trước đó đầy đủ, việc xóa yêu cầu phải có danh sách hiện tại đầy đủ, và các giá trị trống rõ ràng ghi lại việc xóa sạch bản ghi. - **Công cụ khác → Thông số → Trạng thái trò chuyện** thiết lập khoảng thời gian (mặc định là 12 giờ, 0 sẽ tắt tính năng chụp nhanh ), khoảng dừng giữa các nguồn, những phần nào được đọc, và liệu các kiểm tra không phát hiện thay đổi có được ghi lại hay không. `FLOOD_WAIT` và `FLOOD_PREMIUM_WAIT` dừng các yêu cầu chụp nhanh còn lại, giữ nguyên bất kỳ thời hạn toàn tài khoản nào còn hiệu lực, và để cuộc trò chuyện bị gián đoạn đủ điều kiện để thử lại sau khoảng thời gian chờ đó. - **Không hiển thị.** Các nút nhúng (callback) được nhấn trong ứng dụng Telegram khác, cửa sổ bật lên hoặc liên kết mà bot trả lời khi nhấn nút đó, và các liên kết mời được sử dụng trong ứng dụng khác sẽ không đến TgWitness. Những gì bot gửi hoặc chỉnh sửa sau đó sẽ được ghi lại.

### Hành động từ bảng điều khiển

**Tính năng Trò chuyện** hiện đã tích hợp một ứng dụng khách thu nhỏ sử dụng tài khoản Telegram của không gian làm việc đã chọn:

- Quý vị có thể soạn một tin nhắn dạng văn bản thuần túy hoặc chọn **“Trả lời”** bên dưới một tin nhắn đã lưu. Tin nhắn gửi đi được trả về sẽ được ghi lại ngay cả khi phạm vi ghi lại không bao gồm các cập nhật tin nhắn gửi đi.
- Nhấn **nút “Press”** bên dưới nút gọi lại hoặc nút văn bản hiện tại. Máy chủ sẽ lấy lại tin nhắn và từ chối thao tác nếu nội dung trên bàn phím khác với phiên bản đã lưu. Biên nhận gọi lại vẫn giữ nguyên văn bản cửa sổ bật lên, cờ cảnh báo và URL của Telegram; câu trả lời cũng được hiển thị bên dưới cuộc trò chuyện. Các URL vẫn là văn bản có thể chọn và không được mở tự động.
- Nhấn **+** → **Mở liên kết Telegram**, nhập `@username`, một liên kết công khai `https://t.me/name`, `https://t.me/+invite` / `joinchat/invite`, hoặc liên kết bot có `?start=parameter`, rồi nhấn **Lưu bản xem trước**. Liên kết gốc và bản xem trước của Telegram sẽ được xác thực trước khi tham gia. **Tham gia / mở và quan sát,** sau đó tham gia nhóm/kênh hoặc mở người dùng/bot, thêm cuộc trò chuyện làm nguồn được kích hoạt, và gửi lệnh `/start` đến bot, bao gồm tham số khởi động của nó. Yêu cầu tham gia đang chờ phê duyệt của quản trị viên sẽ được ghi nhận là “đang chờ xử lý”, không phải là “thành viên”.

Bật tùy chọn **Bắt đầu quan sát** để ghi lại các phản hồi đến theo thời gian thực. Các thao tác trên bảng điều khiển vẫn hoạt động khi quá trình quan sát bị tạm dừng; bảng điều khiển sau đó lưu các phản hồi trực tiếp của mình, và chế độ quan sát trực tiếp ghi lại phần còn lại của cuộc trò chuyện. Các nguồn mới được thêm vào sẽ sử dụng cấu hình hồ sơ/lịch sử đã thiết lập khi quá trình quan sát đang chạy. Khi một nguồn bị tạm dừng, hãy kích hoạt nó trong **Công cụ khác → Nguồn** trước khi gửi hoặc nhấn các nút của nó.

`interaction.preview`, `interaction.requested` và `interaction.result` là các sự kiện nhật ký có chữ ký thông thường được bao gồm trong các tệp xuất bằng chứng. Các yêu cầu xác định tài khoản, tin nhắn/nút hoặc bản ghi xem trước và liệu quá trình quan sát có đang chạy hay không. Các biên nhận phân biệt giữa thành công, bị từ chối, đang chờ phê duyệt và kết quả không xác định. Một yêu cầu bị gián đoạn có thể đã được gửi đến Telegram: vui lòng kiểm tra cuộc trò chuyện trước khi thực hiện hành động mới. Việc sử dụng lại ID yêu cầu sẽ truy xuất biên nhận đã lưu mà không cần lặp lại thao tác, kể cả sau khi khởi động lại. Bảng điều khiển sẽ giữ lại ID sau khi nhận được phản hồi không rõ ràng cho cùng một thao tác trong phiên trang hiện tại. Nó cũng giữ lại ID đó khi việc làm mới giao diện không thành công sau một thao tác thành công: biên nhận vẫn hiển thị, và việc nhấp lại sẽ truy xuất biên nhận đó. Các RPC gọi lại và tham gia chỉ có một lần thử; các thao tác đọc có thể thử lại sẽ giữ nguyên chính sách thử lại đã cấu hình. Việc chuyển sang cuộc trò chuyện khác ngay lập tức sẽ xóa bản nháp và mục tiêu trả lời, đồng thời vô hiệu hóa việc gửi tin nhắn cho đến khi cuộc trò chuyện mới được tải xong.

Ứng dụng mini này hỗ trợ các nút văn bản và nút gọi lại. Các nút ứng dụng mini sẽ hiển thị tùy chọn **Mở ứng dụng mini**, tính năng này sẽ khởi chạy ứng dụng trong một trình duyệt riêng biệt ([Ứng dụng mini](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Các yêu cầu đăng nhập, số điện thoại và vị trí, thanh toán, truy vấn trực tiếp và tệp đính kèm vẫn cần có ứng dụng Telegram; thông tin meta của các nút đã lưu vẫn hiển thị. Các điều khiển mới sử dụng văn bản tiếng Anh.

## Các cấp độ kiểm tra lại

Quá trình kiểm tra lại sẽ yêu cầu Telegram cung cấp lại các tin nhắn bị bỏ lỡ, các chỉnh sửa và các tin nhắn mà Telegram không còn trả về. Các nguồn được đánh dấu bằng dấu sao là nguồn **ưu tiên**, được kiểm tra lại mỗi 15 phút theo mặc định; tất cả các nguồn khác được kiểm tra lại mỗi 6 giờ. Các cuộc trò chuyện được chọn ban đầu là nguồn ưu tiên, các cuộc trò chuyện được thêm vào qua thư mục hoặc toàn bộ tài khoản sẽ là nguồn thông thường. Tối đa 30 nguồn được kiểm tra lại trong mỗi lần quét và phần còn lại sẽ chờ đến phút tiếp theo; sau khi kết nối lại, các nguồn ưu tiên sẽ được xử lý trước. Cả hai khoảng thời gian này đều được thiết lập trong mục**Công cụ khác → Nguồn → Ghi lại → Kiểm tra lại** (0 để tắt cấp độ) và được ghi lại dưới dạng `recheck.changed`.

Các tin nhắn bị bỏ lỡ sẽ được lấy lại từ điểm dừng của lần quét trước, tối đa là số lượng được thiết lập tại **More tools → Parameters → Missed messages recovered per chat and pass** (mặc định là 1,000). Sau một khoảng thời gian ngừng hoạt động dài, quá trình kiểm tra lại sẽ lấp đầy toàn bộ khoảng trống, ngay cả khi các tin nhắn trực tiếp mới hơn khoảng trống đó đã được lưu trước. Một cuộc trò chuyện vẫn đang trong quá trình cập nhật sẽ được kiểm tra lại vào phút tiếp theo thay vì chờ đến khoảng thời gian định kỳ của nó; `recheck.completed` sẽ hiển thị `continues_after` cho đến khi hoàn tất.

Các yếu tố được so sánh bao gồm nội dung tin nhắn, các thực thể, thao tác trên bàn phím (bao gồm cả việc xóa) và nội dung/thông tin nhận dạng của tệp đính kèm. Việc thay đổi mã băm truy cập tệp hoặc tham chiếu tệp đơn thuần không được coi là một hành động chỉnh sửa, cũng như những thông tin mà Telegram tự động điền vào: quá trình tải bản xem trước liên kết, số lượt xem bài đăng, nội dung đa phương tiện trả phí được mở khóa bởi tài khoản này, hoặc biên lai hóa đơn. Mỗi phiên bản được lưu trong mục “Trò chuyện” đều có liên kết đến bản ghi nhật ký đầy đủ của nó, bao gồm cả siêu dữ liệu phương tiện.

## Lịch sử tin nhắn và nguồn gốc

Giả sử công cụ thu thập ghi nhận “Cuộc họp lúc 10:00”, sau đó thấy “Cuộc họp lúc 11:00”, và tiếp theo nhận được thông báo xóa tin nhắn. Công cụ sẽ bổ sung ba ghi nhận riêng biệt. Nội dung gốc vẫn được giữ nguyên, bản chỉnh sửa là một phiên bản riêng biệt, và thông báo ghi lại rằng đã phát hiện hành vi xóa tin nhắn.

Nếu quá trình thu thập bắt đầu sau khi phiên bản đầu tiên biến mất, thì nội dung văn bản đó sẽ không còn khả dụng. Nếu có nhiều lần chỉnh sửa xảy ra trong thời gian hệ thống ngừng hoạt động, thì chỉ những phiên bản được ghi nhận sau đó mới có thể được lưu lại. Thông báo xóa bỏ không thể khôi phục nội dung chưa từng được ghi lại.

Bản ghi kết hợp nhiều nguồn:

| Nguồn | Thông tin được bảo toàn |
| --- | --- |
| Tin nhắn trực tiếp hoặc cập nhật chỉnh sửa | ID tin nhắn, siêu dữ liệu người gửi, phiên bản được ghi lại, thời gian nhận và ngày gửi/chỉnh sửa tin nhắn Telegram. |
| Thông báo xóa dữ liệu theo thời gian thực | ID tin nhắn được báo cáo, thời gian nhận, thông báo thô và các liên kết đến nội dung đã lưu trước đó. |
| Nhật ký quản trị có sẵn | Hành động, tác nhân, ngày nguồn và nội dung tin nhắn được cung cấp, được đọc bởi một tài khoản có quyền cần thiết. |
| Tương tác với bảng điều khiển | Hành động được yêu cầu và kết quả được ghi lại của hành động đó dưới tài khoản đã chọn. |
| Kiểm tra lại | Phản hồi hiện tại của Telegram so với tin nhắn đã lưu trước đó. |

`observed_at` là thời gian bản ghi được tạo ra theo đồng hồ thu thập và tăng lên cùng với `seq`. Các bản ghi được ghi trong khi xử lý một bản cập nhật trực tiếp cũng chứa `received_at`, thời gian bản cập nhật đến bộ thu thập, và `processing_delay_ms`, thời gian từ khi nhận được đến khi ghi; các bản cập nhật được giữ lại trong khi quá trình quan sát bắt đầu sẽ được xử lý theo thứ tự đến trước, trước các bản cập nhật đến sau. `source_at` giữ lại ngày nguồn nếu sự kiện đó cung cấp thông tin này. Các quan sát về độ lệch đồng hồ của Telegram, các bản ghi về sự gián đoạn đồng hồ và [các kiểm tra thời gian bên ngoài](https://phishdestroy.io/tgwitness/vi/docs/reference/timestamp/) cung cấp bối cảnh thời gian liên quan. Các trường của một thông báo tin nhắn thông thường mô tả thông báo đó; các bản ghi nhật ký quản trị và tương tác giữ lại thông tin nguồn gốc riêng của chúng.

## Các bản chụp lịch sử

Một bản chụp nhanh yêu cầu các tin nhắn hiển thị mới nhất từ một nguồn đã được bật, tối đa 500 tin nhắn cho mỗi yêu cầu. Kết quả được gắn nhãn là các quan sát lịch sử. Các bản chụp nhanh thủ công được thực hiện song song với quá trình quan sát. Các quan sát lặp lại được lưu giữ dưới dạng các bản ghi riêng biệt. Việc bật một nguồn cũng sẽ tạo ra một bản chụp nhanh `baseline`, trừ khi [tính năng chọn lọc cuộc trò chuyện nghiêm ngặt](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#strict-chosen-chats) đang được bật.

Việc tạo bản chụp nhanh sẽ dừng lại nếu nguồn bị vô hiệu hóa trong quá trình đọc. Các phản hồi phải thuộc về cuộc trò chuyện được yêu cầu và chứa các ID tin nhắn dương giảm dần một cách nghiêm ngặt dưới giới hạn được yêu cầu. Một phản hồi không hợp lệ sẽ làm gián đoạn quá trình tạo bản chụp nhanh trước khi tin nhắn đó được lưu; các tin nhắn đã được lưu giữ vẫn tồn tại trong nhật ký đã ký cùng với bản ghi về sự gián đoạn.

Các bản chụp nhanh tuân thủ chính sách đính kèm nhưng vẫn tách biệt với các chuyển đổi sự kiện trực tiếp. Chúng không khôi phục các tin nhắn đã bị xóa hoặc các phiên bản trung gian bị bỏ lỡ. Quý vị có thể yêu cầu tạo bản chụp nhanh khi quá trình đang tạm dừng; mọi tệp đính kèm được xếp hàng sẽ chờ cho đến khi quá trình quan sát bắt đầu và trình xử lý tải xuống được khởi chạy.

Lượt chạy **Lịch sử** là tác vụ độc quyền riêng: đọc nguồn đã chọn và tải lần lượt các tệp đính kèm trong hàng đợi mà không khởi động giám sát. Tạm dừng sẽ giải phóng tài khoản; tiếp tục sẽ nối lại lượt chạy đã lưu. Để lọc ngày, ngôn ngữ và phản hồi trên nhiều tài khoản rảnh, xem [Xuất cuộc trò chuyện phân tán](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md).

## Xử lý tệp đính kèm

Tính năng tải xuống tệp đính kèm được bật theo mặc định và sẽ tạm dừng khi dung lượng đĩa trống còn dưới 1 GiB. Trình thu thập sẽ thực hiện công việc quan sát tin nhắn và tải xuống cùng lúc. Công việc này giữ nguyên thông tin mô tả phương tiện gốc và chính sách về kích thước, do đó tệp đính kèm bị chỉnh sửa sau này sẽ không bị thay thế một cách âm thầm.

Quá trình tải xuống diễn ra sau khi thu thập tin nhắn. Một lần tải xuống hoàn tất sẽ tạo ra bản ghi `media.saved` kèm theo giá trị SHA-256 và số byte. Các trường hợp bị bỏ qua, thất bại, thử lại và bị gián đoạn có kết quả riêng biệt; một tệp được coi là đã được lưu giữ khi bản ghi `media.saved` của nó tồn tại. Tệp đã hoàn tất cũng phải khớp với số byte trong mô tả tệp đính kèm ban đầu được quan sát. Phản hồi ngắn hơn hoặc dài hơn dự kiến sẽ không được ghi nhận là phương tiện đã được lưu giữ.

Tệp và mục thư mục của nó được ghi ra đĩa trước khi ghi giá trị ``media.saved``. Khi quá trình thu thập dữ liệu trước đó kết thúc mà không được dừng một cách có trật tự, lần khởi động tiếp theo sẽ đọc tất cả các tệp được ghi nhận là đã lưu trong lần chạy đó. Một tệp bị thiếu hoặc có các byte khác với giá trị SHA-256 đã ghi sẽ được gán bản ghi ``media.missing_after_restart``, quá trình tải xuống của tệp đó sẽ được xếp lại vào hàng đợi, và các byte khác biệt sẽ được chuyển vào thư mục ``media-damaged/``. Các tệp đã được chuyển sang kho lưu trữ ngoài sẽ không được đọc.

Trong cùng một không gian làm việc, các tác vụ đang xếp hàng đồng thời cho cùng một bản thể hiện tệp đính kèm sẽ chờ quá trình truyền dữ liệu đang hoạt động, sau đó kiểm tra lại các byte đã lưu trước khi tái sử dụng. Mỗi tác vụ lưu giữ kết quả có dấu và tham chiếu riêng đến bản ghi tệp đã lưu trước đó. Việc hủy bỏ một tác vụ đang chờ không làm hủy bỏ quá trình truyền dữ liệu đang hoạt động; nếu quá trình truyền đó thất bại hoặc bị hủy bỏ, tác vụ tiếp theo có thể thử lại. Các tệp đính kèm khác nhau có thể được tải xuống đồng thời.

Các tác vụ có cùng tài khoản, đại diện, kích thước dự kiến và hành động thu thập sẽ được giữ trong hàng đợi trong khi một tác vụ phù hợp đang được thực thi. Chúng không chiếm các khe tải xuống, do đó các tệp khác vẫn có thể bắt đầu tải xuống ngay cả khi hàng đợi ban đầu chứa nhiều bản sao của một tệp tải chậm. Việc hoàn tất một lần thử sẽ kích hoạt lại hàng đợi. Các làn ưu tiên, thời gian chờ thử lại đã lưu và quyền sở hữu lịch sử vẫn được áp dụng; mỗi lần quan sát sẽ nhận được kết quả riêng của mình.

Các tác vụ xuất dữ liệu qua trò chuyện cũng chia sẻ một luồng truyền dữ liệu đang hoạt động để xử lý các bản sao lặp lại của tệp trong cùng một thư mục xuất. Mỗi tin nhắn giữ nguyên tham chiếu đến tệp đính kèm của mình, và việc tái sử dụng yêu cầu kiểm tra lại kích thước và mã băm SHA-256. Các tệp khác nhau có thể được kiểm tra song song mà không cần giữ khóa khóa truyền dữ liệu chung. Các đường dẫn tải xuống và sao chép tạm thời là duy nhất cho từng thao tác; quá trình hủy bỏ sẽ chờ cho đến khi tất cả các trình đọc tệp cục bộ đang hoạt động hoàn tất trước khi dọn dẹp. Chỉ mục tệp xuất chỉ tuần tự hóa việc truy cập siêu dữ liệu, không bao gồm việc tính băm tệp hay tải xuống.

Các thao tác đọc băm trên máy chủ cho các tệp đính kèm khác nhau cũng diễn ra đồng thời, chia sẻ ba khe yêu cầu tệp của máy khách với các hoạt động tải xuống theo byte. Các lần đọc lặp lại cùng một biểu diễn chỉ tái sử dụng kết quả đã được lưu trong bộ nhớ đệm hoàn chỉnh. Các thao tác đọc tệp không chiếm dụng hàng đợi yêu cầu thông thường; các thời hạn FloodWait đã lưu sẽ được kiểm tra lại khi một yêu cầu nhận được một khe.

Các giới hạn được thiết lập **theo từng loại**: ảnh, video, GIF và hình động, tin nhắn video dạng vòng lặp, tin nhắn thoại, nhạc và âm thanh, nhãn dán, và tệp tin. Mỗi loại có thể được tắt và có giới hạn dung lượng riêng từ 1 đến 2.000 MiB; các không gian làm việc mới bắt đầu với 20 MiB cho ảnh, 100 MiB cho video, 50 MiB cho tệp tin, âm thanh và video tròn, 20 MiB cho tin nhắn thoại và GIF, cùng 5 MiB dành cho nhãn dán. Các không gian làm việc mới sẽ để GIF và nhãn dán ở trạng thái tắt cho đến khi được bật. Các không gian làm việc có chính sách được lưu trước khi áp dụng giới hạn theo từng loại sẽ giữ tất cả các loại ở trạng thái bật và duy trì giới hạn chung duy nhất cho mỗi loại. *Giới hạn kích thước tệp tối đa* sẽ áp dụng đồng thời cho mọi loại. Một loại bị tắt sẽ tạo ra bản ghi `media.skipped`; các tệp có kích thước không xác định hoặc vượt quá giới hạn sẽ không được tải xuống. Các tệp lớn sẽ có thời gian tải xuống thêm dựa trên kích thước của chúng và tốc độ cơ bản là 256 KiB/s. Các tác vụ vẫn tồn tại sau khi khởi động lại, nhưng các tham chiếu đã hết hạn, quyền truy cập bị mất hoặc các tệp đã bị xóa vẫn có thể cản trở việc khôi phục. Các tác vụ đang chờ sẽ giữ nguyên giới hạn đã lưu kèm theo chúng, do đó việc tăng giới hạn chỉ áp dụng cho các tệp mới. Việc tắt một loại tệp hoặc giảm giới hạn của loại đó cũng sẽ bỏ qua các tệp đang chờ thuộc loại bị loại trừ, mỗi tệp sẽ có một bản ghi `media.skipped`; việc tắt tính năng tải xuống sẽ tạm dừng hàng đợi cho đến khi tính năng này được bật lại.

## Tạm dừng, khóa, ngắt kết nối và khởi động lại

| Hành động hoặc điều kiện | Hiệu quả |
| --- | --- |
| Chuyển đổi không gian làm việc | Thay đổi chế độ xem bảng điều khiển; các trình thu thập khác vẫn giữ nguyên trạng thái của chúng. |
| Khóa bảng điều khiển hoặc đóng tab | Giữ cho máy chủ và quá trình giám sát tiếp tục hoạt động. |
| Tạm dừng quan sát | Tạm dừng quá trình thu thập và bảo toàn các tệp đính kèm đang chờ xử lý. |
| Vô hiệu hóa một nguồn | Tính năng này sẽ ngừng việc ghi lại theo phạm vi trong tương lai; các tác vụ phương tiện đang chờ xử lý sẽ bị tạm dừng trong thời gian tính năng này bị vô hiệu hóa. |
| Loại bỏ một nguồn | Hệ thống sẽ loại bỏ nguồn này và xóa các hồ sơ người dùng liên quan; các bản ghi đã được lưu trữ vẫn được giữ lại trong sổ nhật ký chỉ ghi thêm. Các tệp đính kèm vẫn đang chờ xử lý sẽ được ghi nhận là thất bại (`source_removed`). Trong chế độ theo thư mục và chế độ toàn tài khoản, các tệp này cũng sẽ bị loại trừ. |
| Thay đổi lộ trình kết nối | Yêu cầu tạm dừng, đóng các phiên khách hàng cũ và hủy các phiên đăng nhập chưa hoàn tất. |
| Dừng tiến trình Python | Tạm dừng tất cả các không gian làm việc; không có bất kỳ ghi nhận nào được thực hiện trong thời gian công cụ này ở chế độ ngoại tuyến. |
| Khởi động lại sau khi quan sát tích cực | Hệ thống sẽ cố gắng khôi phục phạm vi đã lưu bằng cách sử dụng phiên làm việc đã lưu. Việc tạm dừng thủ công sẽ hủy bỏ ý định đó. |

Bộ thu thập ghi lại các sự cố ngắt kết nối, lần thử lại, lỗi, khởi động/dừng và nhịp đập được phát hiện. Các gián đoạn ngắn có thể bị bỏ sót trong các kiểm tra kết nối định kỳ. Sau khi khởi động lại, các bản cập nhật bị bỏ sót sẽ được yêu cầu từ vị trí cập nhật đã lưu và các cuộc trò chuyện được quan sát sẽ được kiểm tra lại định kỳ; xem [định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#durable-collection-and-process-receipts-02). Một bản chụp nhanh thêm trạng thái hiện tại làm bối cảnh, và khoảng trống vẫn được ghi lại.

## Cách ly và xác minh tài khoản

Mỗi không gian làm việc đều có sổ nhật ký, quyền truy cập, khóa ký, chính sách và hàng đợi riêng. Chỉ khách hàng đang hoạt động của không gian làm việc đó mới có thể đóng góp các quan sát trực tiếp. Các khách hàng bị từ chối, đang chờ xử lý, bị thay thế và đang kiểm tra kết nối không thể ghi các cập nhật trực tiếp vào sổ nhật ký của không gian làm việc đó. Các tài khoản khác nhau có thể theo dõi cùng một nhóm, nhưng sổ nhật ký của họ vẫn được tách biệt.

Mỗi sự kiện bao gồm mã băm trước đó và chữ ký Ed25519. Các tệp xuất bao quát toàn bộ nhật ký không gian làm việc thông qua một số thứ tự cố định. Các bộ lọc trên bảng điều khiển không lọc dữ liệu xuất; quá trình thu thập có thể tiếp tục vượt ra ngoài ranh giới của nhật ký trong khi tệp xuất đang được chuẩn bị.

**Tính năng Xác minh Nhật ký** sẽ kiểm tra chuỗi sự kiện và các chữ ký thông qua phạm vi hiển thị. Kết quả của tính năng này sẽ bị xóa khi không gian làm việc thay đổi, và bảng điều khiển sẽ xác định các bản ghi mới được thêm vào sau khi kiểm tra. Tính năng xuất dưới dạng ZIP cũng xác minh các tệp phương tiện đã thu thập.

Giữ nguyên các dấu vân tay và điểm kiểm tra một cách độc lập. Xem phần “ [Phạm vi xác minh](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#verification-scope)” để biết các kiểm tra thu thập dữ liệu trong từng chế độ, và phần “[Hoạt động hàng ngày](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/)” để biết việc thu thập dữ liệu định kỳ.
