Referensi / Kumpulkan
Telegram · Cara kerja pengumpulan data
Ruang lingkup pengamatan, pembaruan langsung, pemeriksaan ulang, lampiran, tindakan pengguna, dan arti dari "gap", per catatan.
TgWitness / Dokumentasi · Koleksi
TgWitness mencatat apa yang diamati oleh akun Telegram yang terhubung. Pemantauan langsung menyimpan pesan, suntingan yang terekam, pemberitahuan penghapusan, dan lampiran beserta waktu pengamatan serta konteks sumbernya. Riwayat pembacaan, pemeriksaan ulang, dan catatan log admin yang tersedia menambahkan pengamatan yang diidentifikasi secara terpisah ke catatan tersebut.
Di halaman ini
- Dari login hingga jurnal
- Ruang lingkup pengamatan: obrolan yang dipilih, sebuah folder, atau seluruh akun
- Ruang lingkup dan pemilihan peristiwa
- Tindakan sendiri
- Mode Investigasi: bergabung dengan tim dan berkomunikasi dengan bot
- Tingkat pemeriksaan ulang
- Riwayat pesan dan atribusi
- Cuplikan riwayat
- Penanganan lampiran
- Jeda, kunci, putuskan sambungan, dan mulai ulang
- Isolasi dan verifikasi akun
Dari proses login hingga jurnal#
Untuk foto dan berkas yang dapat menghancurkan diri sendiri, lihat Media yang Dapat Menghancurkan Diri Sendiri. Bagian ini menjelaskan pekerja prioritas, hasil yang tersimpan dan tidak tersedia, serta batasan pemblokiran tanda terima pembacaan di pengumpul API.
Diagram dalam bentuk teks
- Otorisasi akun pengguna → Pilih grup dan saluran yang dapat diakses
- Pilih grup dan saluran yang dapat diakses → Simpan pengaturan peristiwa dan lampiran
- Simpan pengaturan peristiwa dan lampiran → Mulai pemantauan
- Mulai pemantauan → Dapatkan pembaruan dari klien yang aktif
- Dapatkan pembaruan dari klien yang aktif → Terapkan kebijakan sumber dan peristiwa
- Terapkan kebijakan sumber dan peristiwa → Tambahkan pengamatan yang ditandatangani
- Tambahkan pengamatan yang ditandatangani → Tinjau atau ekspor jurnal tersebut
- Tambahkan pengamatan yang ditandatangani → Memproses lampiran yang ada dalam antrian
- Memproses lampiran yang ada dalam antrian → Tambahkan hasil unduhan
Otorisasi, akses ke sumber, pengumpul yang sedang berjalan, dan pengiriman lengkap adalah masalah yang berbeda. Login yang berhasil tidak memberikan akses ke setiap grup. Pengiriman dilacak secara terpisah: catatan cakupan, pemulihan celah pembaruan, dan pemeriksaan ulang menunjukkan apa yang telah diterima.
Cakupan pemantauan: obrolan yang dipilih, sebuah folder, atau seluruh akun#
Alat lainnya → Sumber → Ruang Lingkup menentukan obrolan mana yang direkam oleh ruang kerja.
Pengaturan baru dimulai dengan opsi Pilih obrolan. Pilihan yang sudah disimpan tetap dipertahankan. Jika memilih Semua obrolan dalam panduan pengaturan, sistem akan meminta konfirmasi jika daftar yang dimuat berisi lebih dari 50 obrolan; perkiraan ukuran tetap merupakan proses terpisah yang didasarkan pada sampel.
| Mode | Merekam | Obrolan baru |
|---|---|---|
| Obrolan yang dipilih (default) | Hanya obrolan yang Anda tambahkan secara manual | Tidak pernah ditambahkan secara otomatis |
| Folder Telegram | Percakapan dalam salah satu folder akun: percakapan yang disertakan berdasarkan nama, ditambah kategori folder tersebut (kontak, bukan kontak, grup, saluran, bot), dikurangi percakapan yang dikecualikan, dan, jika folder tersebut mencantumkannya, percakapan yang diarsipkan | Obrolan yang sesuai akan ditambahkan segera setelah aktif; obrolan yang Anda tambahkan ke folder di Telegram akan terdeteksi dalam waktu satu jam |
| Akun lengkap | Setiap obrolan yang dilihat oleh akun tersebut | Setiap obrolan baru, grup, obrolan pribadi, atau bot akan ditambahkan begitu pembaruan pertamanya tiba |
- Jenis sumber (saluran, grup, obrolan pribadi, bot) membatasi mode folder dan mode seluruh akun. Obrolan yang dipilih dapat berupa jenis apa pun, termasuk obrolan pribadi dan bot; jenis sumber tidak akan pernah menghentikan obrolan yang Anda tambahkan secara manual. Jenis yang dinonaktifkan, pengecualian, atau peralihan ke obrolan yang dipilih akan menghentikan sumber yang ditambahkan secara otomatis segera setelah disimpan, sebelum daftar sumber dihitung ulang dan juga saat Telegram tidak dapat diakses: pesan baru mereka, riwayat yang telah berlalu, riwayat obrolan baru, pengaturan rekan, dan pengamatan profil.
- Obrolan yang Anda tambahkan secara manual tetap terekam dalam mode folder dan mode seluruh akun, meskipun obrolan tersebut berada di luar folder; hanya opsi Kecualikan, Hapus, atau penundaan yang dapat menghentikannya. Obrolan yang ditambahkan secara otomatis mengikuti folder: obrolan yang keluar dari folder akan ditangguhkan pada perhitungan ulang berikutnya.
- Obrolan yang dikecualikan tidak pernah direkam, dalam mode apa pun. Dalam mode folder dan seluruh akun, opsi Kecualikan dan Hapus pada sumber akan memasukkannya ke dalam daftar ini, sehingga sistem tidak akan menambahkannya lagi. Memilih obrolan tersebut kembali secara manual (di Sumber, dari Obrolan, atau di Pengaturan → Obrolan mana?) akan menghapusnya dari daftar. Daftar ini dapat menampung hingga 5.000 obrolan; jika melebihi batas tersebut, perintah Hapus akan ditolak dan obrolan tersebut dapat dijeda sebagai gantinya.
- Tindakan sendiri (aktif secara default): pesan yang dikirim oleh akun ini, pengeditannya, dan penekanan tombol pada keyboard balasan. Jika dinonaktifkan, pesan keluar dan pengeditan akan dilewati.
- Beralih ke sebuah folder atau seluruh akun akan meminta konfirmasi: mode-mode ini merekam
obrolan pribadi dan pesan pihak ketiga, dan hanya boleh digunakan pada akun khusus.
Konfirmasi dan setiap perubahan cakupan ditandai dengan catatan `
scope.changed`. Pada akun yang ditetapkan sebagai akun utama Anda, formulir cakupan dan fitur Investigasi menolak pemilihan folder atau seluruh akun, sama seperti saat memulai; hanya salinan satu kali tanpa perekaman yang dapat menggunakannya. - Obrolan yang ditambahkan oleh scope muncul sebagai sumber yang ditandai sebagai auto, direkam sebagai
scope.applied(saat dimulai dan setiap jam) atausource.discovered(obrolan baru saat pemantauan berlangsung). Kembali ke obrolan yang dipilih akan menjeda semua sumber yang ditambahkan secara otomatis sekaligus, tanpa membaca daftar obrolan akun tersebut lagi. Obrolan yang dikecualikan akan berhenti direkam segera setelah ruang lingkup disimpan, dan sumbernya akan dihentikan sementara meskipun Telegram tidak mengembalikan daftar obrolan. Selama proses pemantauan, menyimpan ruang lingkup akan menerapkannya kembali, bahkan jika nilainya tidak berubah.
Cakupan mode-mode ini:
- Obrolan Rahasia menggunakan integrasi Pseudo-secret yang sudah disertakan, dengan modul protokol yang diinstal melalui panel dan tombol pengaktifan per akun. Riwayat cloud dan Takeout menggunakan jalur akuisisi terpisah.
- Periode offline. Setelah dimulai ulang, TgWitness melanjutkan dari posisi pembaruan yang disimpan, meminta
pembaruan yang terlewat dari Telegram, dan memeriksa ulang obrolan. Telegram menyimpan antrian yang dibatasi, sehingga setelah
gangguan yang lama, laporan dan
verify.pymencantumkan interval yang tersisa sebagai celah (lihat cakupan). - Hanya 1,000 percakapan pertama yang ditampilkan pada awalnya (batasnya ada di bagian More tools → Parameters); percakapan yang lebih lama ditambahkan saat kembali aktif. Riwayat awal dari percakapan yang ditambahkan tidak diambil — ambil snapshot riwayat atau ekspor percakapan lengkap saat Anda membutuhkannya.
- Kondisi folder yang terus berubah (dibisukan, telah dibaca) tidak diterapkan: obrolan semacam itu tetap dipantau.
- Tombol bot inline (callback) yang ditekan di aplikasi lain tidak terlihat oleh sesi kedua
; balasan atau pengeditan bot dicatat. Tekan tombol balasan pada keyboard tiba sebagai pesan keluar
dan diberi label
button_press. - Semakin banyak obrolan berarti semakin banyak permintaan. Telegram membatasi akun yang dianggap memiliki volume yang berlebihan, yang menjadi alasan tambahan untuk menggunakan akun khusus.
Obrolan yang dipilih secara ketat#
Ketat: Hanya obrolan yang dipilih yang muncul di bawah Obrolan yang Dipilih dan secara default dalam keadaan nonaktif. Opsi ini dimaksudkan untuk izin yang hanya mencakup obrolan yang dipilih. Saat opsi ini diaktifkan:
- Pemberitahuan layanan Telegram (777000) tidak terbaca: baik saat pengamatan dimulai maupun dihentikan, maupun setiap
menit selama pengamatan berlangsung. Tidak ada catatan `
session.security_baseline` atau `account.security_event` yang ditulis. - Daftar sesi akun tidak dibaca: baik saat pemantauan dimulai maupun dihentikan (pertanyaan panel mengenai
sesi lain untuk Bukti suatu kasus dan mode perlindungan bukti juga dilewati), tidak setiap dua
menit selama pemantauan, tidak saat koneksi dibuka, dan tidak oleh pemeriksaan koneksi, di mana entri otorisasi
ditampilkan sebagai "dilewati". Status verifikasi dua langkah yang digunakan oleh pemeriksaan pengambilalihan juga tidak
dibaca. Jadi,
account.sessions,session.concurrent_at_start, dansession.takeover_risktidak ditulis, dan sesi yang diakhiri dari perangkat lain tidak dilaporkan sebagaisession_revoked_externally. - Meskipun ini adalah satu-satunya sesi pada akun tersebut (Jadikan ini sebagai satu-satunya sesi atau versi otomatisnya),
daftar sesi tetap dibaca setiap dua menit selama pemantauan dan saat koneksi terbuka, sehingga
`
session.exclusive_ended` dicatat ketika sesi lain muncul. 777000 tetap tidak terbaca selama periode tersebut, meskipun catatan `session.exclusive_from` menunjukkan bahwa pemberitahuan masuk Telegram terus tercatat. - Pemberitahuan penghapusan hanya dibandingkan dengan pemeriksaan sesi jika pemeriksaan tersebut dijalankan dalam 10 menit terakhir (selama ini merupakan sesi satu-satunya, atau setelah membuka Sesi akun ini). Jika tidak, kecuali pemeriksaan hak akses terakhir menunjukkan bahwa akun ini tidak dapat menghapus pesan tersebut (hal ini tidak pernah terjadi dalam obrolan pribadi dan grup biasa), maka akan ditampilkan: Tidak diketahui siapa yang menghapusnya: akun ini sendiri, dari sesi atau perangkat lain, juga mungkin telah menghapusnya.
- Dengan kunci sesi yang telah diimpor, tidak ada informasi dalam jurnal yang menunjukkan waktu masuk sesi ini hingga
daftar sesi dibaca (misalnya di bagian Sesi pada akun ini). Sampai saat itu, ekspor obrolan dan ekspor
akun otomatis akan menggunakan sesi reguler alih-alih Takeout, dengan alasan
session_age_unknown. - Mengaktifkan obrolan tidak akan membaca pesan-pesan sebelumnya. Tanpa pengaturan ini, setiap obrolan yang diaktifkan (di bagian Sumber, di
Obrolan, baik dengan bergabung dari panel maupun di wizard pengaturan) akan mendapatkan satu cuplikan pesan
baselinedari pesan terbarunya, hingga batas yang ditentukan di Alat Lainnya → Parameter → Cuplikan riwayat terbesar (500 secara default), saat proses pengamatan berikutnya dijalankan. Cuplikan yang tertunda dan jatuh tempo saat tombol ini aktif akan diabaikan. Obrolan yang dimasuki dari panel juga tidak akan membaca pesan terbarunya sebagai obrolan baru (jumlah Saat obrolan atau bot baru muncul, 100 secara default), dan membuka obrolan yang dipilih tanpa pesan yang tersimpan di "Obrolan" tidak akan memuat 100 pesan terakhirnya secara otomatis. Memuat riwayat dan snapshot yang Anda mulai sendiri tetap akan menampilkan riwayat. - Pengaturan konten sensitif akun tersebut tidak dibaca maupun diubah. Tanpa tombol pengalih ini, proses masuk dan setiap
koneksi baru akan mengaktifkannya jika sebelumnya dalam keadaan nonaktif, dan Telegram mengizinkan perubahan tersebut (
account.content_settings); pengaturan tersebut merupakan bagian dari akun dan berlaku di setiap aplikasi Telegram. Konten yang ditandai sebagai sensitif oleh Telegram mungkin tetap tersembunyi. - Pembaruan panggilan telepon tidak dicatat sebagai `
account.phone_call`. - Fungsi "Stopping observation" hanya menulis sidik jari kunci sesi; fungsi ini tidak membaca daftar sesi atau 777000.
Fitur ini tidak membatasi apa yang dikirimkan oleh Telegram: pembaruan dari setiap obrolan tetap masuk ke sesi ini, dan hanya
obrolan yang dipilih yang direkam. Daftar obrolan akun (hingga obrolan yang dibaca dari daftar akun) dan foldernya
tetap dibaca saat awal, dan sekali lagi saat cakupan disimpan selama pemantauan, untuk menemukan obrolan yang dipilih. Pemberitahuan
penghapusan tanpa obrolan (deletion.unscoped) tetap direkam: pemberitahuan tersebut hanya berisi ID pesan dan mungkin berasal dari
obrolan pribadi yang dipilih atau grup biasa. Pemeriksaan akun yang dibekukan (help.getAppConfig), pemeriksaan koneksi lainnya
, dan fitur yang Anda aktifkan sendiri (mengakhiri sesi lain secara otomatis, probe saksi,
obrolan pseudo-rahasia, Sesi akun ini, dan daftar perangkat yang masuk di Telegram di bawah Lebih Banyak
saksi, yang membaca daftar sesi pada setiap lewatnya penanda waktu dan yang menandai pengaturan untuk tujuan Ikuti obrolan
dan Bukti untuk kasus) tetap berfungsi.
Aktifkan fitur ini sebelum masuk; jika tidak, proses masuk itu sendiri akan memeriksa otorisasi saat ini dan mengaktifkan
konten sensitif. Setiap perubahan berupa catatan scope.changed yang telah ditandatangani, dan observation.started menyimpan nilai tersebut sebagai
scope.strict. Beralih ke folder atau ke seluruh akun akan menonaktifkan fitur ini.
Ruang lingkup dan pemilihan peristiwa#
Setiap ruang kerja memiliki sumbernya sendiri. TgWitness tidak bergabung dengan grup, menerima undangan, atau menghitung setiap anggota secara otomatis. Sumber harus sudah dapat diakses oleh akun tersebut. Saat dimulai, pengumpul memeriksa sumber yang dipilih terhadap dialog yang terlihat di akun; 1,000 dialog pertama diperiksa kecuali Alat Lainnya → Parameter → Obrolan yang dibaca dari daftar akun menyatakan sebaliknya. Sumber yang tidak ada ditandai sebagai akses belum dikonfirmasi, bukan dianggap telah menghapus Anda.
| Pengaturan | Mengumpulkan | Dampak jika dinonaktifkan |
|---|---|---|
| Pesan baru | Pesan yang dikirim secara biasa | Pengeditan atau penghapusan yang dilakukan kemudian mungkin tidak memiliki teks yang terekam sebelumnya untuk dibandingkan. |
| Pengeditan | Menyajikan versi pesan yang telah diedit | Perubahan yang terjadi di antara proses tersebut tidak direkonstruksi kemudian. |
| Penghapusan | Pemberitahuan penghapusan yang terbatas cakupannya dan pemberitahuan tingkat akun yang tidak terbatas cakupannya | Pemberitahuan penghapusan tidak ditambahkan ke jurnal. |
| Reaksi | Cuplikan reaksi yang ditampilkan | Pembaruan reaksi terpisah tidak ditambahkan. |
| Keanggotaan | Penyampaian pesan layanan keanggotaan dan pembaruan bagi peserta | Pengamatan keanggotaan tersebut tidak ditambahkan. |
Pengaturan berlaku untuk semua sumber yang dipilih di ruang kerja. Simpan formulir untuk menerapkan perubahan; perubahan dicatat dengan nilai sebelum/sesudah yang ditandatangani. Menonaktifkan suatu kategori tidak akan menghapus catatan sebelumnya. Mengaktifkannya kembali tidak akan mengisi kembali pembaruan yang terlewat.
Catatan operasional dan peristiwa layanan grup lainnya tetap terpisah dari pengaturan ini. Pesan layanan keanggotaan dapat membuat catatan pesan saat fitur keanggotaan diaktifkan, meskipun penangkapan pesan baru biasa dinonaktifkan. Objek Telegram yang ditangkap tetap mempertahankan metadata yang tertanam; pengaturan ini bukanlah aturan penyuntingan.
Penghapusan dalam obrolan pribadi dan grup biasa tiba sebagai ID pesan tanpa obrolan.
Obrolan-obrolan ini berbagi satu urutan ID pesan untuk seluruh akun, sehingga ketika pesan dengan ID tersebut
telah disimpan sebelumnya, obrolannya diketahui: penghapusan dicatat dalam obrolan tersebut dengan
chat_resolution yang menjelaskan caranya. ID yang tidak pernah disimpan tetap menjadi penghapusan tanpa lingkup dengan
obrolan yang belum terpecahkan secara eksplisit. Ini adalah pemberitahuan penghapusan Telegram, yang dipertahankan bahkan
ketika obrolannya belum dapat dikorelasikan. Skema pemberitahuan berisi ID;
jurnal menambahkan waktu penerimaan dan konteks pesan yang disimpan, termasuk
deleted_message_was_outgoing. Entri log admin yang tersedia menyediakan sumber terpisah
untuk tindakan, pelaku, dan waktu sumber.
Tindakan sendiri#
Pesan yang dikirim oleh akun yang diamati diberi label outgoing. Pengeditan pesan keluar
mencatat bahwa dalam obrolan pribadi dan grup, hanya penulisnya yang dapat mengeditnya, sedangkan
posting saluran dapat diedit oleh admin lain. Ketika sebuah pesan keluar mengulang teks tombol
dari papan ketik balasan terbaru yang disimpan dalam obrolan tersebut, pesan tersebut diberi label button_press dengan tautan ke
catatan papan ketik tersebut.
Pengecualian terhadap tindakan pengguna sendiri juga berlaku untuk pemeriksaan ulang latar belakang dan riwayat obrolan baru otomatis. Pesan keluar yang dilewati akan memajukan posisi pemeriksaan ulang sehingga tidak dapat menghalangi pesan masuk selanjutnya. Tindakan panel yang eksplisit dan cuplikan riwayat yang diminta secara manual tetap terekam.
Mode investigasi: bergabung dengan tim dan berkomunikasi dengan bot#
Alat lainnya → Sumber → Cakupan → Mode investigasi menyiapkan cakupan untuk akun khusus yang bergabung dengan obrolan tim, memulai bot, dan menulis ke dalamnya: seluruh akun, setiap jenis sumber, tindakan sendiri, serta untuk setiap obrolan atau bot yang muncul, profilnya dan 200 pesan terbaru yang terlihat. Periksa formulir dan tekan Simpan cakupan; peralihan ke seluruh akun akan meminta konfirmasi seperti biasa.
- Tombol. Tombol di bawah pesan tetap menyertai pesan tersebut dan ditampilkan di Obrolan: tautan, aplikasi web , tautan masuk, teks untuk disalin, data panggilan balik, kueri sebaris, permintaan nomor telepon atau lokasi. Tautan ditampilkan sebagai teks dan tidak pernah dibuka oleh panel. Ketika bot hanya mengubah tombol-tombol tersebut (tautan pembayaran baru), hal itu dianggap sebagai versi baru dari pesan tersebut, baik dari pembaruan langsung maupun dari pemeriksaan ulang.
-
Obrolan dan bot baru. Dalam mode folder dan akun keseluruhan, ketika obrolan atau bot baru muncul, data akan disimpan segera setelah muncul:
- profilnya sebagai catatan
source.profile: deskripsi bot dan perintah, teks "Tentang" dari pengguna, grup, atau saluran, anggota, obrolan yang tertaut, dan tautan undangan jika Telegram menyediakannya; - pesan-pesan terbarunya yang terlihat (hingga 1.000) sebagai cuplikan riwayat yang ditandai dengan
new_chat: pesan-pesan sebelumnya dari obrolan tim yang baru saja bergabung, atau apa yang dikatakan bot sebelum pengamatan memperhatikan obrolan tersebut. Pesan yang sudah disimpan secara langsung tidak diulang.
Obrolan yang baru dipilih akan menggunakan pengaturan ini saat cakupan diterapkan, termasuk obrolan yang sudah ada dalam daftar dialog akun. Pemuatan awal profil dan riwayat dilakukan secara bersamaan untuk maksimal tiga obrolan; proses untuk obrolan yang sama tetap berjalan sesuai urutan. Setiap tahap riwayat/profil menggunakan batas waktu operasi yang telah dikonfigurasi, sehingga permintaan yang terhenti akan melepaskan pekerja yang mengolahnya. Riwayat disimpan sebelum pembacaan profil opsional; kegagalan profil tidak menghalangi pencatatan riwayat tersebut. Tahap yang gagal akan dicoba ulang setelah 5 detik, dengan waktu tunggu yang berlipat ganda hingga maksimum 5 menit tanpa menggunakan pekerja selama penundaan tersebut. ID yang tertunda, batas waktu percobaan ulang, dan tahap yang telah selesai disimpan secara lokal. Restart hanya melanjutkan tahap yang belum selesai; percobaan ulang profil tidak mengulangi pembacaan riwayat yang telah selesai. Sumber yang dinonaktifkan sebelum gilirannya akan dilewati. Ikhtisar menampilkan pemuatan obrolan yang aktif, tertunda, dan sedang dicoba ulang secara terpisah dari unduhan lampiran. FloodWait menghentikan sementara pekerjaan ini dan dilanjutkan setelahnya; kegagalan dicatat dan perekaman obrolan secara langsung berlanjut. Ini mencakup masa tunggu saat menyelesaikan identitas obrolan baru: tugas profil/riwayat yang tertunda dipertahankan untuk dicoba ulang, dan masa tunggu yang lebih lama di seluruh akun tidak dipersingkat. Pekerja berbagi masa tunggu ini; konkurensi tidak melewati batas permintaan Telegram. - Profil berdasarkan permintaan. Obrolan → Profil → Simpan profil kini menyimpan profil terkini dari sumber mana pun; profil terbaru ditampilkan di atas pesan. - Cuplikan status obrolan (pratinjau). Status di luar aliran pesan berubah tanpa pesan: melepas penandaan setiap pesan tidak meninggalkan jejak di tingkat pesan, seorang administrator kehilangan haknya, hadiah disembunyikan, dikonversi, ditingkatkan, atau dikembalikan. Selama pemantauan, setiap sumber yang diaktifkan dibaca secara berkala dan disimpan sebagai
chat.state: judul, nama pengguna, deskripsi, jumlah anggota dan administrator, obrolan yang ditautkan, mode lambat, ID pesan yang disematkan (hingga 100), administrator beserta hak akses dan gelarnya, serta hadiah yang ditampilkan di saluran dan profil pengguna (hingga 100). Setiap catatan mencantumkan perbedaan dari snapshot sebelumnya: bidang yang berubah beserta kondisi sebelum dan sesudahnya, pesan yang disematkan yang ditambahkan atau dihapus, serta administrator dan hadiah yang ditambahkan, diubah, atau tidak lagi terdaftar. - Bagian yang ditolak oleh Telegram (misalnya daftar administrator saluran untuk seorang anggota yang bukan administrator) disebutkan dalamerrors; nilai sebelumnya tetap disimpan dan tercantum dalamcarried_forward, tidak pernah dilaporkan sebagai dihapus. - Catatan yang perubahannya hanya berupa jumlah, serta pemeriksaan yang tidak menemukan perubahan, merujuk pada keadaan lengkap terakhir denganstate_seqdan kumulatifstate_overrides. Status lengkap ditulis setidaknya setiap tujuh hari dan setiap kali ada perubahan selain jumlah. -parts_completemenandai daftar yang dibatasi. Penambahan memerlukan daftar sebelumnya yang lengkap, penghapusan memerlukan daftar saat ini yang lengkap, dan nilai kosong yang eksplisit menandai pembersihan catatan. - Alat Lainnya → Parameter → Status Obrolan mengatur interval (12 jam secara default, 0 menonaktifkan snapshot), jeda antar sumber, bagian mana yang dibaca, dan apakah pemeriksaan yang tidak menemukan perubahan dicatat.FLOOD_WAITdanFLOOD_PREMIUM_WAITmenghentikan sisa permintaan snapshot, mempertahankan batas waktu akun yang lebih lama, dan membiarkan obrolan yang terputus memenuhi syarat untuk dicoba lagi setelah masa tunggu tersebut. - Tidak terlihat. Tombol inline (callback) yang ditekan di aplikasi Telegram lain, popup atau tautan yang digunakan bot sebagai respons atas penekanan tersebut, serta tautan undangan yang digunakan di aplikasi lain tidak sampai ke TgWitness. Apa yang dikirim atau diedit oleh bot setelahnya akan dicatat. - profilnya sebagai catatan
Tindakan dari panel#
Obrolan kini mencakup klien mini yang menggunakan akun Telegram dari ruang kerja yang dipilih:
- Tulis pesan teks biasa atau pilih "Balas" di bawah pesan yang telah disimpan. Pesan keluar yang dikirimkan akan terekam meskipun cakupan pengaturan tidak mencakup pembaruan pesan keluar.
- Tekan tombol "Press" di bawah tombol callback atau teks yang sedang aktif. Server akan mengambil pesan tersebut kembali dan menolak tindakan tersebut jika teks yang dimasukkan berbeda dari versi yang tersimpan. Tanda terima callback mempertahankan teks popup Telegram, bendera peringatan, dan URL; jawabannya juga ditampilkan di bawah percakapan. URL tetap berupa teks yang dapat dipilih dan tidak dibuka secara otomatis.
- Tekan + → Buka tautan Telegram, masukkan
@username, tautan publikhttps://t.me/name,https://t.me/+invite/joinchat/invite, atau tautan bot dengan?start=parameter, lalu tekan Simpan pratinjau. Tautan asli dan pratinjau Telegram akan ditandatangani sebelum bergabung. Bergabung / buka dan amati, kemudian bergabung dengan grup/saluran atau membuka pengguna/bot, tambahkan obrolan sebagai sumber yang diaktifkan, dan kirimkan/startke bot, termasuk parameter awalnya. Permintaan bergabung yang menunggu persetujuan administrator dicatat sebagai tertunda, bukan sebagai keanggotaan.
Aktifkan Mulai pengamatan untuk merekam balasan yang masuk secara langsung. Tindakan panel berfungsi saat pengamatan dijeda; panel kemudian menyimpan respons langsungnya, dan pengamatan langsung merekam sisa percakapan. Sumber yang baru ditambahkan menggunakan profil/riwayat yang telah dikonfigurasi saat pengamatan sedang berjalan. Saat sumber dijeda, aktifkan sumber tersebut di Alat Lainnya → Sumber sebelum mengirim atau menekan tombolnya.
interaction.preview, interaction.requested, dan interaction.result adalah peristiwa jurnal bertanda tangan biasa
yang disertakan dalam ekspor bukti. Permintaan mengidentifikasi akun, pesan/tombol
atau catatan pratinjau, serta apakah pengamatan sedang berjalan. Tanda terima membedakan antara keberhasilan,
penolakan, persetujuan tertunda, dan hasil yang tidak diketahui. Permintaan yang terputus mungkin telah sampai
ke Telegram: periksa obrolan sebelum memulai tindakan baru. Menggunakan kembali ID permintaan akan mengambil
tanda terima yang tersimpan tanpa mengulangi tindakan, termasuk setelah restart. Panel mempertahankan
ID tersebut setelah respons ambigu untuk tindakan yang sama selama sesi halaman saat ini.
Panel juga mempertahankan ID tersebut ketika penyegaran tampilan gagal setelah tindakan berhasil: tanda terima
tetap terlihat, dan mengklik lagi akan mengambilnya kembali. RPC callback dan join memiliki satu upaya
aplikasi; pembacaan yang dapat dicoba ulang mempertahankan kebijakan percobaan ulang yang telah dikonfigurasi. Beralih obrolan secara langsung
akan menghapus draf dan target balasan serta menonaktifkan pengiriman hingga percakapan baru dimuat.
Mini-klien ini menangani teks dan tombol callback. Tombol aplikasi mini menampilkan opsi Buka aplikasi mini, yang menjalankan aplikasi tersebut di browser terisolasi (Aplikasi mini). Permintaan login, nomor telepon, dan lokasi, pembayaran, kueri inline, serta lampiran tetap memerlukan klien Telegram; metadata tombol yang telah disimpan tetap terlihat. Kontrol baru ini menggunakan teks dalam bahasa Inggris.
Tingkat verifikasi ulang#
Pemeriksaan ulang meminta Telegram kembali untuk pesan yang terlewat, suntingan, dan pesan yang tidak lagi dikembalikan.
Sumber yang ditandai dengan bintang adalah sumber prioritas, diperiksa ulang setiap 15 menit secara default;
semua sumber lainnya setiap 6 jam. Obrolan yang dipilih dimulai sebagai sumber prioritas, sedangkan obrolan yang ditambahkan melalui
folder atau seluruh akun sebagai sumber biasa. Paling banyak 30 sumber diperiksa ulang per putaran dan
sisanya menunggu hingga menit berikutnya; setelah koneksi terhubung kembali, sumber prioritas diproses terlebih dahulu. Kedua
interval tersebut diatur di bawah More tools → Sources → Recording → Recheck (0 menonaktifkan tingkatan) dan
dicatat sebagai recheck.changed.
Pesan yang terlewat diambil mulai dari titik di mana proses sebelumnya berhenti, dengan batas maksimal yang ditentukan di
More tools → Parameters → Missed messages recovered per chat and pass (secara default 1,000). Setelah jeda yang lama,
proses pemeriksaan ulang akan mengisi seluruh celah tersebut, bahkan jika pesan langsung yang lebih baru daripada celah tersebut telah disimpan
terlebih dahulu. Obrolan yang masih dalam proses mengejar ketinggalan akan diperiksa ulang pada menit berikutnya alih-alih
menunggu interval tier-nya; recheck.completed menampilkan continues_after hingga proses selesai.
Perbandingan mencakup teks pesan, entitas, papan ketik (termasuk penghapusan), serta konten/identitas lampiran. Mengubah hash akses berkas atau referensi berkas saja tidak dianggap sebagai pengeditan, begitu pula hal-hal yang diisi secara otomatis oleh Telegram: pemuatan pratinjau tautan, tampilan cerita, media berbayar yang dibuka oleh akun ini, serta tanda terima faktur. Setiap versi yang disimpan di Obrolan tertaut ke catatan jurnal lengkapnya, termasuk metadata media.
Riwayat pesan dan atribusi#
Misalkan pengumpul mengamati “Pertemuan pukul 10:00,” kemudian melihat “Pertemuan pukul 11:00,” dan kemudian menerima pemberitahuan penghapusan. Alat ini menambahkan tiga catatan terpisah. Teks asli tetap ada, suntingan menjadi versi terpisah, dan pemberitahuan tersebut mencatat bahwa telah terdeteksi adanya penghapusan.
Jika pengumpulan dimulai setelah versi pertama menghilang, teks tersebut tidak tersedia. Jika terjadi beberapa pengeditan saat proses dalam keadaan offline, hanya versi yang diamati setelahnya yang dapat disimpan. Pemberitahuan penghapusan tidak dapat memulihkan konten yang tidak pernah terekam.
Catatan tersebut menggabungkan beberapa sumber:
| Sumber | Informasi yang dipertahankan |
|---|---|
| Pesan langsung atau pembaruan suntingan | ID pesan, metadata pengirim, versi yang direkam, waktu penerimaan, serta tanggal pesan/pengeditan Telegram yang disediakan. |
| Pemberitahuan penghapusan secara langsung | ID pesan yang dilaporkan, waktu penerimaan, notifikasi mentah, dan tautan ke konten yang telah disimpan sebelumnya. |
| Log admin yang tersedia | Tindakan, pelaku, tanggal sumber, dan isi pesan yang disediakan, dibaca oleh akun dengan hak akses yang diperlukan. |
| Interaksi panel | Tindakan yang diminta dan hasilnya yang tercatat di bawah akun yang dipilih. |
| Periksa ulang | Respons Telegram saat ini dibandingkan dengan pesan yang disimpan sebelumnya. |
observed_at adalah waktu ketika catatan tersebut ditulis pada jam kolektor dan
bertambah seiring dengan seq. Catatan yang ditulis saat menangani pembaruan langsung juga menyertakan
received_at, yaitu waktu ketika pembaruan tersebut sampai di pengumpul, dan
processing_delay_ms, waktu dari penerimaan hingga penulisan; pembaruan yang ditahan saat
pengamatan dimulai diproses sesuai urutan kedatangan sebelum yang lebih baru. source_at
menyimpan tanggal sumber jika peristiwa tersebut menyertakannya. Pengamatan offset jam telegram,
catatan diskontinuitas jam, dan pemeriksaan waktu eksternal menyediakan
konteks waktu yang terkait. Bidang-bidang dalam pemberitahuan pesan biasa mendeskripsikan
pemberitahuan tersebut; catatan log admin dan interaksi menyimpan atribusi masing-masing.
Cuplikan riwayat#
Snapshot meminta pesan-pesan terbaru yang terlihat dari sumber yang diaktifkan, hingga
500 pesan per permintaan. Hasilnya diberi label sebagai pengamatan riwayat. Snapshot manual
dijalankan bersamaan dengan pengamatan. Pengamatan yang berulang
disimpan sebagai catatan terpisah. Mengaktifkan suatu sumber juga akan mengambil satu snapshot baseline-nya, kecuali
opsi obrolan terpilih secara ketat diaktifkan.
Pembuatan snapshot akan dihentikan jika sumber dinonaktifkan selama proses pembacaan. Balasan harus berasal dari obrolan yang diminta dan berisi ID pesan positif yang secara ketat menurun di bawah batas yang diminta. Balasan yang tidak valid akan menghentikan proses pembuatan snapshot sebelum pesan tersebut disimpan; pesan yang telah disimpan tetap berada di jurnal yang ditandatangani bersama dengan catatan penghentian tersebut.
Cuplikan mengikuti kebijakan lampiran tetapi tetap terpisah dari peralihan peristiwa langsung. Cuplikan tersebut tidak merekonstruksi pesan yang dihapus atau versi perantara yang terlewat. Anda dapat meminta cuplikan saat proses dijeda; lampiran apa pun yang masuk ke antrian akan menunggu hingga pengamatan dimulai dan proses pengunduhan berjalan.
Proses Riwayat adalah tugas eksklusif tersendiri: membaca sumber terpilih dan mengunduh antrean lampirannya secara berurutan tanpa memulai pemantauan. Jeda membebaskan akun; melanjutkan meneruskan proses yang disimpan. Untuk filter tanggal, bahasa, dan balasan pada beberapa akun menganggur, lihat Ekspor percakapan terdistribusi.
Penanganan lampiran#
Pengunduhan lampiran diaktifkan secara default dan akan dihentikan sementara jika ruang disk kosong kurang dari 1 GiB. Pengumpul melakukan pengamatan pesan dan tugas pengunduhan secara bersamaan. Tugas tersebut mempertahankan deskriptor media asli dan kebijakan ukuran, sehingga lampiran yang diedit kemudian tidak akan diganti tanpa pemberitahuan.
Proses unduhan dijalankan setelah penangkapan pesan. Unduhan yang selesai akan membuat catatan media.saved
beserta SHA-256
dan jumlah byte-nya. Proses yang dilewati, gagal, dicoba ulang, dan terputus
memiliki hasil yang terpisah; sebuah berkas dianggap tersimpan jika catatan media.saved
-nya ada.
Berkas yang telah selesai juga harus sesuai dengan jumlah byte dalam deskriptor lampiran asli yang diamati.
Respons yang pendek atau lebih panjang dari yang diharapkan tidak dicatat sebagai media yang tersimpan.
File dan entri foldernya disimpan ke disk sebelum `media.saved` ditulis. Ketika proses pengumpul
sebelumnya berakhir tanpa penghentian yang teratur, proses berikutnya akan membaca setiap file yang tercatat sebagai tersimpan selama proses tersebut. File
yang hilang atau byte-nya berbeda dari SHA-256 yang tercatat akan diberi catatan `media.missing_after_restart`,
pengunduhannya dimasukkan ke antrian lagi, dan byte yang berbeda dipindahkan ke folder `media-damaged/`. File yang dipindahkan ke penyimpanan di luar lokasi
tidak dibaca.
Dalam satu ruang kerja, pekerjaan yang mengantri secara bersamaan untuk representasi lampiran yang sama menunggu proses transfer yang sedang berlangsung, lalu memeriksa kembali byte yang telah disimpan sebelum digunakan kembali. Setiap pekerjaan menyimpan hasil bertanda (signed) miliknya sendiri serta referensi ke catatan file yang disimpan sebelumnya. Membatalkan pekerjaan yang sedang menunggu tidak akan membatalkan proses transfer yang sedang berlangsung; jika transfer tersebut gagal atau dibatalkan, pekerjaan berikutnya dapat mencoba lagi. Lampiran yang berbeda dapat diunduh secara bersamaan.
Pekerjaan dengan akun, representasi, ukuran yang diharapkan, dan tindakan penangkapan yang sama akan tetap terdapat dalam antrian selama satu pekerjaan yang cocok sedang berjalan. Pekerjaan-pekerjaan tersebut tidak menempati slot unduhan, sehingga file lain dapat dimulai meskipun antrian diawali dengan banyak salinan dari satu file yang lambat. Penyelesaian suatu upaya akan mengaktifkan kembali antrian. Jalur prioritas, penundaan percobaan ulang yang disimpan, dan riwayat kepemilikan tetap berlaku; setiap pengamatan akan mendapatkan hasilnya masing-masing.
Ekspor obrolan juga menerapkan transfer aktif untuk representasi berkas yang berulang di dalam direktori ekspor yang sama. Setiap pesan mempertahankan referensi lampirannya, dan penggunaan ulang memerlukan pemeriksaan ukuran dan SHA-256 yang baru. Berkas-berkas yang berbeda dapat diperiksa secara paralel tanpa mengunci transfer bersama. Jalur unduhan dan penyalinan sementara bersifat unik untuk setiap operasi; pembatalan akan menunggu hingga semua pembaca berkas lokal yang aktif selesai sebelum melakukan pembersihan. Indeks berkas ekspor hanya menserialisasikan akses metadata, bukan proses hashing berkas atau unduhan.
Pembacaan hash server untuk lampiran yang berbeda juga berjalan secara bersamaan, berbagi tiga slot permintaan file klien dengan pengunduhan byte. Pembacaan berulang terhadap representasi yang sama hanya memanfaatkan kembali hasil cache yang sudah lengkap. Pembacaan file tidak membebani antrian permintaan biasa; batas waktu FloodWait yang tersimpan diperiksa kembali saat sebuah permintaan mendapatkan slot.
Batas disetel per jenis: foto, video, GIF dan animasi, pesan video bulat,
pesan suara, musik dan audio, stiker, serta file. Setiap jenis dapat dinonaktifkan dan memiliki
batas ukuran tersendiri mulai dari 1 hingga 2.000 MiB; ruang kerja baru dimulai dengan 20 MiB untuk foto,
100 MiB untuk video, 50 MiB untuk file, audio, dan video bulat, 20 MiB untuk pesan suara dan GIF, serta
5 MiB untuk stiker. Ruang kerja baru menonaktifkan GIF dan stiker hingga diaktifkan. Ruang kerja
dengan kebijakan yang disimpan sebelum batasan per jenis akan mengaktifkan semua jenis dan mempertahankan
batasan tunggal untuk setiap jenis. Ukuran file maksimum menentukan semua jenis sekaligus. Jenis yang dinonaktifkan menghasilkan
catatan media.skipped; file dengan ukuran tidak diketahui atau berukuran melebihi batas tidak akan diunduh. File besar mendapatkan
waktu unduh tambahan berdasarkan ukurannya dan kecepatan dasar 256 KiB/s. Tugas tetap ada
setelah restart, tetapi referensi yang kedaluwarsa, akses yang hilang, atau file yang dihapus tetap dapat menghalangi pemulihan.
Pekerjaan yang sedang menunggu mempertahankan batas yang tersimpan bersamanya, sehingga peningkatan batas hanya berlaku untuk file baru.
Menonaktifkan suatu jenis atau menurunkan batasnya juga akan melewatkan file-file yang sedang menunggu yang dikecualikan, masing-masing dengan
catatan media.skipped; menonaktifkan unduhan akan menjeda antrian hingga diaktifkan kembali.
Jeda, kunci, putuskan sambungan, dan mulai ulang#
| Tindakan atau kondisi | Efek |
|---|---|
| Beralih ke ruang kerja | Mengubah tampilan panel; pengumpul lainnya tetap mempertahankan statusnya. |
| Kunci panel atau tutup tab | Membiarkan server dan pemantauan tetap berjalan. |
| Jeda pengamatan | Menghentikan pengumpul tersebut dan mempertahankan pekerjaan lampiran yang sedang dalam antrian. |
| Nonaktifkan sumber | Menghentikan penangkapan berkala di masa mendatang; tugas media yang sedang dalam antrian akan ditunda selama fitur ini dinonaktifkan. |
| Hapus sumber | Mencatatnya sebagai sumber dan menghapus profil penggunanya; catatan yang sudah disimpan tetap berada di jurnal yang hanya dapat ditambahkan. Lampiran yang masih menunggu dicatat sebagai gagal (source_removed). Dalam mode folder dan akun keseluruhan, hal ini juga dikecualikan. |
| Ubah rute koneksi | Membutuhkan jeda, menutup klien lama, dan membatalkan proses login yang belum selesai. |
| Hentikan proses Python | Menghentikan semua ruang kerja; tidak ada pengamatan yang dilakukan saat alat ini dalam keadaan offline. |
| Mulai ulang setelah pengamatan aktif | Upaya untuk melanjutkan cakupan yang disimpan menggunakan sesi yang disimpan. Penundaan manual akan menghapus niat tersebut. |
Pengumpul mencatat pemutusan koneksi yang terdeteksi, upaya ulang, kesalahan, mulai/berhenti, dan detak jantung. Gangguan singkat dapat terlewatkan oleh pemeriksaan konektivitas berkala. Setelah dimulai ulang, pembaruan yang terlewat diminta dari posisi pembaruan yang disimpan dan obrolan yang diamati diperiksa ulang secara berkala; lihat format bukti. Sebuah snapshot menambahkan keadaan saat ini sebagai konteks, dan selisih waktu tetap tercatat.
Isolasi dan verifikasi akun#
Setiap ruang kerja memiliki jurnal, otorisasi, kunci penandatanganan, kebijakan, dan antrian tersendiri. Hanya klien yang aktif yang dapat menyumbangkan pengamatan secara langsung. Klien yang ditolak, dalam antrian, digantikan, dan sedang melakukan uji koneksi tidak dapat menulis pembaruan langsung ke dalam jurnalnya. Akun yang berbeda dapat mengamati grup yang sama, tetapi jurnal masing-masing tetap terpisah.
Setiap peristiwa mencakup hash sebelumnya dan tanda tangan Ed25519. Ekspor mencakup seluruh jurnal ruang kerja melalui nomor urut tetap. Filter panel tidak menyaring ekspor; pengumpulan data mungkin berlanjut melampaui batasnya saat ekspor sedang disiapkan.
Jurnal verifikasi memeriksa rantai peristiwa dan tanda tangan melalui batas yang ditampilkan. Hasilnya akan dihapus saat ruang kerja berubah, dan panel akan mengidentifikasi catatan baru yang ditambahkan setelah pemeriksaan. Ekspor ZIP juga memverifikasi media yang dikumpulkan.
Pertahankan sidik jari dan titik pemeriksaan secara terpisah. Lihat ruang lingkup verifikasi untuk pemeriksaan akuisisi di setiap mode, dan operasi harian untuk pengumpulan rutin.