TgWitness / Dokumentasi

Apa yang telah diuji →

Referensi / Pengaturan

Telegram · Format akun dan sesi

Masuk menggunakan nomor telepon, kode QR, atau kunci otentikasi, impor sesi Telethon, Pyrogram, atau Telegram Desktop, dan kelola beberapa akun.

TgWitness / Dokumentasi · Memulai

Memulai

TgWitness masuk sebagai akun pengguna Telegram (bukan bot) melalui MTProto, menggunakan Telethon. Setiap akun berada di ruang kerja tersendiri (disebut workspace dalam API dan alat baris perintah) dengan sesi, sumber, jurnal, dan kunci penandatanganan tersendiri.

Berkas sesi, string sesi, dan Kunci Otentikasi merupakan otorisasi akun: siapa pun yang memilikinya dapat bertindak sebagai akun tersebut. Ketiganya tidak berisi riwayat pesan.

[!PERINGATAN] Gunakan akun khusus. Telegram membatasi dan dapat memblokir akun secara permanen karena volume permintaan yang dianggap berlebihan, terlepas dari klien atau tujuannya, dan hanya mendokumentasikan batasan-batasan tersebut sebagian saja. Hubungkan akun yang disiapkan untuk pengamatan, bukan akun pribadi atau akun berharga lainnya, dan buat ID API / hash API pada akun khusus tersebut.

Sekilas#

Apa yang Anda miliki Tab di Tambahkan akun Anda juga akan memerlukan
Nomor telepon dan akses ke kode login-nya Telepon Kata sandi 2FA jika diaktifkan
Telegram terbuka di perangkat lain Kode QR Kata sandi 2FA jika diaktifkan
Berkas .session (Telethon atau Pyrogram) Berkas Berkas JSON pelengkap opsional untuk pengaturan aplikasi
.session + .json dengan nama yang sama Berkas (pilih keduanya) Biasanya tidak ada yang lain
Folder tdata di Telegram Desktop Berkas (dalam format ZIP) Kode sandi lokal Desktop, jika ada yang ditetapkan
Sebuah Telethon StringSession (teks, .txt, .tgwitness-session) Berkas Tidak diperlukan pasangan API terpisah
Kunci otentikasi dan DC dalam satu baris, <512 hex>:<1–5> Berkas (tempelan atau berkas teks) Tidak diperlukan pasangan API terpisah
.json dengan sesi atau Kunci Otentikasi Berkas Tidak diperlukan pasangan API terpisah
Kunci Otentikasi (512 karakter heksadesimal) dan nomor DC-nya Kunci otentikasi ID Pengguna (opsional)

TgWitness mengenali berkas berdasarkan isinya, bukan namanya. Mengganti nama berkas tidak akan mengubah isinya.

Sebelum memulai: ID API dan hash API#

Anda dapat masuk tanpa perlu membuat aplikasi API Telegram. Jika tidak ada pasangan yang dimasukkan, diimpor, atau sudah disimpan di ruang kerja, TgWitness akan memilih pasangan dari kumpulan bawaan yang berisi 50 pasangan API publik (tgwitness/api_pool.py), dengan memprioritaskan Telegram Desktop untuk proses masuk baru dan menggunakan pasangan yang sudah disimpan terlebih dahulu; kandidat lainnya diacak. Jika Telegram menolak sebuah pasangan (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), pasangan berikutnya akan dicoba, hingga delapan kali per proses masuk; pasangan yang ditolak dilewati hingga aplikasi dimulai ulang. Pasangan yang digunakan untuk masuk akan disimpan bersama akun tersebut dan digunakan kembali untuk akun tersebut.

Pasangan bawaan bersifat publik: pasangan tersebut dipublikasikan dalam kode sumber terbuka klien dan pustaka Telegram. ID API dan hash API mengidentifikasi aplikasi tersebut kepada Telegram dan tidak memberikan akses apa pun ke data akun. Proses masuk menggunakan otorisasi akun itu sendiri: kode login dan kata sandi 2FA, atau sesi yang telah diotorisasi oleh akun tersebut. Setiap observation.started catatan mencantumkan pasangan yang digunakan, sehingga pasangan bawaan didokumentasikan untuk pengadilan dengan cara yang sama seperti milik Anda sendiri. Anda dapat memasukkan pasangan Anda sendiri dari my.telegram.org sebagai gantinya. Berdasarkan pengalaman proyek ini, pasangan pribadi yang baru akan membuat sebagian besar akun terlogout, jadi gunakanlah hanya jika suatu kasus memerlukan aplikasi Anda sendiri: buatlah dengan akun khusus dan masukkan sebelum pengumpulan dimulai (langkah-langkah di bawah ini).

Bidang koneksi yang hilang menggunakan pasangan perangkat/OS yang deterministik dari katalog opentele2 2.0.0 yang disertakan : Desktop 2040, Android 6, Android X 21724, iOS 10840, macOS 2834, dan Web 2496. ID build sumber Android 4 juga menggunakan katalog Android, sebagaimana diidentifikasi dalam BuildVars Telegram Android . Web secara default menggunakan A; sufiks versi aplikasi yang diimpor K atau paket bahasa macos memilih K, dan versi 0.7.0 memilih Webogram. ID aplikasi yang tidak dikenal mempertahankan pengaturan default host Telethon. Bidang yang diimpor selalu diutamakan, termasuk versi aplikasi yang lebih lama dan paket bahasa yang kosong. Katalog tidak pernah mengubah ID/hash API. Cuplikan versinya ditinjau secara eksplisit, bukan diambil saat login. Profil yang disimpan tetap stabil setelah pembaruan.

account.getAuthorizations melaporkan metadata otorisasi Telegram yang tersimpan; ini bukanlah duplikat dari setiap initConnection baru. Bandingkan dengan profil yang sebenarnya dikirim. Menghubungkan otorisasi yang sudah ada tidak memvalidasi hash API yang menyertainya: initConnection mengirimkan ID API, sedangkan hash digunakan oleh permintaan login.

Setelah otorisasi ponsel baru atau QR, TgWitness meminta konfigurasi, DC terdekat, status online, bahasa (jika paket bahasa tidak kosong), pembaruan aplikasi, dan pembaruan syarat layanan, dengan jeda 0.3–1.5 detik antar permintaan. Pembaruan status secara singkat menandai akun sebagai online. Urutan ini dijalankan sekali setelah login selesai, bukan saat impor, koneksi ulang, atau restart. Otorisasi disimpan terlebih dahulu; permintaan yang gagal menghentikan urutan tanpa mencoba ulang atau membatalkan login. Hasilnya dicatat sebagai account.initialized, dengan nama kesalahan alih-alih isi respons. Kebijakan Telegram sendiri yang menentukan batasan akun.

Untuk tdesktop , jika tz_offset tidak ada, maka digunakan offset UTC lokal server, dibulatkan ke 900 detik menggunakan algoritma opentele2 (MIT; lisensi di tgwitness/client_profiles.LICENSE ). Nilai ini diperbarui pada setiap koneksi sehingga perubahan waktu musim panas tercermin. tz_offset yang diimpor memiliki prioritas di setiap platform dan dipertahankan persis seperti aslinya, termasuk nilai nol. Entri initConnection.params lainnya tetap dipertahankan. Formulir masuk HTTP menerima zona waktu numerik yang dikembalikan oleh impor berkas; nilai boolean, pecahan, dan offset di luar rentang yang didukung akan ditolak.

Rute langsung, SOCKS5, dan HTTP CONNECT menggunakan ConnectionTcpObfuscated (MTProto yang disingkat dan dikaburkan) dari Telethon. HTTPS CONNECT mempertahankan TLS ke proxy dan menggunakan transportasi yang disamarkan yang sama di dalam terowongan. MTProxy mempertahankan transportasi perantara acak dan penanganan rahasia yang diwajibkan. Pergantian rute menerapkan pilihan yang sama. Pengaburan mengubah pembingkaian paket; hal ini tidak menyembunyikan akun atau metadata kliennya dari Telegram atau menyiratkan kekebalan terhadap pembatasan.

Setelah menghubungkan klien yang terotorisasi, TgWitness memeriksa konfigurasi, DC terdekat, otorisasi saat ini, baseline lapisan yang telah ditinjau, bahasa, pembaruan aplikasi, dan pembaruan syarat dan ketentuan layanan. Diagnostik ini dijalankan sekali per instance klien, sebelum pengumpulan data, dan ditampilkan di bawah detail koneksi beserta waktunya. account.connection_checked mencatat hasilnya tanpa hash sesi, alamat IP, token, atau hash API. Mereka tidak pernah menyetujui syarat dan ketentuan atau menginstal pembaruan. Kegagalan permintaan atau FloodWait menghentikan permintaan berikutnya; hasil yang hilang tetap tidak diketahui. Pemeriksaan lokal tetap dapat melaporkan hasilnya sementara pemeriksaan jaringan dilewati. Dengan opsi obrolan terpilih yang ketat diaktifkan, otorisasi saat ini tidak diminta dan pemeriksaan tersebut ditampilkan sebagai dilewati.

Setelah masuk dan pada setiap koneksi baru, TgWitness membaca pengaturan konten sensitif akun tersebut. Jika pengaturan tersebut dalam keadaan nonaktif dan Telegram mengizinkan perubahan, TgWitness akan mengaktifkannya agar konten yang ditandai Telegram sebagai sensitif (18+) tersimpan, serta mencatat nilai ` account.content_settings`. Pengaturan ini milik akun dan berlaku di setiap aplikasi Telegram. Fitur "Obrolan Terpilih" tidak memengaruhi pengaturan ini; aktifkan fitur tersebut sebelum masuk.

Permintaan yang dilakukan secara bersamaan untuk memulihkan koneksi satu ruang kerja akan berbagi klien yang sama dan menunggu hingga proses penyiapan koneksinya selesai. Upaya yang gagal atau dibatalkan akan membebaskan permintaan berikutnya untuk mencoba kembali. Jika kredensial yang tersimpan, klien, atau status otorisasi berubah selama proses penyiapan, upaya yang lebih lama akan dihentikan alih-alih melaporkan bahwa koneksi sudah siap.

Diagnostik FloodWait menyimpan metode TL yang gagal, pembungkus Takeout/range apa pun, penundaan yang diminta server, dan batas waktu efektif di telegram.backoff. Rincian koneksi menampilkan metode dan batas waktu saat permintaan ditangguhkan. Diagnostik ini mencakup penghitung panggilan klien per metode sejak klien tersebut dibuat; penghitung ini menghitung resolusi peer bersarang secara terpisah, tetapi tidak menghitung paket atau upaya percobaan ulang internal Telethon. Penghitung saat ini juga tersedia sebagai collector.rpc_activity di API status. Tidak ada argumen permintaan, nama pengguna, hash akses, atau teks pengecualian yang disertakan. Diagnostik terakhir dan batas waktu penuh tetap ada setelah restart. Penundaan sebelumnya tanpa catatan metode tidak dapat diatribusikan secara retrospektif. Lihat batas ekspor untuk tinjauan sumber dan perbedaan antara penemuan dan perolehan riwayat.

official_app=True atau False adalah bendera otorisasi saat ini dari Telegram. Tidak ada satu pun nilai tersebut yang menentukan apakah akun tersebut dibatasi, tepercaya, atau sedang dalam pengamatan. Snapshot mode bukti account.devices yang ada tetap mencatat riwayat semua perangkat yang masuk; diagnostik koneksi hanya menyimpan deskripsi perangkat saat ini.

Sebelum koneksi, pemeriksaan penasihat membandingkan platform API, paket bahasa, format perangkat/OS dan versi aplikasi, pengaturan wilayah sistem seluler, serta lapisan skema aktual Telethon dengan dasar katalog yang telah ditinjau. Peringatan muncul di log server dan metadata status akun; peringatan tersebut tidak pernah menggantikan nilai yang diimpor atau mengubah lapisan skema. Lapisan yang berbeda merupakan sinyal untuk meninjau kompatibilitas; status koneksi akun itu sendiri menunjukkan apakah koneksi berfungsi. Telegram menentukan batasan di sisi mereka, terlepas dari profil klien mana yang digunakan. Status akun yang terputus menggunakan profil yang tersimpan alih-alih membuat deskripsi perangkat baru.

Untuk menggunakan aplikasi Anda sendiri sebagai gantinya:

  1. Buka my.telegram.org dan masuk menggunakan nomor telepon apa pun yang Anda miliki. Kode verifikasi akan dikirimkan melalui aplikasi Telegram, bukan melalui SMS.
  2. Pilih alat pengembangan API.
  3. Buat aplikasi: judul dan nama pendek apa saja (5–32 huruf), platform Desktop. URL dan deskripsi dapat dikosongkan.
  4. Salin App api_id (sebuah angka) dan App api_hash (32 karakter heksadesimal).

Di panel, buka bagian API ID + Hash di bawah formulir masuk. Anda dapat menempelkan satu pasangan api_id:api_hash ke kolom API ID, dan kedua kolom tersebut akan terisi otomatis. Satu pasangan dapat digunakan untuk semua akun Anda. Setelah login berhasil, data tersebut disimpan dalam bentuk terenkripsi, hanya di ruang kerja tersebut, dan tidak pernah dikirim kembali ke browser.

Terdapat tiga jenis kredensial yang terlibat:

Rahasia Buka Lokasi
Token panel Panel web TgWitness panel-token.txt di direktori data, atau TGWITNESS_TOKEN
ID API + hash Tidak ada yang berdiri sendiri; mengidentifikasi aplikasi tersebut Pasangan bawaan, pengaturan yang diimpor, atau aplikasi Anda sendiri di my.telegram.org
Otorisasi akun Akun Telegram Dibuat melalui login via telepon/QR atau dimasukkan sebagai sesi

Jika Telegram harus diakses melalui proxy, atur terlebih dahulu di menu Lainnya → Akun → Pengaturan → Pengaturan koneksi → Ubah rute koneksi.

Nomor telepon#

  1. Buka Alat Lainnya → Akun, tab Telepon, lalu masukkan nomor dalam format internasional, misalnya +44 7700 900123. Spasi dan tanda hubung akan dihapus secara otomatis.
  2. Tekan Lanjutkan. Kolom API ID + Hash dapat dibiarkan kosong.
  3. Masukkan kode yang dikirimkan Telegram, biasanya ke aplikasi Telegram; Telegram yang menentukan apakah akan mengirim SMS.
  4. Jika akun tersebut memiliki verifikasi dua langkah, masukkan kata sandi tersebut. Ini bukanlah token panel maupun kode sandi perangkat.
  5. Periksa ID akun yang ditampilkan setelah masuk, lalu pilih sumber.

Kode login dan kata sandi 2FA tidak pernah disimpan ke disk.

Kode QR#

Gunakan ini jika akun sudah masuk (login) di ponsel atau komputer lain.

  1. Tab Kode QR → Tampilkan kode QR. Kolom API ID + Hash dapat dibiarkan kosong.
  2. Pada perangkat yang sudah masuk: Pengaturan → Perangkat → Hubungkan Perangkat Desktop, pindai kode dan konfirmasi.
  3. Masukkan kata sandi 2FA di TgWitness jika Telegram memintanya.

Gambar QR dihasilkan secara lokal. Kode memiliki masa berlaku; tekan "Buat kode QR lain" untuk mencoba lagi. Mengunci panel, berpindah ruang kerja, atau memulai sesi login baru akan membatalkan kode yang sedang diproses.

Kunci Otentikasi + ID DC#

Kunci Otorisasi (Auth Key) adalah otorisasi mentah berukuran 256 byte yang mendasari setiap sesi Telegram, ditulis dalam bentuk 512 karakter heksadesimal, bersama dengan nomor pusat data DC 1–5.

  1. Tab Kunci Otentikasi. Tempelkan kunci secara lengkap; kunci yang dipersingkat yang mengandung … tidak akan berfungsi.
  2. Pilih DC ID yang disertakan bersama kunci tersebut.
  3. Masukkan ID Pengguna (opsional). TgWitness kemudian akan menolak terhubung jika Telegram melaporkan akun yang berbeda.
  4. Akun Press Connect.

Kunci Otentikasi (512 karakter) bukanlah hash API (32 karakter). Kunci yang sama juga dapat diimpor sebagai JSON, lihat JSON Akun.

Berkas akun#

Buka Tambah Akun → File dan pilih hingga empat file yang terkait dengan satu akun, dengan total ukuran 8 MiB, tekan Periksa File, lalu Hubungkan Akun. Memilih file atau menempelkan teks sesi tidak akan mengirimkan apa pun; tombol Periksa File akan mengirimkannya ke server TgWitness Anda, yang akan membacanya tanpa perlu masuk dan menampilkan sesi yang ditemukan.

Formulir Files, Auth key, dan formulir impor massal menampilkan peringatan sesi paralel sebelum terhubung. Secara default, otorisasi yang diimpor akan digunakan kembali. Biarkan klien asli tetap tertutup selama kuncinya digunakan di sini. Files dan Auth key juga menawarkan Buat otorisasi independen, yang dijelaskan di bawah ini. Impor massal masih menggunakan mode langsung. Masuk melalui telepon dan QR interaktif membuat otorisasi terpisah. Judul peringatan tetap terlihat di formulir impor; penjelasan lengkapnya terbuka secara otomatis saat file atau string kunci/sesi disediakan. Peringatan ini dapat ditutup setelah dibaca, sehingga pemilih file dan kontrol koneksi tetap dapat digunakan di ponsel.

Penerapan yang telah diverifikasi (Phala Cloud, Intel TDX) tidak melakukan pengumpulan data berdasarkan kunci yang diimpor. Di sana, File dan Kunci Otentikasi hanya terhubung jika opsi Buat otorisasi independen dipilih; impor massal ditolak. Masuk melalui telepon dan QR code berfungsi seperti biasa.

  • File dikonversi di memori pada server TgWitness Anda. Unggahan tidak disimpan, file ZIP tidak diekstrak ke disk, dan tidak ada layanan eksternal yang dihubungi.
  • Sesi yang dihasilkan kemudian diverifikasi dengan Telegram. Jika sebuah berkas mencantumkan ID pengguna, ID tersebut harus sesuai dengan akun yang dilaporkan oleh Telegram.
  • Berkas yang mendeskripsikan akun yang berbeda atau kredensial API yang berbeda akan ditolak daripada memilih salah satunya.
  • Kode sandi atau teks sesi berisi bidang kode sandi lokal TData, sebuah kotak untuk menempelkan StringSession dan membaca berkas tanpa masuk (mengisi formulir tanpa menghubungi Telegram). Menempelkan StringSession akan menghapus file yang dipilih, dan memilih file akan menghapus teks yang ditempelkan, sehingga pemeriksaan dan koneksi menggunakan pilihan terbaru. Setelah mengubah kode sandi, tekan Periksa file lagi.

Buat otorisasi independen#

Pilih Buat otorisasi independen sebelum menghubungkan berkas yang diimpor atau Kunci Otorisasi. TgWitness menghubungkan donor yang diimpor sebentar, menggunakannya untuk menyetujui token login QR klien baru, dan memutuskan koneksi donor segera setelah persetujuan. Klien baru memiliki kunci otorisasi sendiri dan profil Desktop yang dipilih secara terpisah. Kredensial API dan profil perangkat yang disediakan oleh donor hanya digunakan untuk koneksi donor. Tidak ada otorisasi yang ada yang dicabut atau dibatalkan.

Pastikan klien asli donor tetap ditutup sepenuhnya selama langkah ini. Koneksi awal masih menggunakan kunci yang disalin, sehingga mode ini tidak dapat menghilangkan risiko penggunaan paralel pada tahap awal tersebut. Setelah otorisasi baru terhubung, pemilik dapat membuka kembali klien asli dan menggunakan keduanya secara bersamaan. Masuk dengan kode QR interaktif memungkinkan klien asli menyetujui proses masuk tanpa menyalin atau menghubungkan kuncinya di sini.

Jangan logout atau mengakhiri sesi donor. Ketika sesi yang menyetujui login QR berakhir, Telegram juga mengakhiri sesi yang telah disetujuinya; dalam pengujian langsung, otorisasi baru terhenti dalam waktu satu detik setelah donor logout. Proses impor mencatat sesi donor (session_origin.approved_by: perangkat, ID API, dan waktu pembuatan). Daftar sesi menandainya, Akhiri sesi akan menolaknya, sedangkan Akhiri semua sesi lainnya dan Jadikan ini satu-satunya sesi akan membiarkannya tetap masuk.

Jika Telegram meminta 2FA, mode ini menggunakan twoFA dari JSON yang dipilih jika tersedia, atau meminta kata sandi. Jika kata sandi yang diimpor ditolak, sistem akan kembali ke formulir kata sandi. Kata sandi tidak disimpan. Kunci kandidat disimpan dalam bentuk terenkripsi di independent_login.enc, termasuk perubahan selama migrasi pusat data. Setelah terjadi gangguan, pilih donor yang sama dan opsi ini untuk melanjutkan kandidat yang disimpan. Donor diperiksa dengan help.getAppConfig sebelum persetujuan; akun yang dibekukan akan terhenti di sana. Jika Telegram menolak donor sebelum menyetujui proses masuk, kunci kandidat yang tidak disetujui akan dibuang dan proses impor dapat dimulai kembali. Donor lain hanya akan menggantikan kunci kandidat yang tersimpan jika Telegram melaporkan bahwa kandidat tersebut belum masuk; kunci kandidat yang sudah masuk atau sedang menunggu kata sandi 2FA-nya akan dipertahankan. Ruang kerja tetap dicadangkan untuk akun tersebut; kegagalan penyelesaian tidak menghapus ruang kerja baru tersebut. Simpan direktori datanya dan kunci brankasnya. Kredensial akhir dan account.authorized catatan jurnal mencakup metode impor, format masukan, dan ID API donor, tanpa kunci atau kata sandi donor.

Pada 5 November 2026, sebuah akun khusus lulus pemeriksaan langsung dengan donatur Telethon, Pyrogram, dan TData: penyelesaian 2FA, kunci otorisasi baru yang berbeda, akses bersamaan oleh donatur dan klien baru, serta membaca saluran publik. Kasus Telethon juga melanjutkan kandidat yang disimpan setelah terjadi gangguan pada langkah kata sandi. Setiap otorisasi baru menyelesaikan enam permintaan inisialisasi pasca-login, dan jurnalnya yang ditandatangani terverifikasi. Sesi asli tetap dapat digunakan dalam keempat format yang disediakan.

Basis data kesalahan RPC Telegram mengaitkan FRESH_CHANGE_ADMINS_FORBIDDEN dengan pergantian admin, FRESH_CHANGE_PHONE_FORBIDDEN dengan perubahan nomor telepon, dan FRESH_RESET_AUTHORISATION_FORBIDDEN dengan pencabutan sesi lain, perubahan masa berlakunya, atau pendaftaran kunci akses. SESSION_TOO_FRESH_* dan PASSWORD_TOO_FRESH_* berkaitan dengan pengalihan kepemilikan serta penarikan pendapatan atau hadiah. Ini bukanlah operasi pengumpulan; login baru tidak berarti larangan pembacaan selama 24 jam secara menyeluruh. Ekspor dapat secara terpisah mengembalikan TAKEOUT_INIT_DELAY_*. TgWitness mempertahankan jeda yang diminta server dan tidak mencoba kembali penerimaan token secara otomatis atau mencabut sesi untuk mengatasi pembatasan.

Alat lainnya → Akun → Keamanan akun → Sesi akun ini → Akhiri semua sesi lainnya memanggil `auth.resetAuthorizations` atas permintaan operator dan mencatat `account.all_other_sessions_terminated` beserta jumlah sesi sebelum dan sesudahnya. Telegram menerimanya dari sesi yang telah masuk selama 24 jam. Ketika ruang kerja ini masuk melalui QR dari sesi yang diimpor, sesi yang menyetujuinya tetap masuk: TgWitness mengakhiri sesi lainnya satu per satu dengan `account.resetAuthorization` dan mencatat `kept_approving_session`. Jadikan ini sebagai satu-satunya sesi, lalu hentikan dengan alasan tersebut dan jangan ubah kata sandi.

Jadikan sesi ini satu-satunya yang melakukan hal yang sama untuk kunci yang dibuat dengan masuk dari ruang kerja ini, lalu aktifkan kata sandi dua langkah jika akun tersebut belum memilikinya. Panel akan menampilkan kata sandi tersebut sekali; TgWitness menyimpannya di brankas ruang kerja hanya sampai saat itu. Catatan jurnal session.exclusive_from. Jika Telegram kemudian mencantumkan sesi lain, jurnal mencatatnya session.exclusive_ended dan panel akan menampilkan peringatan. Verifikator akan mencetak keduanya.

Jadikan ini satu-satunya sesi ketika Telegram mengizinkannya sebagai tindakan yang sama berdasarkan timer. Opsi ini muncul di bawah Sesi akun ini untuk kunci yang dibuat di ruang kerja ini dan dicatat sebagai session.exclusive_automatic. Selama pemantauan, pengumpul memeriksa setiap lima menit apakah 24 jam telah berlalu sejak catatan account.authorized kunci tersebut — Telegram menjawab FRESH_RESET_AUTHORISATION_FORBIDDEN sebelum itu — dan kemudian menjalankan operasi yang sama sekali. Keberhasilan dicatat sebagai session.exclusive_from, seperti tombol manual. Penolakan dicatat sekali sebagai session.exclusive_postponed dengan alasan dari Telegram, dan pengumpul mencoba kembali dengan penundaan yang semakin lama hingga enam jam. Akses baca-saja tidak berpengaruh di sini: mengakhiri sesi merupakan tindakan keamanan akun, bukan tindakan obrolan.

Kata sandi dua langkah yang dihasilkan oleh proses otomatis disimpan di brankas ruang kerja, dienkripsi dengan kunci ruang kerja, sebelum Telegram menetapkannya. Panel mengambilnya sekali dari POST /api/account/sessions/only/password, yang kemudian menghapusnya, dan menampilkannya di dialog yang sama seperti alur manual saat Anda membuka Sesi akun ini. Halaman koneksi mencatat bahwa ada kata sandi yang menunggu. Kata sandi tersebut tidak pernah masuk ke jurnal dan tetap ada setelah sistem di-restart hingga ditampilkan.

Sesi baru juga dilaporkan selama proses pengamatan: ketika daftar sesi Telegram bertambah satu entri, catatan account.sessions mencatatnya di bawah added dan panel menampilkan peringatan yang mencantumkan perangkat, aplikasi, dan negara dari snapshot tersebut.

Probe saksi#

Alat lainnya → Akun → Keamanan akun → Pemeriksaan probe saksi memeriksa apakah klien lain menerima pembaruan dari akun ini. Tambahkan ruang kerja kedua yang masuk dengan akun Telegram berbeda dan kunci sesi tersendiri, buat grup pribadi dengan kedua akun tersebut, lalu pilih grup itu sebagai obrolan Probe dan ruang kerja kedua sebagai ruang kerja Saksi, kemudian aktifkan probe. Kedua akun harus menonaktifkan mode Hanya Baca, dan ruang kerja saksi harus dalam mode pengamatan.

Saat melakukan pengamatan, ruang kerja ini mengirimkan probe:<n>:<token> ke grup setiap 60–120 detik dan mencatat probe.sent. Saksi menjawab ack:<n>:<token> dan mencatat probe.seen serta probe.ack_sent. Sebuah ack yang mencapai sesi ini sebagai pembaruan langsung dalam waktu 20 detik dicatat sebagai probe.acked. Jika tidak, ruang kerja membaca riwayat terbaru grup. Sebuah ack yang ditemukan di sana tetapi tidak dikirim secara langsung dicatat sebagai coverage.gap dengan alasan probe_ack_missed_live: panel mengeluarkan peringatan dan menandai penerimaan peristiwa sebagai gagal hingga ack berikutnya tiba secara langsung (connection.restored, alasan probe_ack_live). Tidak ada ack yang dicatat sebagai probe.unanswered; gangguan koneksi selama masa tunggu atau riwayat yang tidak dapat dibaca dicatat sebagai probe.inconclusive. Pembatasan baca-saja, pembatasan Telegram, dan jeda FloodWait dicatat sekali sebagai probe.skipped.

Telethon .session#

Apa itu Basis data SQLite yang dibuat oleh alat berbasis Telethon, misalnya my_account.session
Diakui oleh Tabel sessions (bersama dengan dc_id, server_address, port, auth_key) dan version = 7 atau 8
Persyaratan Tepat satu baris sesi yang diotorisasi; basis data yang tertutup dan lengkap

Tutup terlebih dahulu program yang membuat berkas tersebut. Jika terdapat my_account.session-journal atau my_account.session-wal di sampingnya, berarti basis data belum diselesaikan: buka dan tutup klien aslinya dengan benar. Menghapus berkas-berkas sidecar tersebut dapat meninggalkan salinan yang rusak.

Pyrogram .session#

Apa itu Alat berbasis Pyrogram yang menggunakan basis data SQLite
Diakui oleh Tabel sessions dengan dc_id, auth_key, test_mode, user_id, is_bot; version = 2 atau 3
Persyaratan Satu sesi pengguna yang berwenang di jaringan produksi. Sesi bot dan test-DC ditolak

ID pengguna yang disimpan akan diverifikasi dengan Telegram saat login.

Pasangan sesi + JSON#

Akun sering kali didistribusikan dalam bentuk dua berkas dengan nama yang sama, misalnya 447700900123.session dan 447700900123.json. Pilih keduanya sekaligus.

  • Dari JSON, TgWitness menggunakan app_id/api_id dan app_hash/api_hash, sehingga Anda biasanya tidak perlu memasukkan kredensial API.
  • Profil koneksi menggunakan device_model (alias device), system_version (alias sdk), app_version, lang_code, system_lang_code (alias system_lang_pack), lang_pack, dan tz_offset opsional (detik dari UTC, -43200 hingga 50400). Bidang yang diisi memiliki prioritas lebih tinggi daripada nilai default yang dihasilkan dan bahasa panel/browser . Alias yang bertentangan akan ditolak. Profil yang telah diselesaikan disimpan dalam kredensial ruang kerja terenkripsi dan digunakan kembali setelah restart, termasuk versi aplikasinya.
  • phone, pengaturan proxy, dan token perangkat diabaikan. twoFA bersifat hanya baca ketika Buat otorisasi independen dipilih; impor langsung mengabaikannya.
  • JSON tanpa bidang otorisasi yang didukung hanyalah metadata. Tambahkan berkas sesi atau lanjutkan dengan login melalui telepon atau QR. JSON yang berisi sesi yang didukung atau Kunci Otorisasi dapat melakukan otorisasi secara mandiri; lihat Account JSON.

Telegram Desktop (TData)#

TData adalah folder tdata dari aplikasi Telegram Desktop (aplikasi lintas platform dari desktop.telegram.org).

Sistem Lokasi default tdata
Windows %APPDATA%\Telegram Desktop\tdata (Telegram portabel: di sebelah Telegram.exe)
Linux ~/.local/share/TelegramDesktop/tdata
macOS ~/Library/Application Support/Telegram Desktop/tdata

Untuk mengimpornya:

Peringatan sesi paralel. Impor TData langsung menggunakan kembali kunci otorisasi Telegram Desktop. Jangan gunakan kunci tersebut di Desktop dan TgWitness secara bersamaan. Telegram dapat membatalkan otorisasi tersebut dengan AUTH_KEY_DUPLICATED, sehingga kedua salinan menjadi tidak dapat digunakan hingga login baru dilakukan.

Tutup Desktop sepenuhnya, termasuk proses tray-nya, dan biarkan salinan tersebut tetap tertutup saat TgWitness menggunakan sesi yang diimpor. Tutup, jangan logout atau mencabut sesi: pencabutan juga akan membatalkan salinan yang diimpor. Jika Anda memerlukan kedua klien berjalan, pilih Buat otorisasi independen dan biarkan Desktop tetap tertutup hingga login baru berhasil, atau masuk ke TgWitness melalui telepon atau QR. Akun khusus disarankan, tetapi tidak menjamin keamanan kunci kloning untuk digunakan secara paralel.

Hal ini juga berlaku untuk berkas yang diimpor .session , teks StringSession, dan Auth Key HEX. Klien lain dengan otorisasi yang dibuat secara mandiri dapat tetap masuk. Lihat dokumentasi AUTH_KEY_DUPLICATED dari Telegram.

  1. Keluar sepenuhnya dari Telegram Desktop.
  2. Buatlah berkas ZIP yang hanya berisi dua item berikut dari tdata:

    • key_datas
    • file berhuruf 16 yang berakhiran s di sebelahnya, biasanya D877F783D5D3EF8Cs

    Mengompres seluruh folder beserta cache medianya biasanya melebihi batas (512 entri, 32 MiB setelah diekstrak). 3. Pilih berkas ZIP di bagian "Files". Jika Telegram Desktop memiliki kode sandi lokal, masukkan kode tersebut di kolom "Passcode" atau "session text" terlebih dahulu. Ini bukanlah kata sandi 2FA.

Didukung: satu akun per arsip, penyimpanan modern key_datas/key_data0/key_data1, kode sandi lokal. Tidak didukung: folder dengan beberapa akun yang masuk, tata letak Desktop versi lama, file ZIP yang dilindungi kata sandi, dan aplikasi asli macOS terpisah "Telegram for macOS".

Telethon StringSession#

Satu baris teks, biasanya dimulai dengan 1 dan panjangnya sekitar 350 karakter. Unggah berkas tersebut sebagai berkas .txt atau .tgwitness-session (maksimal 4 KiB), atau tempelkan di bawah kolom Kode Akses atau teks sesi. Hanya string Telethon yang diterima; string Pyrogram dan TDLib menggunakan format yang berbeda.

Kunci otentikasi dan DC dalam satu baris#

Daftar akun sering kali memuat otorisasi mentah dalam bentuk <512 hexadecimal characters>:<DC id>, misalnya a1b2…ef:5. Tempelkan baris tersebut di bawah kolom Kode Akses atau teks sesi, muat sebagai berkas teks, atau masukkan ke dalam bidang session pada JSON Akun. TgWitness memetakan DC 1–5 ke alamat produksi yang sama seperti impor JSON auth_key + dc_id dan melaporkan formatnya sebagai Kunci Otorisasi HEX dan DC. Nomor DC atau panjang kunci lain apa pun akan ditolak.

JSON Akun#

Satu objek JSON, maksimal 64 KiB, dalam berkas dengan ekstensi .json.

Bidang (alias) Arti
api_id (app_id) ID Aplikasi, sebuah bilangan positif
api_hash (app_hash) Hash aplikasi, 32 karakter heksadesimal
string_session (session_string, session_str; session versi lama) Teks Telethon StringSession, atau <512 hexadecimal characters>:<DC id>, bukan nama berkas
auth_key (auth_key_hex) + dc_id Kunci Otentikasi (Auth Key) lengkap berpanjang 512 karakter dan DC 1–5
user_id (id) Opsional; diverifikasi dengan Telegram sebelum otorisasi disimpan
device_model (device) Deskripsi perangkat koneksi
system_version (sdk) Versi OS koneksi
app_version Versi aplikasi yang dikirim ke Telegram
lang_code, system_lang_code (system_lang_pack), lang_pack Bahasa klien, bahasa sistem, dan paket bahasa klien; nilai kosong untuk lang_pack diperbolehkan
tz_offset Offset UTC opsional dalam detik, dikirim dalam initConnection.params; bilangan bulat atau string bilangan desimal

Jika alias dan nama utama keduanya ada, keduanya harus sama. Bidang sesi Telethon yang eksplisit memiliki prioritas lebih tinggi daripada blob session generik dalam format lain. Jika keduanya berisi sesi Telethon yang dapat dikenali, keduanya harus menggambarkan otorisasi yang sama. Tanpa bidang eksplisit, session harus berupa StringSession Telethon yang valid atau kunci otorisasi dan DC dalam bentuk <512 hexadecimal characters>:<DC id>. Contoh:

{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
  "api_id": 1234567,
  "api_hash": "0123456789abcdef0123456789abcdef",
  "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
  "dc_id": 2,
  "user_id": 123456789
}

Contoh pertama hanya mengisi kredensial API; masuk dengan nomor telepon atau QR, atau tambahkan berkas sesi. Daftar massal (array JSON akun) tidak diterima.

Identifikasi apa yang Anda miliki#

Anda melihat Ini adalah Penggunaan
*.session; saat dibuka di editor teks, bagian atasnya menampilkan SQLite format 3 Telethon atau Pyrogram SQLite Berkas (terdeteksi secara otomatis)
Folder tdata yang berisi key_datas Telegram Desktop TData Kompres dua berkas menjadi ZIP, lalu Berkas
Satu baris teks yang dimulai dengan 1, ~350 karakter Telethon StringSession Berkas
Satu baris teks 512 characters 0-9a-f, diikuti : dan angka 1–5 Kunci otentikasi dan DC Berkas, kode sandi kotak, atau teks sesi
*.json dengan app_id/app_hash Metadata pendamping Berkas, beserta sesi-nya
*.json dengan auth_key atau string_session JSON Akun Berkas
512 karakter 0-9a-f Kunci Otentikasi Kunci otentikasi
32 karakter 0-9a-f Hash API ID API + Hash
td.binlog atau db.sqlite dari aplikasi TDLib Penyimpanan TDLib Tidak didukung
123456789:AA… Token bot Tidak didukung

Format yang tidak didukung#

Format Alternatif
Penyimpanan TDLib (td.binlog) dan ekspor TDLib Masuk menggunakan nomor telepon atau QR
String sesi Pyrogram Gunakan berkas Pyrogram .session, atau ponsel/QR
TData dengan beberapa akun yang telah masuk Keluar dari akun-akun lain di Telegram Desktop, atau gunakan berkas sesi masing-masing akun
Token bot Tidak didukung: TgWitness beroperasi sebagai akun pengguna
Daftar CSV/JSON dari banyak akun Impor file sesi yang didukung melalui Akun → Impor akun, atau masuk melalui telepon/QR di ruang kerja terpisah
Sesi Test-DC atau bot Gunakan akun pengguna produksi

Beberapa akun#

Tekan tombol + di samping pemilih akun, atau buka Alat lainnya → Akun → Pengaturan → Pengaturan koneksi → Ruang kerja, masukkan label, lalu masuk.

  • Jumlah ruang kerja tidak terbatas, termasuk ruang kerja utama. Masing-masing memiliki sesi, rute proxy , sumber, kebijakan penangkapan, jurnal, kunci penandatanganan, titik pemeriksaan, dan ekspor tersendiri.
  • Mengganti ruang kerja yang ditampilkan tidak akan menghentikan ruang kerja lainnya.
  • Sebuah jurnal tetap terikat pada akun yang membuatnya. Masuk dengan akun yang berbeda memerlukan ruang kerja lain, dan satu akun tidak dapat ditugaskan ke dua ruang kerja.
  • Token panel utama mengontrol semua ruang kerja. Akses yang diberikan dapat membatasi orang lain hanya pada akun dan obrolan tertentu, dengan izin dan batas sesi yang terpisah.
  • Akun mengganti nama ruang kerja dan menghapus ruang kerja yang ditambahkan, beserta sesi, jurnal, sumber, dan kunci penandatanganan. Ruang kerja utama tidak dapat dihapus dari panel.

Impor massal dan grup akun#

Gunakan Akun → Impor akun untuk menambahkan beberapa akun, pasangkan berkas berdasarkan nama dasar dan lihat hasil login masing-masing. Setiap akun memiliki ruang kerja tersendiri.

Sebuah grup menyatukan akun-akun yang terkait tanpa menggabungkan sesi, kunci, atau bukti mereka. Buka grup di bagian Akun untuk menuju ke halamannya di /groups/<id>:

  • Akun: rute koneksi, pengamatan, dan pesan terakhir setiap anggota, dengan Mulai Semua dan Jeda Semua.
  • Perlu perhatian: akun yang telah keluar, tidak tersedia, atau mengalami masalah koneksi, input, sumber, atau media; setiap nama mengarah ke kartunya masing-masing.
  • Obrolan di beberapa akun menampilkan: sumber yang dibagikan, akun-akun yang mengamati obrolan tersebut, dan gangguan dalam periode pengamatan ruang kerja yang tersedia (hingga tujuh hari). Ekspor dengan N akun membagi ekspor saluran atau supergrup di antara akun-akun tersebut dan menandatangani satu arsip.
  • Ekspor grup: satu ZIP dengan ekspor yang telah ditandatangani dari setiap akun di bawah accounts/ dan manifest.json mencantumkan SHA-256 dan sidik jari kunci masing-masing, yang ditandatangani oleh ruang kerja utama di manifest.signature.json. Verifikasi setiap arsip akun secara terpisah dengan python -m tgwitness.verify dan sidik jari tepercaya akun tersebut.

Anggota berbagi pengaturan grup; sebuah akun dapat mempertahankan nilai-nilainya sendiri. Lihat pengaturan bersama, panduan impor dan grup dan dasbor kolam MTProxy.

Keluar#

Alat lainnya → Akun → Keluar dari Telegram (dengan pengamatan ditangguhkan) meminta Telegram untuk mengakhiri sesi, sehingga sesi tersebut juga menghilang dari Pengaturan → Perangkat akun, dan menghapus sesi dari brankas ruang kerja. Jurnal, sumber, pengaturan, dan kunci penandatanganan tetap ada, dan jurnal mencatat proses keluar tersebut. Ruang kerja tersebut masih milik akunnya: hanya akun tersebut yang dapat terhubung kembali ke ruang kerja tersebut. Jika Telegram tidak merespons, sesi tersebut tetap dihapus di sini dan panel akan menampilkannya; akhiri sesi tersebut di Telegram melalui Pengaturan → Perangkat.

Saat Telegram mengakhiri sesi#

Jika Telegram memblokir, membekukan, atau mengeluarkan akun, atau mengakhiri sesi dari perangkat lain, jurnal akan mencatat penyebabnya, kesalahan Telegram, rute, dan pusat data. Kondisi akun ditampilkan dalam “Unduh laporan kehilangan akun”: berkas JSON yang ditandatangani berisi catatan jurnal selama 24 jam sebelum kehilangan akun, yaitu koneksi, rute, sesi, pemberitahuan akun, dan celah cakupan, masing-masing dilengkapi dengan hash jurnal dan tanda tangannya. Periksa dengan python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; ekspor bukti berisi rantai hash lengkap. Akun yang dibekukan juga terdeteksi saat terhubung dan selama pemantauan, serta tindakan pengiriman dan bergabungnya dinonaktifkan.

Menjaga keamanan berkas akun#

  • Perlakukan setiap .session, TData ZIP, StringSession, Auth Key, dan JSON akun seperti kata sandi. TgWitness menyimpan otorisasi yang diimpor di dalam brankas terenkripsinya; Anda dapat menghapus file aslinya setelahnya.
  • Jangan menjalankan otorisasi yang sama di dua program sekaligus. Telegram dapat mencabutnya (AUTH_KEY_DUPLICATED), dan kedua salinan tersebut akan berhenti berfungsi.
  • Sesi yang telah kedaluwarsa atau dicabut tidak dapat diaktifkan kembali melalui konversi. Silakan masuk kembali.

Pemecahan Masalah#

Pesan atau gejala Apa yang harus dilakukan
Tidak dapat membaca sesi ini. Tutup klien aslinya… Berkas SQLite sedang terbuka atau belum selesai (sidecar -journal/-wal). Tutup program aslinya dengan benar, lalu salin kembali berkas tersebut.
Skema SQLite Telethon yang didukung: 7 dan 8 / Pyrogram … 2 dan 3 File ini dibuat menggunakan versi pustaka yang sangat lama atau tidak dikenal. Silakan masuk menggunakan nomor telepon/QR.
Hanya sesi pengguna produksi yang berwenang yang didukung Berkas Pyrogram tersebut milik bot atau jaringan uji coba.
Arsip TData melebihi 512 entri atau 32 MiB Hanya berkas ZIP key_datas dan D877F783D5D3EF8Cs, bukan seluruh folder.
Tidak dapat mendekripsi TData. Periksa kode sandi lokal Desktop Masukkan kode sandi lokal Telegram Desktop di kolom "Passcode" atau "session text".
Impor satu akun TData pada satu waktu Telegram Desktop memiliki beberapa akun; lihat Format yang Tidak Didukung.
Berkas-berkas yang dipilih menjelaskan akun-akun yang berbeda atau kredensial API Pilih file dari satu akun saja.
JSON tidak berisi kredensial API atau otorisasi yang didukung Periksa nama-nama bidang dalam JSON Akun.
Hanya metadata API JSON ini tidak memiliki sesi. Tambahkan berkas .session atau gunakan nomor telepon/kode QR.
Kunci Otorisasi HEX harus berisi seluruh 512 karakter heksadesimal Kunci tersebut terpotong atau mengandung ….
ID akun tidak sesuai dengan akun yang diimpor ID pengguna pada berkas tersebut berbeda dengan yang dilaporkan oleh Telegram; berkas tersebut diperuntukkan bagi akun lain.
Akun ini sudah terdaftar di ruang kerja lain Buka ruang kerja tersebut daripada menambahkan akun dua kali.
Sudah terhubung, tetapi grup pribadi tidak muncul dalam daftar obrolan di Alat Lainnya → Sumber Periksa keanggotaan. Pemilih memeriksa 1,000 dialog pertama; tingkatkan batasnya di Alat Lainnya → Parameter.
Koneksi proxy gagal Periksa rute dan mode IP. Secara otomatis, MTProxy akan mencoba entri lain yang berfungsi. Sembunyikan penundaan alamat; Direct sebagai pilihan terakhir dapat terhubung langsung setelah penundaan yang telah dikonfigurasi. Lihat mode perutean.

Lihat juga: koneksi dan keamanan untuk proxy dan enkripsi, serta cara kerja pengumpulan data yang direkam setelah masuk.