# Telegram · Format akun dan sesi

Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/accounts/

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

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

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

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Memulai](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/)

![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#at-a-glance)
- [Sebelum memulai: ID API dan hash API](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#before-you-start-api-id-and-api-hash)
- [Nomor telepon](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#phone-number) · [Kode QR](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#qr-code) · [Kunci Otentikasi + ID DC](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#auth-key--dc-id)
- [Berkas akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#pyrogram-session) · [Pasangan sesi + JSON](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#telethon-stringsession) · [Kunci otentikasi dan DC dalam satu baris](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [JSON Akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json)
- [Identifikasi apa yang Anda miliki](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#identify-what-you-have) · [Format yang tidak didukung](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#unsupported-formats)
- [Beberapa akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#multiple-accounts) · [Menjaga keamanan berkas akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#keeping-account-files-safe) · [Pemecahan Masalah](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#troubleshooting)

## 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](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735): 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](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java). 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](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (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](https://phishdestroy.io/tgwitness/id/docs/reference/collection/#strict-chosen-chats) 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](https://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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json).

## 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](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/) (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](https://core.telegram.org/api/errors.json) 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 di**abaikan**. `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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#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](https://core.telegram.org/api/errors#406-not-acceptable).

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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json). 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](https://phishdestroy.io/tgwitness/id/docs/reference/access/) 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](https://phishdestroy.io/tgwitness/id/docs/reference/settings/#account-groups), [panduan impor dan grup](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) dan [dasbor kolam MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources).

## 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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#unsupported-formats). |
| *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](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#account-json). |
| *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](https://phishdestroy.io/tgwitness/id/docs/reference/connection/#ip-modes). |

Lihat juga: [koneksi dan keamanan](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) untuk proxy dan enkripsi, serta [cara kerja pengumpulan](https://phishdestroy.io/tgwitness/id/docs/reference/collection/) data yang direkam setelah masuk.
