# Telegram · Akaun dan format sesi

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

Log masuk melalui telefon, kod QR atau kunci auth, import sesi Telethon, Pyrogram atau Telegram Desktop, dan jalankan beberapa akaun.

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

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

Log masuk melalui telefon, kod QR atau kunci auth, import sesi Telethon, Pyrogram atau Telegram Desktop, dan jalankan beberapa akaun.

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

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

TgWitness log masuk sebagai **akaun pengguna Telegram** (bukan bot) melalui MTProto, menggunakan Telethon. Setiap akaun wujud dalam **ruang** kerja sendiri (dipanggil *workspace* dalam API dan alat baris perintah) dengan sesi, sumber, jurnal dan kunci tandatangan masing-masing.

Fail sesi, rentetan sesi dan Kunci Auth adalah **kebenaran akaun**: sesiapa yang memegangnya boleh bertindak sebagai akaun tersebut. Ia tidak mengandungi sejarah mesej.

> [!AMARAN] **Gunakan akaun khusus.** Telegram mengehadkan dan boleh mengharamkan akaun secara kekal untuk jumlah permintaan yang dianggap berlebihan, tidak kira klien atau tujuannya, dan hanya mendokumenkan had tersebut sebahagiannya. Sambungkan akaun yang disediakan untuk pemerhatian dan bukannya akaun peribadi atau yang berharga, dan cipta ID API / hash API pada akaun khusus.

- [Sekilas](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#at-a-glance)
- [Sebelum anda bermula: ID API dan hash API](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#before-you-start-api-id-and-api-hash)
- [Nombor telefon](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#phone-number) · [Kod QR](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#qr-code) · [Kunci Auth + ID DC](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#auth-key--dc-id)
- [Fail akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#pyrogram-session) · [Pasangan sesi + JSON](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#telethon-stringsession) · [KunciAuth dan DC dalam satu baris](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [JSON Akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#account-json)
- [Kenal pasti apa yang anda ada](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#identify-what-you-have) · [Format yang tidak disokong](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#unsupported-formats)
- [Beberapa akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#multiple-accounts) · [Menjaga keselamatan fail akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#keeping-account-files-safe) · [Pemecahan masalah](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#troubleshooting)

## Sekilas

| Apa yang anda ada | Tab dalam **Tambah Akaun** | Anda juga akan memerlukan |
| --- | --- | --- |
| Nombor telefon dan akses kepada kod log masuknya | **Telefon** | Kata laluan 2FA jika diaktifkan |
| Telegram dibuka pada peranti lain | **Kod QR** | Kata laluan 2FA jika diaktifkan |
| Fail `.session` (Telethon atau Pyrogram) | **Fail** | JSON pilihan untuk tetapan aplikasi |
| `.session` + `.json` dengan nama yang sama | **Fail** (pilih kedua-duanya) | Biasanya tiada apa-apa lagi |
| Folder `tdata` Telegram Desktop | **Fail** (sebagai ZIP) | Kod laluan tempatan Desktop jika ditetapkan |
| Sesi Rangkaian Telethon (teks, `.txt`, `.tgwitness-session`) | **Fail** | Tiada pasangan API berasingan diperlukan |
| Kunci auth dan DC dalam satu baris, `<512 hex>:<1–5>` | **Fail** (tampal atau fail teks) | Tiada pasangan API berasingan diperlukan |
| `.json` dengan sesi atau Kunci Auth | **Fail** | Tiada pasangan API berasingan diperlukan |
| Kunci Auth (512 aksara heksadesimal) dan nombor DC-nya | **KunciAuth** | ID Pengguna Pilihan |

TgWitness mengenali fail berdasarkan **kandungannya**, bukan namanya. Menama semula fail tidak pernah mengubahnya.

## Sebelum anda bermula: ID API dan hash API

Anda boleh log masuk tanpa mencipta aplikasi Telegram API. Apabila tiada pasangan dimasukkan, diimport atau telah disimpan dalam ruang kerja, TgWitness memilih pasangan daripada kolam terbina dalam 50 pasangan API awam (`tgwitness/api_pool.py`), memprioritkan Telegram Desktop untuk log masuk baharu dan mengekalkan pasangan yang disimpan terlebih dahulu; calon selebihnya dikocok. Jika Telegram menolak pasangan (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`), yang seterusnya akan dicuba, sehingga lapan setiap kali log masuk; pasangan yang ditolak akan diabaikan sehingga dimulakan semula. Pasangan yang digunakan untuk log masuk akan disimpan bersama akaun dan digunakan semula untuknya.

Pasangan terbina dalam adalah awam: ia diterbitkan dalam kod sumber terbuka klien dan perpustakaan Telegram. **ID API** dan **hash API** mengenal pasti aplikasi kepada Telegram dan tidak memberikan sebarang akses kepada data akaun. Log masuk menggunakan kebenaran akaun itu sendiri: kod log masuk dan kata laluan 2FA, atau sesi yang telah dibenarkan oleh akaun tersebut. Setiap `observation.started` Setiap rekod menamakan pasangan yang digunakan, jadi pasangan terbina dalam didokumenkan untuk mahkamah dengan cara yang sama seperti pasangan anda sendiri. Anda boleh memasukkan pasangan anda sendiri dari my.telegram.org sebaliknya. Berdasarkan pengalaman projek, pasangan peribadi baru menyebabkan kebanyakan akaun log keluar, jadi gunakan hanya apabila kes memerlukan aplikasi anda sendiri: cipta dengan akaun khusus dan masukkan sebelum pengumpulan bermula (langkah di bawah).

Medan sambungan yang hilang menggunakan pasangan peranti/OS deterministik daripada [katalog opentele2 2.0.0](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735) yang disertakan: Desktop `2040`, Android `6`, Android X `21724`, iOS `10840`, macOS `2834`, dan Web `2496`. ID binaan sumber Android `4` juga menggunakan katalog Android, seperti yang dikenal pasti dalam [BuildVars Telegram Android](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java). Web secara lalai adalah A; sufix versi aplikasi `K` yang diimport atau pek bahasa `macos` memilih K, dan versi `0.7.0` memilih Webogram. ID aplikasi yang tidak diketahui mengekalkan lalai hos Telethon. Medan yang diimport sentiasa diutamakan, termasuk versi aplikasi yang lebih lama dan pek bahasa yang kosong. Katalog tidak pernah menukar ID/hash API. Snapshot versinya disemak secara eksplisit, bukan dimuat semasa log masuk. Profil yang disimpan kekal stabil selepas kemas kini.

`account.getAuthorizations` melaporkan metadata kebenaran yang disimpan oleh Telegram; ia bukan salinan bagi setiap `initConnection` yang baharu. Bandingkannya dengan profil yang sebenarnya dihantar. Menghubungkan kebenaran sedia ada tidak mengesahkan hash API penemanannya: `initConnection` menghantar ID API, manakala hash digunakan oleh permintaan log masuk.

Selepas pengesahan telefon baru atau QR, TgWitness meminta konfigurasi, DC terdekat, status dalam talian, bahasa (apabila pek bahasa tidak kosong), kemas kini aplikasi dan kemas kini terma perkhidmatan, dengan selang 0.3–1.5 saat antara permintaan. Mengemas kini status secara ringkas menandakan akaun sebagai dalam talian. Susunan ini dijalankan sekali selepas log masuk selesai, bukan semasa import, sambungan semula atau permulaan semula. Kebenaran disimpan terlebih dahulu; permintaan yang gagal menhentikan susunan tanpa mencuba semula atau membuang log masuk. Keputusan direkod sebagai `account.initialized`, dengan nama ralat dan bukannya badan respons. Dasar Telegram sendiri menentukan sekatan akaun.

Untuk `tdesktop` , `tz_offset` yang hilang menggunakan selisih UTC tempatan pelayan, dibundarkan ke 900 saat menggunakan [algoritma opentele2](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT; lesen dalam `tgwitness/client_profiles.LICENSE` ). Ia dikemas kini pada setiap pautan supaya perubahan penjimatan waktu diambang. `tz_offset` yang diimport diutamakan pada setiap platform dan dikekalkan dengan tepat, termasuk sifar. Kemasukan `initConnection.params` lain dikekalkan. Borang log masuk HTTP menerima zon waktu numerik yang dikembalikan oleh import fail; boolean, pecahan dan selisih di luar julat yang disokong ditolak.

Rute Direct, SOCKS5 dan HTTP CONNECT menggunakan `ConnectionTcpObfuscated` Telethon (MTProto ringkas yang di-obfuskasi). HTTPS CONNECT mengekalkan TLS ke proksi dan menggunakan pengangkutan yang di-obfuskasi yang sama di dalam terowong. MTProxy mengekalkan pengangkutan perantara rawak yang diperlukan dan pengendalian rahsia. Peralihan rute menerapkan pilihan yang sama. Pengaburan mengubah bingkai paket; ia tidak menyembunyikan akaun atau metadata kliennya daripada Telegram atau menunjukkan kebebasan daripada sekatan.

Selepas menyambungkan klien yang dibenarkan, TgWitness memeriksa konfigurasi, pusat data terdekat, kebenaran semasa, garis dasar lapisan yang disemak, bahasa, kemas kini aplikasi dan kemas kini terma perkhidmatan. Diagnostik ini dijalankan sekali bagi setiap instans klien, sebelum pengumpulan, dan dipaparkan di bawah butiran sambungan beserta waktunya. `account.connection_checked` merekodkan keputusan tanpa hash sesi, IP, token atau hash API. Mereka tidak pernah menerima terma atau memasang kemas kini. Kegagalan permintaan atau FloodWait menghentikan permintaan seterusnya; keputusan yang hilang kekal tidak diketahui. Semakan tempatan masih boleh melaporkan keputusan mereka manakala semakan rangkaian dilangkau. Dengan [sembang terpilih ketat](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#strict-chosen-chats) diaktifkan, kebenaran semasa tidak diminta dan semakan itu ditunjukkan sebagai dilangkau.

Selepas log masuk dan pada setiap sambungan baru, TgWitness membaca tetapan kandungan sensitif akaun. Apabila ia dimatikan dan Telegram membenarkan perubahan, TgWitness mengaktifkannya supaya kandungan yang ditandakan oleh Telegram sebagai sensitif (18+) disimpan, dan merekod `account.content_settings`. Tetapan ini milik akaun dan terpakai dalam setiap aplikasi Telegram. Perbualan terpilih yang ketat tidak menjejaskannya; aktifkan tetapan itu sebelum log masuk.

Permintaan serentak untuk memulihkan sambungan satu ruang kerja berkongsi klien yang sama dan menunggu penyediaan sambungannya selesai. Percubaan yang gagal atau dibatalkan membebaskan permintaan seterusnya untuk mencuba semula. Jika butiran log masuk yang disimpan, klien atau status kebenaran berubah semasa penyediaan, percubaan yang lebih lama akan berhenti dan bukannya melaporkan sambungan yang sedia digunakan.

Diagnostik FloodWait mengekalkan kaedah TL yang gagal, sebarang pembalut Takeout/range, menunggu yang diminta oleh pelayan dan tarikh akhir berkesan dalam `telegram.backoff`. Butiran sambungan memaparkan kaedah dan tarikh akhir semasa permintaan ditangguhkan. Diagnostik ini termasuk pengira panggilan klien bagi setiap kaedah sejak klien itu dicipta; ia mengira penyelesaian rakan sebaya bersarang secara berasingan, tetapi tidak mengira paket atau percubaan cuba semula dalaman Telethon. Pengira semasa juga tersedia sebagai `collector.rpc_activity` dalam API status. Tiada hujah permintaan, nama pengguna, hashes akses atau teks pengecualian disertakan. Diagnostik terakhir dan tarikh akhir penuh akan kekal selepas permulaan semula. Tempoh menunggu terdahulu tanpa rekod kaedah tidak dapat dikaitkan semula. Lihat [had eksport](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md) untuk semakan sumber dan perbezaan antara penemuan dan pemerolehan sejarah.

`official_app=True` atau `False` ialah penanda kebenaran semasa Telegram. Tiada satu pun nilai tersebut menentukan sama ada akaun itu terhad, dipercayai atau sedang diperhatikan. Snapshot sedia ada mod bukti `account.devices` kekal sebagai sejarah semua peranti yang log masuk; diagnostik sambungan hanya mengekalkan penerangan peranti semasa.

Sebelum sambungan, pemeriksaan penasihat membandingkan platform API, pek bahasa, format peranti/OS dan versi aplikasi, lokel sistem mudah alih, dan lapisan skema sebenar Telegram dengan garis dasar katalog yang telah disemak. Amaran muncul dalam log pelayan dan metadata status akaun; ia tidak pernah menggantikan nilai yang diimport atau mengubah lapisan skema. Lapisan yang berbeza adalah isyarat untuk menyemak keserasian; status sambungan akaun itu sendiri menunjukkan sama ada ia berfungsi. Telegram memutuskan sekatan di pihaknya, tanpa mengira profil klien yang digunakan. Status akaun terputus menggunakan profil yang disimpan dan bukannya menjana penerangan peranti lain.

Untuk menggunakan aplikasi anda sendiri sebaliknya:

1. Buka [my.telegram.org](https://my.telegram.org) dan log masuk dengan mana-mana nombor telefon yang anda miliki. Kod akan sampai dalam aplikasi Telegram, bukan melalui SMS.
2. Pilih **alat pembangunan API**.
3. Buat aplikasi: mana-mana tajuk dan nama ringkas (5–32 huruf), platform **Desktop**. URL dan keterangan boleh dibiarkan kosong.
4. Salin **ID aplikasi api_id** (sebuah nombor) dan **hash aplikasi api_hash** (32 aksara heksadesimal).

Di panel, buka **ID API + Hash** di bawah borang log masuk. Anda boleh menampal satu pasang `api_id:api_hash` ke dalam **ID API** dan kedua-dua medan akan diisi. Satu pasang boleh digunakan untuk semua akaun anda. Selepas log masuk berjaya, ia disimpan, disulitkan, dalam ruang kerja itu sahaja dan tidak pernah dihantar semula ke pelayar.

Tiga kelayakan berbeza terlibat:

| Rahsia | Membuka | Tempat ia berada |
| --- | --- | --- |
| Token panel | Panel web TgWitness | `panel-token.txt` dalam direktori data, atau `TGWITNESS_TOKEN` |
| ID API + hash | Tiada apa-apa sendirian; mengenal pasti aplikasi | Pasangan terbina dalam, tetapan import, atau aplikasi anda sendiri di my.telegram.org |
| Pengesahan akaun | Akaun Telegram | Dicipta melalui log masuk telefon/QR atau dibawa masuk sebagai sesi |

Jika Telegram perlu diakses melalui proksi, aturlah terlebih dahulu di bawah **Alat lain → Akaun → Tetapan → Tetapan sambungan → Ubah laluan sambungan**.

## Nombor telefon

1. Buka **Lebih banyak alat → Akaun**, tab **Telefon**, dan masukkan nombor dalam format antarabangsa, contohnya `+44 7700 900123`. Ruang dan garisan penghubung akan dikeluarkan secara automatik.
2. Tekan **Teruskan**. ID API + Hash boleh dibiarkan kosong.
3. Masukkan kod yang dihantar oleh Telegram, biasanya ke aplikasi Telegram; Telegram menentukan sama ada untuk menghantar SMS.
4. Jika akaun mempunyai pengesahan dua langkah, masukkan kata laluan itu. Ia bukan token panel dan bukan kod akses peranti.
5. Semak ID akaun yang dipaparkan selepas log masuk, kemudian pilih sumber.

Kod log masuk dan kata laluan 2FA tidak pernah ditulis ke cakera.

## Kod QR

Gunakan ini apabila akaun sudah log masuk pada telefon atau komputer lain.

1. Tab **Kod QR** → **Tunjukkan Kod QR**. ID API + Hash boleh dibiarkan kosong.
2. Pada peranti yang telah log masuk: **Tetapan → Peranti → Pautkan Peranti Desktop**, imbas kod dan sahkan.
3. Masukkan kata laluan 2FA dalam TgWitness jika Telegram memintanya.

Imej QR dijana secara tempatan. Kod akan tamat tempoh; tekan **'Jana Kod QR lain'** untuk mencuba semula. Mengunci panel, menukar ruang kerja atau memulakan log masuk lain akan membatalkan kod yang sedang menunggu.

## Kunci Auth + ID DC

Kunci Auth ialah kebenaran mentah 256 bait di sebalik setiap sesi Telegram, ditulis sebagai **512 aksara heksadesimal**, bersama nombor pusat data **DC 1–5**.

1. Tab **Auth kunci**. Tampal keseluruhan kunci; kunci yang dipendekkan yang mengandungi `…` tidak akan berfungsi.
2. Pilih ID DC yang disediakan bersama kunci.
3. Secara pilihan, masukkan **ID Pengguna**. TgWitness kemudiannya menolak sambungan jika Telegram melaporkan akaun yang berbeza.
4. Tekan **akaun Connect**.

Kunci Auth (512 aksara) bukan hash API (32 aksara). Kunci yang sama juga boleh diimport sebagai JSON, lihat [JSON Akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#account-json).

## Fail akaun

Buka **Tambah akaun → Fail** dan pilih sehingga **empat fail daripada satu akaun**, jumlahnya **8 MiB**, tekan **Semak fail**, kemudian **Sambungkan akaun**. Memilih fail atau menampal teks sesi tidak menghantar apa-apa; **Semak fail** menghantarnya ke pelayan TgWitness anda, yang membacanya tanpa log masuk dan memaparkan sesi yang ditemuinya.

Borang **Fail**, **Kunci Auth** dan import pukal memaparkan amaran sesi selari sebelum menyambung. Secara lalai, kebenaran yang diimport akan digunakan semula. Biarkan klien asal tertutup selagi kuncinya digunakan di sini. **Fail** dan **Kunci Auth** juga menawarkan pilihan untuk **Mewujudkan kebenaran bebas**, seperti yang diterangkan di bawah. Import pukal masih menggunakan mod langsung. Log masuk telefon dan QR interaktif mewujudkan kebenaran berasingan. Heading amaran kekal kelihatan dalam borang import; penjelasan penuh akan dibuka secara automatik apabila fail atau rentetan kunci/sesi disediakan. Ia boleh dilipat selepas dibaca, supaya pemilih fail dan kawalan sambungan kekal boleh digunakan pada telefon.

[Pemasangan yang disahkan](https://phishdestroy.io/tgwitness/ms/docs/reference/high-assurance/) (Phala Cloud, Intel TDX) tidak mengumpul pada kunci yang diimport. Di sana, **Fail** dan **kunci Auth** hanya berhubung apabila**kebenaran bebas** dipilih; import pukal ditolak. Log masuk telefon dan QR berfungsi seperti biasa.

- Fail diubah **dalam memori** pada pelayan TgWitness anda. Muatan tidak disimpan, fail ZIP tidak diekstrak ke cakera dan tiada perkhidmatan luaran dihubungi.
- Sesi yang terhasil kemudian disemak dengan Telegram. Jika fail menyatakan ID pengguna, ia mesti sepadan dengan akaun yang dilaporkan oleh Telegram.
- Fail yang menerangkan akaun berbeza atau kelayakan API berbeza ditolak daripada memilih satu.
- **Kod laluan atau teks sesi** memegang medan kod laluan tempatan TData, satu kotak untuk menampal StringSession dan **Membaca fail tanpa mendaftar masuk** (mengisi borang tanpa berhubung dengan Telegram). Menampal StringSession akan memadam fail yang dipilih, dan memilih fail akan memadam teks yang ditampal, jadi pemeriksaan dan sambungan akan menggunakan pilihan terkini. Selepas menukar kod laluan, tekan **Semak fail** sekali lagi.

### Buat kebenaran bebas

Pilih **'Buat kebenaran bebas** sebelum menyambungkan fail yang diimport atau Kunci Auth'. TgWitness menyambungkan penderma yang diimport seketika, menggunakannya untuk meluluskan token log masuk QR klien baru, dan memutuskan sambungan penderma itu serta-merta selepas kelulusan. Klien baru mempunyai kunci kebenaran sendiri dan profil Desktop yang dipilih secara berasingan. Butiran API dan profil peranti yang disediakan oleh penderma hanya digunakan untuk sambungan penderma tersebut. Tiada kebenaran sedia ada yang akan dilog keluar atau dibatalkan.

**Tutup sepenuhnya klien asal penderma semasa langkah ini.** Sambungan awal masih menggunakan kunci salinan, jadi mod ini tidak dapat menghapuskan risiko penggunaan selari awal tersebut. Setelah kebenaran baharu disambungkan, pemilik boleh membuka semula klien asal dan menggunakan kedua-duanya pada masa yang sama. Log masuk **kod QR** interaktif membolehkan klien asal meluluskan log masuk tanpa menyalin atau menyambungkan kuncinya di sini.

**Jangan log keluar atau tamatkan sesi penderma.** Apabila sesi yang meluluskan log masuk QR tamat, Telegram juga menamatkan sesi yang diluluskannya; dalam pemeriksaan langsung, kebenaran baharu itu berhenti dalam masa satu saat selepas penderma log keluar. Import merekodkan sesi penderma (`session_origin.approved_by`: peranti, ID API dan masa penciptaan). Senarai sesi menandakannya, **Akhiri sesi** menolaknya, dan **Akhiri semua sesi lain** serta **Jadikan ini satu-satunya sesi** membiarkannya terus log masuk.

Jika Telegram meminta 2FA, mod ini menggunakan `twoFA` daripada JSON yang dipilih apabila tersedia, atau meminta kata laluan. Kata laluan yang diimport yang ditolak akan kembali ke borang kata laluan. Kata laluan tidak disimpan. Kunci calon disimpan secara disulit dalam `independent_login.enc`, termasuk perubahan semasa pemindahan pusat data. Selepas gangguan, pilih penderma yang sama dan pilihan ini untuk meneruskan calon yang disimpan. Penderma disemak dengan `help.getAppConfig` sebelum kelulusan; akaun beku berhenti di situ. Jika Telegram menolak penderma sebelum meluluskan log masuk, kunci calon yang tidak diluluskan dibuang dan pengimportan boleh dimulakan semula. Penderma lain menggantikan calon yang disimpan hanya apabila Telegram melaporkan bahawa calon itu belum log masuk; calon yang sudah log masuk atau menunggu kata laluan 2FA akan disimpan. Ruang kerja kekal ditempah untuk akaun itu; kegagalan penyempurnaan tidak memadam ruang kerja baru. Kekalkan direktori datanya dan kunci peti besi. Kredensial akhir dan `account.authorized` rekod jurnal merangkumi kaedah import, format input dan ID API penderma, tanpa kunci atau kata laluan penderma.

Pada 5 November 2026, sebuah akaun khusus lulus pemeriksaan langsung dengan penderma Telethon, Pyrogram dan TData: penyempurnaan 2FA, kunci kebenaran baharu yang berasingan, capaian serentak oleh penderma dan klien baharu, dan membaca saluran awam. Kes Telethon juga memulihkan calon yang disimpan selepas gangguan pada langkah kata laluan. Setiap kebenaran baharu melengkapkan enam permintaan inisialisasi pasca-log masuk, dan jurnal yang disahkannya disemak. Sesi asal kekal boleh digunakan dalam semua empat format yang disediakan.

[Pangkalan data ralat RPC](https://core.telegram.org/api/errors.json) Telegram mengaitkan `FRESH_CHANGE_ADMINS_FORBIDDEN` dengan pertukaran pentadbir, `FRESH_CHANGE_PHONE_FORBIDDEN` dengan pertukaran nombor telefon, dan `FRESH_RESET_AUTHORISATION_FORBIDDEN` dengan membatalkan sesi lain, mengubah jangka hayat mereka atau mendaftarkan kunci laluan. `SESSION_TOO_FRESH_*` dan `PASSWORD_TOO_FRESH_*` berkaitan pemindahan pemilikan dan pengeluaran hasil atau hadiah. Ini bukan operasi kutipan; log masuk baru tidak bermakna larangan membaca menyeluruh selama 24 jam. Eksport boleh memulangkan `TAKEOUT_INIT_DELAY_*` secara berasingan. TgWitness mengekalkan jeda yang diminta oleh pelayan dan tidak mencuba semula penerimaan token secara automatik atau membatalkan sesi untuk mengatasi sekatan.

**Alat lebih → Akaun → Keselamatan akaun → Sesi akaun ini → Akhiri semua sesi lain** memanggil `auth.resetAuthorizations` pada permintaan operator dan merekodkan `account.all_other_sessions_terminated` dengan kiraan sesi sebelum dan selepas. Telegram menerimanya daripada sesi yang telah log masuk selama 24 jam. Apabila ruang kerja ini log masuk melalui QR daripada sesi yang diimport, sesi yang meluluskannya kekal log masuk: TgWitness menamatkan sesi-sesi lain satu persatu dengan `account.resetAuthorization` dan merekodkan `kept_approving_session`. **Jadikan ini satu-satunya sesi**, kemudian hentikannya dengan sebab itu dan tidak menukar kata laluan.

**Menjadikan ini satu-satunya sesi** melakukan perkara yang sama untuk kunci yang dibuat dengan menandatangani log masuk dari ruang kerja ini, kemudian mengaktifkan kata laluan dua langkah jika akaun tidak mempunyai satu. Panel memaparkan kata laluan itu sekali; TgWitness menyimpannya dalam peti besi ruang kerja hanya sehingga masa itu. Jurnal merekod `session.exclusive_from`. Jika Telegram kemudian menyenaraikan sesi lain, jurnal merekodkan `session.exclusive_ended` dan panel memaparkan amaran. Pengesah mencetak kedua-duanya.

**Jadikan ini satu-satunya sesi apabila Telegram membenarkannya adalah** tindakan yang sama pada pemasa. Pilihan itu muncul di bawah **Sesi akaun ini** untuk kunci yang dibuat dalam ruang kerja ini dan direkodkan sebagai `session.exclusive_automatic`. Semasa memerhati, pengumpul memeriksa setiap lima minit sama ada 24 jam telah berlalu sejak rekod `account.authorized` bagi kunci itu — Telegram menjawab `FRESH_RESET_AUTHORISATION_FORBIDDEN` sebelum itu — dan kemudian menjalankan operasi yang sama sekali. Kejayaan direkodkan sebagai `session.exclusive_from`, seperti butang manual. Penolakan direkod sekali sebagai `session.exclusive_postponed` dengan sebab daripada Telegram, dan pengumpul mencuba semula dengan kelewatan yang semakin meningkat sehingga enam jam. Mod baca sahaja tidak memberi kesan di sini: menamatkan sesi adalah tindakan keselamatan akaun, bukan tindakan sembang.

Kata laluan dua langkah yang dijana oleh pelaksanaan automatik disimpan dalam peti besi ruang kerja, disulitkan dengan kunci ruang kerja, sebelum Telegram menetapkannya. Panel memuatkannya sekali daripada `POST /api/account/sessions/only/password`, yang memadamnya, dan memaparkannya dalam tetingkap dialog yang sama seperti aliran manual apabila anda membuka **Sesi akaun ini**. Halaman sambungan mencatat bahawa kata laluan sedang menunggu. Ia tidak pernah dimasukkan ke dalam jurnal dan kekal selepas permulaan semula sehingga ia dipaparkan.

Sesi baharu juga dilaporkan semasa pemerhatian: apabila senarai sesi Telegram menambah satu entri, rekod `account.sessions` menamakannya di bawah `added` dan panel memaparkan amaran dengan peranti, aplikasi dan negara daripada snapshot tersebut.

### Pemeriksa saksi

**Alat lain → Akaun → Keselamatan akaun → Siasatan saksi** memeriksa sama ada klien lain menerima kemas kini akaun ini. Tambah ruang kerja kedua yang disahkan dengan akaun Telegram berbeza dan kunci sesi tersendiri, buat kumpulan peribadi dengan kedua-dua akaun, kemudian pilih kumpulan itu sebagai **Chat siasatan** dan ruang kerja kedua sebagai **Ruang kerja saksi** dan hidupkan siasatan. Kedua-dua akaun perlu mematikan **Baca sahaja**, dan ruang kerja saksi mesti berada dalam mod memerhati.

Semasa memerhati, ruang kerja ini menghantar `probe:<n>:<token>` ke dalam kumpulan setiap 60–120 saat dan merekodkan `probe.sent`. Saksi menjawab `ack:<n>:<token>` dan merekodkan `probe.seen` dan `probe.ack_sent`. Satu ack yang sampai ke sesi ini sebagai kemas kini langsung dalam masa 20 saat direkodkan sebagai `probe.acked`. Jika tidak, ruang kerja ini membaca sejarah terkini kumpulan. Satu ack yang ditemui di sana tetapi tidak disampaikan secara langsung direkodkan sebagai `coverage.gap` dengan sebab `probe_ack_missed_live`: panel membangkitkan amaran dan menandakan pengambilan peristiwa sebagai gagal sehingga satu ack kemudian tiba secara langsung (`connection.restored`, sebab `probe_ack_live`). Tiada ack direkodkan sebagai `probe.unanswered`; gangguan sambungan semasa menunggu atau sejarah yang tidak dapat dibaca direkodkan sebagai `probe.inconclusive`. Mod hanya-baca, sekatan Telegram dan jeda FloodWait direkodkan sekali sebagai `probe.skipped`.

### Telethon `.session`

|  |  |
| --- | --- |
| Apa itu | Pangkalan data SQLite yang dicipta oleh alat berasaskan Telethon, contohnya `my_account.session` |
| Diiktiraf oleh | Jadual `sessions` (dengan `dc_id`, `server_address`, `port`, `auth_key`) dan `version` = 7 atau 8 |
| Keperluan | Satu baris sesi bertauliah tepat; pangkalan data tertutup dan lengkap |

Tutup program yang mencipta fail itu terlebih dahulu. Jika `my_account.session-journal` atau `my_account.session-wal` wujud di sebelahnya, pangkalan data belum dimuktamadkan: buka dan tutup klien asal dengan sempurna. Memadam fail sidecar tersebut boleh meninggalkan salinan yang rosak.

### Pyrogram `.session`

|  |  |
| --- | --- |
| Apa itu | Pangkalan data SQLite yang dihasilkan oleh alat berasaskan Pyrogram |
| Diiktiraf oleh | Jadual `sessions` dengan `dc_id`, `auth_key`, `test_mode`, `user_id`, `is_bot`; `version` = 2 atau 3 |
| Keperluan | Satu sesi **pengguna** bertauliah pada rangkaian pengeluaran. Sesi bot dan test-DC ditolak |

ID pengguna yang disimpan disemak menentang Telegram semasa log masuk.

### Pasangan sesi + JSON

Akaun sering diedarkan sebagai dua fail dengan nama yang sama, contohnya `447700900123.session` dan `447700900123.json`. Pilih **kedua-duanya** sekaligus.

- Daripada JSON, TgWitness menggunakan `app_id`/`api_id` dan `app_hash`/`api_hash`, jadi anda biasanya tidak perlu menaip kelayakan API.
- Profil sambungan 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` pilihan (saat dari UTC, -43200 hingga 50400). Medan yang dibekalkan diutamakan berbanding lalai yang dijana dan bahasa panel/pelayar. Alias yang bertembung ditolak. Profil yang diselesaikan disimpan dalam kredensial ruang kerja yang disulitkan dan digunakan semula selepas but semula, termasuk versi aplnya.
- `phone`, tetapan proksi dan token peranti **diabaikan**. `twoFA` hanya boleh dibaca apabila **Buat kebenaran bebas** dipilih; import terus mengabaikannya.
- JSON tanpa medan kebenaran yang disokong hanyalah metadata. Tambah fail sesi atau teruskan dengan log masuk telefon atau QR. JSON yang mengandungi sesi yang disokong atau Kunci Auth boleh memberi kebenaran sendiri; lihat [JSON Akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#account-json).

### Telegram Desktop (TData)

TData ialah folder `tdata` aplikasi Telegram Desktop (aplikasi rentas platform dari desktop.telegram.org).

| Sistem | Lokasi lalai `tdata` |
| --- | --- |
| Windows | `%APPDATA%\Telegram Desktop\tdata` (Telegram mudah alih: seterusnya `Telegram.exe`) |
| Linux | `~/.local/share/TelegramDesktop/tdata` |
| macOS | `~/Library/Application Support/Telegram Desktop/tdata` |

Untuk mengimportnya:

> **Amaran sesi selari.** Import TData terus menggunakan kunci kebenaran Telegram Desktop. Jangan gunakan kunci itu dalam Desktop dan TgWitness serentak. Telegram boleh membatalkan kebenaran dengan `AUTH_KEY_DUPLICATED`, menjadikan kedua-dua salinan tidak dapat digunakan sehingga log masuk semula.
>
>
>
> Tutup Desktop sepenuhnya, termasuk proses dulanginya, dan biarkan salinan itu tertutup semasa TgWitness menggunakan sesi yang diimport. **Tutup, jangan log keluar atau batalkan sesi:** pencabutan juga membatalkan salinan yang diimport. Jika anda perlu kedua-dua klien berjalan, pilih **Buat kebenaran bebas** dan biarkan Desktop tertutup sehingga log masuk baru berjaya, atau log masuk ke TgWitness melalui telefon atau QR. Akaun khusus disyorkan, tetapi tidak menjadikan kunci klon selamat untuk digunakan secara serentak.
>
>
>
> Ini juga terpakai kepada fail `.session` yang diimport, teks StringSession dan HEX Auth Key. Klien lain dengan kebenaran yang dicipta secara bebas boleh kekal log masuk. Rujuk [dokumentasi AUTH_KEY_DUPLICATED Telegram](https://core.telegram.org/api/errors#406-not-acceptable).

1. Batalkan sepenuhnya Telegram Desktop.
2. Buat fail ZIP yang mengandungi **hanya** kedua-dua item ini daripada `tdata`:

   - `key_datas`
   - pengakhiran fail 16 aksara yang berakhir dengan `s` di sebelahnya, biasanya `D877F783D5D3EF8Cs`

   Memampatkan keseluruhan folder dengan cache medianya biasanya melebihi had (512 entri, 32 MiB selepas dipadamkan). 3. Pilih fail ZIP dalam **Fail**. Jika Telegram Desktop mempunyai **kod akses tempatan**, masukkan kod tersebut di bawah **Kod Akses atau teks sesi** terlebih dahulu. Ini bukan kata laluan 2FA.

Disokong: satu akaun setiap arkib, storan moden `key_datas`/`key_data0`/`key_data1`, kod akses tempatan. Tidak disokong: folder dengan beberapa akaun yang log masuk, susun atur Desktop lama, fail ZIP yang dilindungi kata laluan, dan aplikasi asli macOS berasingan "Telegram for macOS".

### Telethon StringSession

Satu baris teks, biasanya bermula dengan `1` dan berketinggian kira-kira 350 aksara. Muatkan ia sebagai fail `.txt` atau `.tgwitness-session` (maksimum 4 KiB), atau tampal di bawah **Passcode atau teks sesi**. Hanya rentetan Telethon diterima; rentetan Pyrogram dan TDLib menggunakan format berbeza.

### KunciAuth dan DC dalam satu baris

Senarai akaun sering mengandungi kebenaran mentah sebagai `<512 hexadecimal characters>:<DC id>`, contohnya `a1b2…ef:5`. Tampal baris itu di bawah **Kod Laluan atau teks sesi**, muatkannya sebagai fail teks, atau masukkan ke dalam medan `session` dalam [JSON Akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#account-json). TgWitness memetakan DC 1–5 kepada alamat pengeluaran yang sama seperti import JSON `auth_key` + `dc_id` dan melaporkan format sebagai **Kunci Auth HEX dan DC**. Sebarang nombor DC atau panjang kunci lain akan ditolak.

### JSON Akaun

Satu objek JSON, maksimum **64 KiB**, dalam fail yang berakhir dengan **`.json`**.

| Medan (nama samaran) | Maksud |
| --- | --- |
| `api_id` (`app_id`) | ID Aplikasi, satu nombor positif |
| `api_hash` (`app_hash`) | Hash aplikasi, 32 aksara heksadesimal |
| `string_session` (`session_string`, `session_str`; `session` lama) | Teks Telethon StringSession, atau `<512 hexadecimal characters>:<DC id>`, bukan nama fail |
| `auth_key` (`auth_key_hex`) + `dc_id` | Lengkapkan Kunci Auth 512-karakter dan DC 1–5 |
| `user_id` (`id`) | Pilihan; disemak menentang Telegram sebelum kebenaran disimpan |
| `device_model` (`device`) | Deskripsi peranti sambungan |
| `system_version` (`sdk`) | Versi OS Sambungan |
| `app_version` | Versi aplikasi dihantar ke Telegram |
| `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | Bahasa klien, bahasa sistem dan pek bahasa klien; pek `lang_pack` kosong dibenarkan |
| `tz_offset` | Peralihan UTC pilihan dalam saat, dihantar dalam `initConnection.params`; rentetan integer atau integer perpuluhan |

Jika kedua-dua nama samaran dan nama utama wujud, ia mesti sepadan. Medan sesi Telethon eksplisit diutamakan berbanding blok `session` generik dalam format lain. Jika kedua-duanya mengandungi sesi Telethon yang boleh dikenali, ia mesti menerangkan kebenaran yang sama. Tanpa medan eksplisit, `session` mesti menjadi Telethon StringSession yang sah atau kunci auth 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 kelayakan API; log masuk melalui telefon atau QR, atau tambahkan fail sesi. Senarai pukal (susunan JSON akaun) tidak diterima.

## Kenal pasti apa yang anda ada

| Anda lihat | Ia | Gunakan |
| --- | --- | --- |
| `*.session`; membukanya dalam penyunting teks memaparkan `SQLite format 3` di bahagian atas | Telethon atau Pyrogram SQLite | **Fail** (dikesan secara automatik) |
| Satu folder `tdata` yang mengandungi `key_datas` | Telegram Desktop TData | ZIP dua fail, kemudian **Fail** |
| Satu baris teks bermula dengan `1`, kira-kira 350 aksara | Telethon StringSession | **Fail** |
| Satu baris teks `512 characters 0-9a-f`, kemudian `:` dan digit 1–5 | Kunci Auth dan DC | **Fail**, kotak **Kod Laluan atau teks sesi** |
| `*.json` dengan `app_id`/`app_hash` | Metadata rakan | **Fail-fail**, bersama sesi |
| `*.json` dengan `auth_key` atau `string_session` | JSON Akaun | **Fail** |
| 512 aksara `0-9a-f` | Kunci Auth | **KunciAuth** |
| 32 aksara `0-9a-f` | Hash API | **ID API + Hash** |
| `td.binlog` atau `db.sqlite` daripada aplikasi TDLib | Simpanan TDLib | Tidak disokong |
| `123456789:AA…` | Token bot | Tidak disokong |

## Format yang tidak disokong

| Format | Alternatif |
| --- | --- |
| Penyimpanan TDLib (`td.binlog`) dan eksport TDLib | Log masuk melalui telefon atau QR |
| **Rentetan** sesi Pyrogram | Gunakan fail Pyrogram `.session`, atau telefon/QR |
| TData dengan beberapa akaun yang log masuk | Log keluar akaun lain dalam Telegram Desktop, atau gunakan fail sesi setiap akaun |
| Token bot | Tidak disokong: TgWitness memerhati sebagai akaun pengguna |
| Senarai CSV/JSON bagi banyak akaun | Import fail sesi yang disokong melalui **Akaun → Import akaun**, atau log masuk menggunakan telefon/QR dalam ruang kerja yang berasingan |
| Sesi Test-DC atau bot | Gunakan akaun pengguna produksi |

## Beberapa akaun

Tekan **+** di sebelah pemilih akaun, atau buka **Alat lain → Akaun → Tetapan → Tetapan sambungan → Ruang kerja**, masukkan label dan log masuk.

- Sebarang bilangan ruang kerja, termasuk ruang utama. Setiap satu mempunyai sesi, laluan proksi, sumber, dasar tangkapan, jurnal, kunci tandatangan, titik pemeriksaan dan eksport masing-masing.
- Menukar ruang kerja yang dipaparkan tidak menangguhkan ruang kerja yang lain.
- Jurnal kekal terikat kepada akaun yang menciptanya. Log masuk sebagai akaun lain memerlukan ruang kerja lain, dan satu akaun tidak boleh ditugaskan kepada dua ruang kerja.
- Token panel utama mengawal semua ruang kerja. [Akses yang dikeluarkan](https://phishdestroy.io/tgwitness/ms/docs/reference/access/) boleh mengehadkan orang lain kepada akaun dan sembang terpilih, dengan kebenaran berasingan dan had sesi.
- **Akaun** menamakan semula ruang kerja dan memadam ruang kerja yang ditambah, termasuk sesi, jurnal, sumber dan kunci tandatangan. Ruang kerja utama tidak boleh dipadam dari panel.

### Import pukal dan kumpulan akaun

Gunakan **Akaun → Import akaun** untuk menambah beberapa akaun, padankan fail mengikut nama asas dan lihat setiap keputusan log masuk. Setiap akaun mendapat ruang kerja sendiri.

Kumpulan mengekalkan akaun berkaitan bersama tanpa menggabungkan sesi, kunci atau bukti mereka. **Membuka kumpulan** pada **Akaun** membawa ke halaman kumpulan itu di `/groups/<id>`:

- **Akaun:** laluan sambungan setiap ahli, pemerhatian dan mesej terakhir, dengan Mulakan**semua** dan **Jeda semua**.
- **Perlu perhatian:** akaun yang telah log keluar, tidak tersedia atau mempunyai masalah sambungan, kemasukan, sumber atau media; setiap nama membawa ke kadnya.
- **Perbualan beberapa akaun lihat:** sumber yang dikongsi, akaun yang memerhatikannya dan gangguan dalam tempoh pemerhatian ruang kerja tersedia (sehingga tujuh hari). **Eksport dengan N akaun** membahagikan eksport saluran atau superkumpulan di antara mereka dan menandatangani satu arkib.
- **Eksport kumpulan:** satu ZIP dengan eksport bermassa tandatangan setiap akaun di bawah `accounts/` dan `manifest.json` menyenaraikan SHA-256 dan cap jari kunci mereka, disahkan oleh ruang kerja utama dalam `manifest.signature.json`. Sahkan setiap arkib akaun secara berasingan dengan `python -m tgwitness.verify` dan cap jari yang dipercayai bagi akaun tersebut.

Ahli berkongsi tetapan kumpulan; akaun boleh mengekalkan nilai tersendiri. Lihat [tetapan yang dikongsi](https://phishdestroy.io/tgwitness/ms/docs/reference/settings/#account-groups), [panduan import dan kumpulan](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) dan [papan pemuka kolam MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources).

## Log keluar

**Alat lain → Akaun → Log keluar daripada Telegram** (dengan pemerhatian dihentikan) meminta Telegram menamatkan sesi, jadi ia juga akan hilang daripada **Tetapan → Peranti** akaun, dan membuang sesi daripada peti keselamatan ruang kerja. Jurnal, sumber, tetapan dan kunci tandatangan kekal, dan jurnal merekodkan log keluar tersebut. Ruang kerja masih milik akaunnya: hanya akaun itu sahaja yang boleh menyambung semula kepadanya. Jika Telegram tidak memberi respons, sesi masih akan dialihkan di sini dan panel akan memberitahu demikian; tamatkan sesi itu di Telegram di bawah **Tetapan → Peranti**.

## Apabila Telegram menamatkan sesi

Jika Telegram menyekat, membekukan atau keluar daripada akaun, atau menamatkan sesi daripada peranti lain, jurnal merekodkan punca, ralat Telegram, laluan dan pusat data. Kesihatan akaun menunjukkan **Muat turun laporan kehilangan akaun**: fail JSON yang disahkan dengan rekod jurnal bagi 24 jam sebelum kehilangan, iaitu sambungan, laluan, sesi, notis akaun dan jurang liputan, setiap satu dengan suai huraian jurnal dan tandatangan. Semak ia dengan `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`; eksport bukti mengandungi rantaian hash lengkap. Akaun yang dibekukan juga dikesan apabila ia menyambung dan semasa pemantauan, dan tindakan menghantar serta menyertainya akan dilumpuhkan.

## Menjaga keselamatan fail akaun

- Layan setiap `.session`, TData ZIP, StringSession, Auth Key dan JSON akaun seperti kata laluan. TgWitness menyimpan kebenaran yang diimport dalam peti keselamatan yang disulitkan; anda boleh memadam fail asal selepas itu.
- Jangan jalankan kebenaran yang sama dalam dua program sekaligus. Telegram mungkin membatalkan kebenaran tersebut (`AUTH_KEY_DUPLICATED`), dan kedua-dua salinan akan berhenti berfungsi.
- Sesi yang telah tamat tempoh atau dibatalkan tidak boleh dihidupkan semula melalui penukaran. Log masuk semula.

## Pemecahan masalah

| Mesej atau simptom | Apa yang perlu dilakukan |
| --- | --- |
| *Tidak dapat membaca sesi ini. Tutup klien asalnya…* | Fail SQLite dibuka atau belum selesai (sidecar `-journal`/`-wal`). Tutup program asal dengan kemas dan salin semula fail tersebut. |
| *Skema Telethon SQLite yang disokong: 7 dan 8* / *Pyrogram … 2 dan 3* | Satu versi perpustakaan yang sangat lama atau tidak diketahui telah mencipta fail tersebut. Log masuk melalui telefon/QR sebaliknya. |
| *Hanya sesi pengguna produksi yang dibenarkan disokong* | Fail Pyrogram ini milik bot atau rangkaian ujian. |
| *Arkib TData melebihi 512 entri atau 32 MiB* | ZIP hanya `key_datas` dan `D877F783D5D3EF8Cs`, bukan keseluruhan folder. |
| *Tidak dapat menyahsulit TData. Semak kod laluan tempatan Desktop.* | Masukkan kod laluan tempatan Telegram Desktop di bawah **Passcode atau teks sesi**. |
| *Import satu akaun TData pada satu masa* | Telegram Desktop mempunyai beberapa akaun; lihat [format yang tidak disokong](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#unsupported-formats). |
| *Fail terpilih menerangkan akaun berbeza atau kelayakan API* | Pilih fail daripada satu akaun sahaja. |
| *JSON tidak mengandungi kelayakan API atau kebenaran yang disokong* | Semak nama medan dalam [JSON Akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#account-json). |
| *Hanya metadata API* | JSON tidak mempunyai sesi. Tambahkan fail `.session` atau gunakan telefon/QR. |
| *Kunci Auth HEX mesti mengandungi semua 512 aksara heksadesimal* | Kunci dipotong atau mengandungi `…`. |
| ID akaun tidak sepadan dengan akaun yang diimport | ID pengguna fail itu berbeza daripada yang dilaporkan oleh Telegram; fail itu adalah untuk akaun lain. |
| Akaun ini sudah dimiliki oleh ruang kerja lain | Buka ruang kerja itu bukannya menambah akaun itu dua kali. |
| Berhubung, tetapi kumpulan peribadi hilang daripada senarai sembang dalam **Alat tambahan → Sumber** | Semak keahlian. Pemilih memeriksa 1,000 dialog pertama; naikkan had di bawah **Alat Lanjutan → Parameter**. |
| Sambungan proksi gagal | Periksa laluan dan mod IP. MTProxy automatik mencuba entri lain yang berfungsi. Tunggu menyembunyikan alamat; Direct sebagai pilihan terakhir boleh menyambung terus selepas kelewatan yang ditetapkan. Lihat [mod penjejakan](https://phishdestroy.io/tgwitness/ms/docs/reference/connection/#ip-modes). |

Lihat juga: [sambungan dan keselamatan](https://phishdestroy.io/tgwitness/ms/docs/reference/connection/) untuk proksi dan penyulitan, dan [bagaimana pengumpulan berfungsi](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/) untuk apa yang dirakam selepas log masuk.
