# Telegram · खाते और सत्र प्रारूप

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

फ़ोन, QR कोड या auth कुंजी से साइन इन करें, Telethon, Pyrogram या Telegram Desktop सत्र आयात करें, और कई खाते चलाएँ।

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

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

फ़ोन, QR कोड या auth कुंजी से साइन इन करें, Telethon, Pyrogram या Telegram Desktop सत्र आयात करें, और कई खाते चलाएँ।

[टीजीविटनेस](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [दस्तावेज़ीकरण](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [शुरुआत करना](https://phishdestroy.io/tgwitness/hi/docs/reference/quickstart/)

![शुरुआत करना](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

TgWitness, MTProto का उपयोग करते हुए, एक टेलीथॉन खाते से **टेलीग्राम उपयोगकर्ता खाते** (बॉट नहीं) के रूप में साइन इन करता है। प्रत्येक खाता अपने स्वयं के **कार्यक्षेत्र** (API और कमांड-लाइन टूल में जिसे *वर्कस्पेस* कहा जाता है) में रहता है, जिसमें उसका अपना सत्र, स्रोत, जर्नल और हस्ताक्षर कुंजी होती है।

सेशन फ़ाइलें, सेशन स्ट्रिंग्स और ऑथ कीज़ **खाता प्राधिकरण** हैं: जिसके पास इनमें से कोई भी हो, वह उस खाते के रूप में कार्य कर सकता है। इनमें संदेश इतिहास शामिल नहीं होता।

> [!चेतावनी] **समर्पित खातों का उपयोग करें।** टेलीग्राम उन अनुरोधों की मात्रा के लिए खातों को प्रतिबंधित करता है और स्थायी रूप से प्रतिबंधित कर सकता है जिन्हें वह अत्यधिक मानता है, चाहे क्लाइंट या उद्देश्य कोई भी हो, और उन सीमाओं को केवल आंशिक रूप से ही प्रलेखित करता है। व्यक्तिगत या अन्यथा मूल्यवान खातों के बजाय अवलोकन के लिए तैयार किए गए खातों को कनेक्ट करें, और एक समर्पित खाते पर एक API ID / API हैश बनाएँ।

- [एक नज़र में](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#at-a-glance)
- [शुरू करने से पहले: एपीआई आईडी और एपीआई हैश](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#before-you-start-api-id-and-api-hash)
- [फ़ोन नंबर](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#phone-number) · [क्यूआर कोड](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#qr-code) · [ऑथ कुंजी + डीसी आईडी](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#auth-key--dc-id)
- [खाता फ़ाइलें](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#account-files): [टेलीथॉन .सेशन](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#telethon-session) · [पायरोग्राम .सेशन](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#pyrogram-session) · [सत्र + JSON जोड़ी](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#session--json-pair) · [टीडेटा](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#telegram-desktop-tdata) · [स्ट्रिंगसेशन](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#telethon-stringsession) · [ऑथ कुंजी और डीसी एक ही पंक्ति में](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [खाता JSON](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#account-json)
- [पहचानें कि आपके पास क्या है](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#identify-what-you-have) · [असमर्थित प्रारूप](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#unsupported-formats)
- [कई खाते](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#multiple-accounts) · [खाता फ़ाइलों को सुरक्षित रखना](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#keeping-account-files-safe) · [समस्या निवारण](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#troubleshooting)

## एक नज़र में

| आपके पास क्या है | खाता जोड़ें टैब | आपको इनकी भी आवश्यकता होगी |
| --- | --- | --- |
| फ़ोन नंबर और उसके लॉगिन कोड्स तक पहुँच | फ़ोन | यदि सक्षम हो तो 2FA पासवर्ड |
| दूसरे डिवाइस पर टेलीग्राम खुला है | **क्यूआर कोड** | यदि सक्षम हो तो 2FA पासवर्ड |
| `.session` फ़ाइल (टेलीथॉन या पायरोग्राम) | **फ़ाइलें** | ऐप सेटिंग्स के लिए वैकल्पिक साथी JSON |
| `.session` + `.json` समान नाम के साथ | **फ़ाइलें** (दोनों चुनें) | आमतौर पर और कुछ नहीं |
| एक टेलीग्राम डेस्कटॉप `tdata` फ़ोल्डर | **फ़ाइलें** (ZIP के रूप में) | यदि डेस्कटॉप स्थानीय पासकोड सेट किया गया हो तो वह |
| एक टेलीथॉन स्ट्रिंगसेशन (टेक्स्ट, `.txt`, `.tgwitness-session`) | **फ़ाइलें** | अलग API जोड़ी की आवश्यकता नहीं |
| एक auth कुंजी और DC एक ही पंक्ति में, `<512 hex>:<1–5>` | **फ़ाइलें** (पेस्ट या टेक्स्ट फ़ाइल) | अलग API जोड़ी की आवश्यकता नहीं |
| `.json`, एक सत्र या ऑथ कुंजी के साथ | **फ़ाइलें** | अलग API जोड़ी की आवश्यकता नहीं |
| एक ऑथ की (512 हेक्स वर्ण) और उसका डीसी नंबर | **ऑथ कुंजी** | वैकल्पिक उपयोगकर्ता आईडी |

TgWitness फ़ाइलों को उनके नाम से नहीं, बल्कि उनकी **सामग्री** से पहचानता है। किसी फ़ाइल का नाम बदलने से वह कभी भी परिवर्तित नहीं होती।

## शुरू करने से पहले: एपीआई आईडी और एपीआई हैश

आप टेलीग्राम एपीआई एप्लिकेशन बनाए बिना साइन इन कर सकते हैं। जब वर्कस्पेस में कोई जोड़ा दर्ज नहीं किया गया हो, आयातित न किया गया हो या पहले से सहेजा न गया हो, तो TgWitness अपने अंतर्निर्मित 50 सार्वजनिक एपीआई जोड़ों के पूल में से एक जोड़ा चुनता है (`tgwitness/api_pool.py`), एक नए लॉगिन के लिए टेलीग्राम डेस्कटॉप को प्राथमिकता देता है और पहले एक सहेजे गए जोड़े को रखता है; शेष उम्मीदवारों को फेरबदल किया जाता है। यदि टेलीग्राम कोई जोड़ा अस्वीकार करता है (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`), तो अगला आज़माया जाता है, प्रति साइन-इन आठ तक; अस्वीकार किए गए जोड़ों को फिर से शुरू करने तक छोड़ दिया जाता है। जिस जोड़े से साइन इन किया गया है, वह खाते के साथ सहेजा जाता है और उसके लिए फिर से उपयोग किया जाता है।

बिल्ट-इन पेयर सार्वजनिक हैं: वे टेलीग्राम क्लाइंट्स और लाइब्रेरीज़ के ओपन सोर्स कोड में प्रकाशित किए जाते हैं। एक **API ID** और **API हैश** टेलीग्राम को एप्लिकेशन की पहचान कराते हैं और खाते के डेटा तक कोई पहुँच नहीं देते हैं। साइन-इन खाते की अपनी प्राधिकरण का उपयोग करता है: एक लॉगिन कोड और 2FA पासवर्ड, या एक सत्र जिसे खाता पहले ही अधिकृत कर चुका है। प्रत्येक `observation.started` प्रत्येक रिकॉर्ड में उपयोग किए गए जोड़े का नाम होता है, इसलिए एक अंतर्निहित जोड़े को अदालत के लिए उसी तरह प्रलेखित किया जाता है जैसे आपके अपने जोड़े को किया जाता है। इसके बजाय आप my.telegram.org से अपना खुद का जोड़ा दर्ज कर सकते हैं। परियोजना के अनुभव में, एक नया व्यक्तिगत जोड़ा अधिकांश खातों को लॉग आउट कर देता है, इसलिए इसका उपयोग केवल तभी करें जब किसी मामले के लिए आपके अपने एप्लिकेशन की आवश्यकता हो: इसे एक समर्पित खाते के साथ बनाएँ और संग्रह शुरू होने से पहले इसे दर्ज करें (नीचे दिए गए चरण)।

गैर-उपस्थित कनेक्शन फ़ील्ड बंडल किए गए [opentele2 2.0.0 कैटलॉग](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735) से एक निर्धारणात्मक डिवाइस/ओएस जोड़ी का उपयोग करते हैं: डेस्कटॉप `2040`, एंड्रॉइड `6`, एंड्रॉइड X `21724`, आईओएस `10840`, मैकओएस `2834`, और वेब `2496`। एंड्रॉइड का सोर्स-बिल्ड आईडी `4` भी एंड्रॉइड कैटलॉग का उपयोग करता है, जैसा कि [Telegram Android के BuildVars](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java) में पहचाना गया है। वेब डिफ़ॉल्ट रूप से A है; एक आयातित `K` ऐप-संस्करण प्रत्यय या `macos` भाषा पैक K का चयन करता है, और संस्करण `0.7.0` वेबोग्राम का चयन करता है। अज्ञात एप्लिकेशन आईडी टेलीथॉन के होस्ट डिफ़ॉल्ट को बनाए रखती हैं। आयातित फ़ील्ड हमेशा जीत जाती हैं, जिसमें एक पुराना ऐप संस्करण और एक खाली भाषा पैक भी शामिल है। कैटलॉग कभी भी API आईडी/हैश को नहीं बदलता है। इसके संस्करण स्नैपशॉट की स्पष्ट रूप से समीक्षा की जाती है, न कि लॉगिन के दौरान प्राप्त किया जाता है। एक सहेजी गई प्रोफ़ाइल अपडेट के बाद भी स्थिर रहती है।

`account.getAuthorizations` टेलीग्राम के सहेजे गए प्राधिकरण मेटाडेटा की रिपोर्ट करता है; यह प्रत्येक नए `initConnection` की प्रतिध्वनि नहीं है। इसकी तुलना वास्तव में भेजे गए प्रोफ़ाइल से करें। एक मौजूदा प्राधिकरण को कनेक्ट करने से उसके साथी API हैश का सत्यापन नहीं होता है: `initConnection` API ID भेजता है, जबकि हैश का उपयोग लॉगिन अनुरोधों द्वारा किया जाता है।

नए फोन या QR प्राधिकरण के बाद, TgWitness कॉन्फ़िग, निकटतम DC, ऑनलाइन स्थिति, भाषाएँ (जब भाषा पैक खाली न हो), ऐप अपडेट और सेवा की शर्तों के अपडेट का अनुरोध करता है, अनुरोधों के बीच 0.3–1.5 सेकंड का अंतराल होता है। अपडेटिंग स्टेटस संक्षेप में खाते को ऑनलाइन चिह्नित करता है। यह अनुक्रम लॉगिन पूरा होने पर एक बार चलता है, इम्पोर्ट, फिर से कनेक्ट या रीस्टार्ट पर नहीं। प्राधिकरण पहले सहेजा जाता है; एक असफल अनुरोध लॉगिन को फिर से आजमाए बिना या खारिज किए बिना अनुक्रम को रोकता है। परिणाम `account.initialized` के रूप में दर्ज किए जाते हैं, प्रतिक्रिया बॉडी के बजाय त्रुटि नामों के साथ। टेलीग्राम की अपनी नीतियां खाता प्रतिबंध तय करती हैं।

`tdesktop` के लिए, एक अनुपस्थित `tz_offset` सर्वर के स्थानीय UTC ऑफ़सेट का उपयोग करता है, जिसे [opentele2 एल्गोरिथम](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) (MIT; लाइसेंस `tgwitness/client_profiles.LICENSE` में) का उपयोग करके 900 सेकंड तक राउंड किया जाता है। इसे प्रत्येक कनेक्शन पर रिफ्रेश किया जाता है ताकि डेलाइट-सेविंग परिवर्तन प्रतिबिंबित हों। एक आयातित `tz_offset` हर प्लेटफ़ॉर्म पर प्राथमिकता लेता है और शून्य सहित, बिल्कुल सटीक रखा जाता है। अन्य `initConnection.params` प्रविष्टियाँ बरकरार रखी जाती हैं। HTTP साइन-इन फ़ॉर्म फ़ाइल आयात द्वारा लौटाए गए संख्यात्मक टाइमज़ोन को स्वीकार करता है; समर्थित सीमा के बाहर के बूलियन, भिन्नात्मक और ऑफ़सेट अस्वीकार कर दिए जाते हैं।

डायरेक्ट, SOCKS5 और HTTP CONNECT रूट Telethon के `ConnectionTcpObfuscated` (ओब्सक्यूरेटेड संक्षिप्त MTProto) का उपयोग करते हैं। HTTPS CONNECT प्रॉक्सी तक TLS को बरकरार रखता है और टनल के अंदर उसी ओब्सक्यूरेटेड ट्रांसपोर्ट का उपयोग करता है। MTProxy अपने आवश्यक रैंडमाइज़्ड इंटरमीडिएट ट्रांसपोर्ट और सीक्रेट हैंडलिंग को बरकरार रखता है। रूट स्विच भी यही विकल्प लागू करते हैं। ऑब्फुस्केशन पैकेट फ्रेमिंग को बदलता है; यह टेलीग्राम से खाते या उसके क्लाइंट मेटाडेटा को छिपाता नहीं है, न ही प्रतिबंधों के प्रति प्रतिरक्षा का संकेत देता है।

एक अधिकृत क्लाइंट को कनेक्ट करने के बाद, TgWitness कॉन्फ़िग, निकटतम DC, वर्तमान प्राधिकरण, समीक्षित लेयर बेसलाइन, भाषाओं, ऐप अपडेट और टर्म्स-ऑफ़-सर्विस अपडेट की जाँच करता है। ये डायग्नोस्टिक्स प्रत्येक क्लाइंट इंस्टेंस पर एक बार, संग्रह से पहले चलते हैं, और उनके समय के साथ कनेक्शन विवरण के अंतर्गत दिखाए जाते हैं। `account.connection_checked` सत्र हैश, आईपी, टोकन या एपीआई हैश के बिना परिणाम रिकॉर्ड करता है। वे कभी भी नियमों को स्वीकार नहीं करते या अपडेट इंस्टॉल नहीं करते। एक अनुरोध विफलता या फ्लडवेट (FloodWait) बाद के अनुरोधों को रोकता है; एक अनुपस्थित परिणाम अज्ञात बना रहता है। नेटवर्क जाँचों को छोड़ दिया जाता है, जबकि स्थानीय जाँचें अभी भी अपने परिणाम रिपोर्ट कर सकती हैं। [सख्त चुनी हुई चैट्स](https://phishdestroy.io/tgwitness/hi/docs/reference/collection/#strict-chosen-chats) चालू होने पर, वर्तमान अधिकृतण का अनुरोध नहीं किया जाता है और उस जाँच को छोड़ा हुआ दिखाया जाता है।

साइन-इन करने के बाद और प्रत्येक नए कनेक्शन पर, TgWitness खाते की संवेदनशील सामग्री सेटिंग पढ़ता है। जब यह बंद हो और टेलीग्राम बदलाव की अनुमति दे, तो TgWitness इसे चालू कर देता है ताकि टेलीग्राम द्वारा संवेदनशील (18+) के रूप में चिह्नित सामग्री सहेजी जा सके, और `account.content_settings` को रिकॉर्ड किया जा सके। यह सेटिंग खाते की होती है और हर टेलीग्राम ऐप में लागू होती है। सख्त चुनी गई चैट्स इसे प्रभावित नहीं करती; साइन इन करने से पहले उसे चालू कर लें।

एक वर्कस्पेस के कनेक्शन को पुनर्स्थापित करने के लिए एक साथ आने वाले अनुरोध, अपना क्लाइंट साझा करते हैं और इसके कनेक्शन सेटअप के पूरा होने की प्रतीक्षा करते हैं। एक असफल या रद्द किया गया प्रयास अगले अनुरोध को फिर से प्रयास करने के लिए रिलीज़ कर देता है। यदि सेटअप के दौरान सहेजे गए क्रेडेंशियल, क्लाइंट या प्राधिकरण की स्थिति बदल जाती है, तो पुराना प्रयास एक तैयार कनेक्शन की रिपोर्ट करने के बजाय रुक जाता है।

FloodWait डायग्नोस्टिक्स असफल TL मेथड, किसी भी Takeout/रेंज रैपर, सर्वर-अनुरोधित प्रतीक्षा और प्रभावी समय-सीमा को `telegram.backoff` में बरकरार रखते हैं। कनेक्शन विवरण तब मेथड और समय-सीमा दिखाते हैं जब अनुरोध रुके होते हैं। डायग्नोस्टिक में प्रत्येक मेथड के लिए क्लाइंट-कॉल काउंटर शामिल होते हैं जब से वह क्लाइंट बनाया गया है; वे नेस्टेड पीयर समाधान को अलग से गिनते हैं, लेकिन पैकेट या टेलीथॉन के आंतरिक पुनः प्रयास प्रयासों को नहीं गिनते हैं। वर्तमान काउंटर स्थिति API में `collector.rpc_activity` के रूप में भी उपलब्ध हैं। कोई अनुरोध तर्क, उपयोगकर्ता नाम, एक्सेस हैश या अपवाद पाठ शामिल नहीं हैं। अंतिम डायग्नोस्टिक और पूरी समय-सीमा रीस्टार्ट के बाद भी बनी रहती है। बिना मेथड रिकॉर्ड वाले पिछले इंतज़ारों को बाद में पहचाना नहीं जा सकता। स्रोत समीक्षा के लिए [निर्यात सीमाओं](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md) और खोज तथा इतिहास अधिग्रहण के बीच के अंतर को देखें।

`official_app=True` या `False` टेलीग्राम का वर्तमान-अधिकृत फ़्लैग है। कोई भी मान यह स्थापित नहीं करता कि खाता प्रतिबंधित, विश्वसनीय या निरीक्षण के अधीन है। मौजूदा साक्ष्य-मोड `account.devices` स्नैपशॉट सभी साइन-इन किए गए उपकरणों का इतिहास बने रहते हैं; कनेक्शन डायग्नोस्टिक्स केवल वर्तमान उपकरण का विवरण ही रखता है।

कनेक्शन से पहले, एडवाइजरी जाँचें API प्लेटफ़ॉर्म, भाषा पैक, डिवाइस/ओएस और ऐप-संस्करण प्रारूपों, मोबाइल सिस्टम लोकल, और टेलीथॉन की वास्तविक स्कीमा परत की तुलना समीक्षा किए गए कैटलॉग बेसलाइन से करती हैं। चेतावनियाँ सर्वर लॉग और खाते की स्थिति मेटाडेटा में दिखाई देती हैं; वे कभी भी आयातित मानों को प्रतिस्थापित नहीं करतीं या स्कीमा परत को नहीं बदलतीं। एक अलग परत संगतता की समीक्षा करने का संकेत है; खाते की अपनी कनेक्शन स्थिति यह दिखाती है कि यह काम कर रहा है या नहीं। टेलीग्राम अपनी ओर से प्रतिबंध तय करता है, चाहे कोई भी क्लाइंट प्रोफ़ाइल उपयोग की गई हो। डिस्कनेक्टेड खाते की स्थिति, किसी अन्य डिवाइस का विवरण बनाने के बजाय सहेजी गई प्रोफ़ाइल का उपयोग करती है।

इसके बजाय अपना स्वयं का एप्लिकेशन उपयोग करने के लिए:

1. [my.telegram.org](https://my.telegram.org) खोलें और अपने किसी भी फोन नंबर से साइन इन करें। कोड Telegram ऐप में आता है, SMS से नहीं।
2. **API विकास उपकरण** चुनें।
3. एक एप्लिकेशन बनाएँ: कोई भी शीर्षक और संक्षिप्त नाम (5–32 अक्षर), प्लेटफ़ॉर्म **डेस्कटॉप**। URL और विवरण खाली रह सकते हैं।
4. **ऐप का api_id** (एक संख्या) और **api_hash** (32 हेक्साडेसिमल अक्षर) कॉपी करें।

पैनल में, साइन-इन फ़ॉर्म के नीचे **API ID + हैश** खोलें। आप एक ही `api_id:api_hash` जोड़ी को **API ID** में पेस्ट कर सकते हैं और दोनों फ़ील्ड भर जाएँगे। एक जोड़ी का उपयोग आपके सभी खातों के लिए किया जा सकता है। सफल लॉगिन के बाद यह केवल उसी वर्कस्पेस में सहेजा, एन्क्रिप्ट किया जाता है और कभी भी ब्राउज़र में वापस नहीं भेजा जाता है।

तीन अलग-अलग क्रेडेंशियल शामिल हैं:

| गोपनीय | खोलता है | यह कहाँ स्थित है |
| --- | --- | --- |
| पैनल टोकन | TgWitness वेब पैनल | `panel-token.txt` डेटा निर्देशिका में, या `TGWITNESS_TOKEN` |
| एपीआई आईडी + हैश | अपने आप में कुछ नहीं; ऐप की पहचान करता है | बिल्ट-इन जोड़ी, आयातित सेटिंग्स, या my.telegram.org पर आपका अपना ऐप |
| खाता प्राधिकरण | टेलीग्राम खाता | फ़ोन/QR लॉगिन द्वारा बनाया गया या सत्र के रूप में लाया गया |

यदि टेलीग्राम तक किसी प्रॉक्सी के माध्यम से पहुँचना आवश्यक है, तो पहले इसे **More tools → Account → Settings → Connection settings → Change connection route** के अंतर्गत सेट करें।

## फ़ोन नंबर

1. **अधिक उपकरण खोलें → खाता**, **फ़ोन** टैब पर जाएँ, और नंबर को अंतर्राष्ट्रीय प्रारूप में दर्ज करें, उदाहरण के लिए `+44 7700 900123`। रिक्त स्थान और डैश स्वचालित रूप से हटा दिए जाते हैं।
2. **Continue** दबाएँ। API ID + हैश खाली रह सकते हैं।
3. टेलीग्राम द्वारा भेजा गया कोड दर्ज करें, जो आमतौर पर टेलीग्राम ऐप पर आता है; टेलीग्राम यह तय करता है कि एसएमएस भेजा जाए या नहीं।
4. यदि खाते में दो-चरणीय सत्यापन है, तो वह पासवर्ड दर्ज करें। यह पैनल टोकन नहीं है और न ही डिवाइस पासकोड है।
5. लॉगिन के बाद प्रदर्शित खाता आईडी की जाँच करें, फिर स्रोत चुनें।

लॉगिन कोड और 2FA पासवर्ड कभी भी डिस्क पर लिखे नहीं जाते।

## क्यूआर कोड

जब खाता पहले से ही फोन या किसी अन्य कंप्यूटर पर साइन इन हो, तब इसका उपयोग करें।

1. **QR कोड** टैब → **QR कोड दिखाएँ**। API ID + हैश खाली रह सकते हैं।
2. साइन-इन किए गए डिवाइस पर: **सेटिंग्स → डिवाइस → डेस्कटॉप डिवाइस लिंक करें**, कोड स्कैन करें और पुष्टि करें।
3. यदि टेलीग्राम अनुरोध करता है तो TgWitness में 2FA पासवर्ड दर्ज करें।

QR छवि स्थानीय रूप से उत्पन्न होती है। कोड समाप्त हो जाते हैं; दोबारा प्रयास करने के लिए **'एक और QR कोड उत्पन्न करें'** पर क्लिक करें। पैनल को लॉक करने, कार्यक्षेत्र बदलने या दूसरा लॉगिन शुरू करने से लंबित कोड रद्द हो जाता है।

## ऑथ कुंजी + डीसी आईडी

एक ऑथ की हर टेलीग्राम सत्र के पीछे का कच्चा 256-बाइट प्राधिकरण है, जिसे डेटा-सेंटर नंबर **DC 1–5** के साथ, **512 हेक्साडेसिमल अक्षरों** के रूप में लिखा जाता है।

1. टैब **'Auth कुंजी**'। पूरी कुंजी पेस्ट करें; `…` वाली संक्षिप्त कुंजी काम नहीं करेगी।
2. कुंजी के साथ प्रदान किया गया DC ID चुनें।
3. वैकल्पिक रूप से **उपयोगकर्ता आईडी** दर्ज करें। यदि टेलीग्राम कोई अलग खाता रिपोर्ट करता है तो TgWitness कनेक्ट करने से इनकार कर देता है।
4. Press **Connect खाता**।

एक ऑथ की (512 वर्ण) कोई एपीआई हैश (32 वर्ण) नहीं है। उसी की को JSON के रूप में भी आयात किया जा सकता है, देखें [खाता JSON](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#account-json)।

## खाता फ़ाइलें

**खाता जोड़ें → फ़ाइलें** खोलें और **एक खाते से संबंधित चार फ़ाइलों** तक चुनें, कुल मिलाकर **8 MiB**, **फ़ाइलें जांचें** दबाएँ, फिर **खाते को कनेक्ट करें**। फ़ाइलें चुनने या सत्र पाठ पेस्ट करने पर कुछ भी नहीं भेजा जाता है; **फ़ाइलें जांचें** उन्हें आपके TgWitness सर्वर पर भेजता है, जो उन्हें बिना साइन इन किए पढ़ता है और मिली हुई सत्र दिखाता है।

**फ़ाइलें**, **ऑथ कुंजी** और थोक-आयात फ़ॉर्म कनेक्ट करने से पहले समानांतर-सत्र चेतावनी दिखाते हैं। डिफ़ॉल्ट रूप से आयात किए गए प्राधिकरणों का पुन: उपयोग किया जाता है। जब तक उसकी कुंजी यहाँ उपयोग में है, तब तक मूल क्लाइंट को बंद रखें। **फ़ाइलें** और **ऑथ कुंजी** **एक स्वतंत्र प्राधिकरण बनाने** का भी विकल्प देते हैं, जिसका वर्णन नीचे किया गया है। थोक आयात अभी भी प्रत्यक्ष मोड का उपयोग करता है। फ़ोन और इंटरैक्टिव क्यूआर लॉगिन अलग-अलग प्राधिकरण बनाते हैं। चेतावनी शीर्षक आयात फ़ॉर्म में दिखाई देता रहता है; जब फ़ाइलें या एक कुंजी/सत्र स्ट्रिंग प्रदान की जाती हैं तो इसका पूरा विवरण स्वचालित रूप से खुल जाता है। इसे पढ़ने के बाद संकुचित किया जा सकता है, ताकि फ़ाइल पिकर और कनेक्शन नियंत्रण फ़ोन पर उपयोगी बने रहें।

एक [प्रमाणित डिप्लॉयमेंट](https://phishdestroy.io/tgwitness/hi/docs/reference/high-assurance/) (Phala Cloud, Intel TDX) एक इम्पोर्टेड की पर कलेक्शन नहीं करता है। वहाँ, **फ़ाइल्स** और **ऑथ की** केवल **एक स्वतंत्र ऑथराइज़ेशन** चुने जाने पर ही कनेक्ट होती हैं; बल्क इम्पोर्ट अस्वीकार कर दिया जाता है। फ़ोन और QR लॉगिन सामान्य रूप से काम करते हैं।

- फ़ाइलें आपके TgWitness सर्वर की मेमोरी में ही परिवर्तित की जाती हैं। अपलोड्स संग्रहीत नहीं किए जाते, ZIP फ़ाइलें डिस्क पर एक्सट्रेक्ट नहीं की जातीं और किसी भी बाहरी सेवा से संपर्क नहीं किया जाता।
- फिर इस सत्र की जाँच टेलीग्राम के साथ की जाती है। यदि कोई फ़ाइल उपयोगकर्ता आईडी बताती है, तो उसका मिलान टेलीग्राम द्वारा रिपोर्ट किए गए खाते से होना चाहिए।
- विभिन्न खातों या विभिन्न API क्रेडेंशियल्स का वर्णन करने वाली फ़ाइलें अस्वीकार की जाती हैं, एक को चुनने के बजाय।
- **पासकोड या सेशन टेक्स्ट** में TData लोकल पासकोड फ़ील्ड होता है, एक बॉक्स जिसमें स्ट्रिंगसेशन पेस्ट किया जा सकता है और **बिना साइन इन किए फ़ाइलें पढ़ी जा सकती हैं** (टेलिग्राम से संपर्क किए बिना फ़ॉर्म भरता है)। स्ट्रिंगसेशन पेस्ट करने पर चयनित फ़ाइलें साफ़ हो जाती हैं, और फ़ाइलें चुनने पर पेस्ट किया गया टेक्स्ट साफ़ हो जाता है, इसलिए चेक और कनेक्शन नवीनतम चयन का उपयोग करते हैं। पासकोड बदलने के बाद, **'फ़ाइलें जांचें' को** फिर से दबाएँ।

### एक स्वतंत्र प्राधिकरण बनाएँ

आयातित फ़ाइलों या एक ऑथ की को कनेक्ट करने से पहले **एक स्वतंत्र प्राधिकरण बनाएँ**। TgWitness आयातित डोनर को संक्षेप में कनेक्ट करता है, इसका उपयोग नए क्लाइंट के QR लॉगिन टोकन को अनुमोदित करने के लिए करता है, और अनुमोदन के तुरंत बाद डोनर को डिस्कनेक्ट कर देता है। नए क्लाइंट की अपनी प्राधिकरण कुंजी और एक अलग से चयनित डेस्कटॉप प्रोफ़ाइल होती है। डोनर द्वारा प्रदान किए गए API क्रेडेंशियल और डिवाइस प्रोफ़ाइल का उपयोग केवल डोनर कनेक्शन के लिए किया जाता है। कोई भी मौजूदा प्राधिकरण लॉग आउट या रद्द नहीं किया जाता है।

**इस चरण के दौरान दाता के मूल क्लाइंट को पूरी तरह से बंद रखें।** प्रारंभिक कनेक्शन अभी भी अपनी कॉपी की गई कुंजी का उपयोग करता है, इसलिए यह मोड उस प्रारंभिक समानांतर-उपयोग के जोखिम को दूर नहीं कर सकता है। एक बार नया प्राधिकरण जुड़ जाने के बाद, मालिक मूल क्लाइंट को फिर से खोल सकता है और एक ही समय में दोनों का उपयोग कर सकता है। इंटरैक्टिव **क्यूआर कोड** लॉगिन, मूल क्लाइंट को यहाँ अपनी कुंजी की प्रतिलिपि बनाए बिना या उसे कनेक्ट किए बिना लॉगिन को मंजूरी देने की अनुमति देता है।

**डोनर सत्र से लॉग आउट न करें या उसे समाप्त न करें।** जब QR लॉगिन को मंजूरी देने वाला सत्र समाप्त होता है, तो टेलीग्राम भी उस सत्र को समाप्त कर देता है जिसे उसने मंजूरी दी थी; एक लाइव चेक में डोनर के लॉग आउट करने के एक सेकंड के भीतर नई प्राधिकृति रुक गई। इम्पोर्ट डोनर सत्र को रिकॉर्ड करता है (`session_origin.approved_by`: डिवाइस, API ID और निर्माण समय)। सत्र सूची इसे चिह्नित करती है, **सत्र समाप्त करें** इसे अस्वीकार करता है, और **अन्य सभी सत्र समाप्त करें** और **इसे ही एकमात्र सत्र बनाएँ** इसे साइन इन रहने देता है।

यदि टेलीग्राम 2FA का अनुरोध करता है, तो यह मोड का उपयोग करता है `twoFA` चयनित JSON से, जब यह मौजूद हो, या पासवर्ड मांगता है। अस्वीकृत आयातित पासवर्ड पासवर्ड फ़ॉर्म पर वापस लौटता है। पासवर्ड सहेजे नहीं जाते हैं। उम्मीदवार कुंजी को में एन्क्रिप्टेड रूप में सहेजा जाता है। `independent_login.enc`, जिसमें डेटा-सेंटर माइग्रेशन के दौरान हुए बदलाव भी शामिल हैं। किसी रुकावट के बाद, सहेजे गए उम्मीदवार को फिर से शुरू करने के लिए उसी दाता और इस विकल्प को चुनें। दाता की जाँच की जाती है `help.getAppConfig` अनुमोदन से पहले; एक फ्रीज़्ड खाता वहीं रुक जाता है। यदि टेलीग्राम लॉगिन को अनुमोदित करने से पहले दाता को अस्वीकार कर देता है, तो अनुमोदन-रहित उम्मीदवार कुंजी को खारिज कर दिया जाता है और आयात फिर से शुरू हो सकता है। एक सहेजा गया उम्मीदवार केवल तभी दूसरे दाता से प्रतिस्थापित होता है जब टेलीग्राम उस उम्मीदवार को साइन इन न किया हुआ बताता है; एक उम्मीदवार जो साइन इन है या अपने 2FA पासवर्ड का इंतजार कर रहा है, उसे रखा जाता है। वर्कस्पेस उस खाते के लिए आरक्षित रहता है; असफल पूरा होने पर नया वर्कस्पेस नहीं मिटता। इसकी डेटा निर्देशिका और वॉल्ट कुंजी रखें। अंतिम क्रेडेंशियल और `account.authorized` जर्नल रिकॉर्ड में इम्पोर्ट विधि, इनपुट प्रारूप और डोनर API ID शामिल होते हैं, डोनर कुंजी या पासवर्ड के बिना।

पर 5 नवंबर 2026, एक समर्पित खाते ने टेलीथॉन, पायरोग्राम और टीडेटा दाताओं के साथ लाइव जांचें पास कीं: 2FA पूरा होना, अलग नई प्राधिकरण कुंजियाँ, दाता और नए क्लाइंट द्वारा एक साथ पहुँच, और एक सार्वजनिक चैनल पढ़ना। टेलीथॉन मामले ने पासवर्ड चरण में रुकावट के बाद एक सहेजे गए उम्मीदवार को फिर से शुरू किया। प्रत्येक नए प्राधिकरण ने छह लॉगिन-पश्चात प्रारंभिकीकरण अनुरोधों को पूरा किया, और इसके हस्ताक्षरित जर्नल का सत्यापन किया गया। मूल सत्र चारों प्रदान किए गए प्रारूपों में उपयोग योग्य बना रहा।

टेलीग्राम का [RPC त्रुटि डेटाबेस](https://core.telegram.org/api/errors.json)`FRESH_CHANGE_ADMINS_FORBIDDEN` को एडमिन बदलने, `FRESH_CHANGE_PHONE_FORBIDDEN` को फोन नंबर बदलने, और `FRESH_RESET_AUTHORISATION_FORBIDDEN` को अन्य सत्रों को रद्द करने, उनका जीवनकाल बदलने या पासकी पंजीकृत करने के साथ जोड़ता है। `SESSION_TOO_FRESH_*` और `PASSWORD_TOO_FRESH_*` का संबंध स्वामित्व हस्तांतरण और राजस्व या उपहार निकासी से है। ये संग्रह संचालन नहीं हैं; एक नए लॉगिन का मतलब एक व्यापक 24 घंटे का रीडिंग बैन नहीं है। एक्सपोर्ट अलग से `TAKEOUT_INIT_DELAY_*` लौटा सकता है। TgWitness सर्वर-अनुरोधित विरामों को बनाए रखता है और प्रतिबंधों से बचने के लिए स्वचालित रूप से टोकन स्वीकृति का पुनः प्रयास या सत्र रद्द नहीं करता है।

**अधिक उपकरण → खाता → खाता सुरक्षा → इस खाते के सत्र → अन्य सभी सत्र समाप्त करें** ऑपरेटर के अनुरोध पर `auth.resetAuthorizations` को कॉल करता है और सत्रों की संख्या के साथ `account.all_other_sessions_terminated` को रिकॉर्ड करता है। टेलीग्राम इसे 24 घंटे के लिए साइन इन किए गए सत्र से स्वीकार करता है। जब यह वर्कस्पेस एक इम्पोर्टेड सेशन से QR द्वारा साइन इन किया जाता है, तो जिस सेशन ने इसे मंजूरी दी थी वह साइन इन बना रहता है: TgWitness दूसरों को एक-एक करके `account.resetAuthorization` के साथ समाप्त कर देता है और `kept_approving_session` को रिकॉर्ड करता है। **इसे एकमात्र सेशन बनाएँ**, फिर उस कारण से बंद कर दें और पासवर्ड नहीं बदलें।

**इसे एकमात्र सत्र बनाएँ**, इस कार्यक्षेत्र से साइन इन करके बनाई गई कुंजी के लिए भी यही करें, फिर यदि खाते में दो-चरणीय पासवर्ड नहीं है तो उसे चालू करें। पैनल वह पासवर्ड एक बार दिखाता है; TgWitness उसे केवल तब तक कार्यक्षेत्र वॉल्ट में रखता है। जर्नल रिकॉर्ड करता है `session.exclusive_from`. यदि टेलीग्राम बाद में कोई अन्य सत्र सूचीबद्ध करता है, तो जर्नल रिकॉर्ड करता है `session.exclusive_ended` और पैनल एक अलर्ट जारी करता है। सत्यापनकर्ता दोनों को प्रिंट करता है।

**जब टेलीग्राम अनुमति देता है तो यह केवल उसी सत्र को टाइमर पर समान क्रिया बनाता है**। यह विकल्प इस वर्कस्पेस में बनाई गई एक कुंजी के लिए **इस खाते के सत्रों के** अंतर्गत दिखाई देता है और इसे `session.exclusive_automatic` के रूप में दर्ज किया जाता है। निरीक्षण करते समय, कलेक्टर हर पांच मिनट में जांचता है कि क्या उस कुंजी के `account.authorized` रिकॉर्ड के बाद से 24 घंटे बीत गए हैं — टेलीग्राम उससे पहले `FRESH_RESET_AUTHORISATION_FORBIDDEN` का जवाब देता है — और फिर एक ही ऑपरेशन एक बार चलाता है। सफलता को मैनुअल बटन की तरह, `session.exclusive_from` के रूप में दर्ज किया जाता है। एक इनकार को एक बार टेलीग्राम के कारण के साथ `session.exclusive_postponed` के रूप में दर्ज किया जाता है, और कलेक्टर छह घंटे तक की बढ़ती देरी के साथ फिर से प्रयास करता है। यहाँ रीड-ओनली का कोई प्रभाव नहीं होता है: सत्र समाप्त करना एक खाता-सुरक्षा कार्रवाई है, न कि चैट कार्रवाई।

स्वचालित रन द्वारा उत्पन्न दो-चरणीय पासवर्ड को टेलीग्राम द्वारा सेट करने से पहले वर्कस्पेस कुंजी से एन्क्रिप्ट करके वर्कस्पेस वॉल्ट में सहेजा जाता है। पैनल इसे एक बार से प्राप्त करता है `POST /api/account/sessions/only/password` से एक बार प्राप्त करता है, जो इसे हटा देता है, और जब आप **इस खाते के सत्र (Sessions)** खोलते हैं तो इसे मैनुअल फ़्लो के समान डायलॉग में दिखाता है। कनेक्शन पेज पर यह नोट होता है कि एक पासवर्ड प्रतीक्षा कर रहा है। यह कभी भी जर्नल में दर्ज नहीं होता है और जब तक इसे दिखाया नहीं जाता, तब तक यह रीस्टार्ट के बाद भी बना रहता है।

निरीक्षण के दौरान नए सत्रों की भी रिपोर्ट की जाती है: जब टेलीग्राम की सत्र सूची में कोई प्रविष्टि जुड़ती है, तो `account.sessions` रिकॉर्ड इसे `added` के अंतर्गत नामित करता है और पैनल उस स्नैपशॉट से डिवाइस, एप्लिकेशन और देश के साथ एक अलर्ट जारी करता है।

### विटनेस प्रोब

**अधिक उपकरण → खाता → खाता सुरक्षा → विटनेस प्रोब** यह जांचता है कि कोई दूसरा क्लाइंट इस खाते के अपडेट प्राप्त कर रहा है या नहीं। एक अलग टेलीग्राम खाते और अपनी सत्र कुंजी के साथ साइन इन किए गए दूसरे वर्कस्पेस को जोड़ें, दोनों खातों के साथ एक निजी समूह बनाएँ, फिर उस समूह को **प्रोब चैट** और दूसरे वर्कस्पेस को **विटनेस वर्कस्पेस** के रूप में चुनें और प्रोब चालू करें। दोनों खातों के लिए **केवल-पठन (Read-only)** बंद होना आवश्यक है, और विटनेस वर्कस्पेस को अवलोकन कर रहा होना चाहिए।

निरीक्षण करते समय, यह वर्कस्पेस हर 60–120 सेकंड में समूह में `probe:<n>:<token>` भेजता है और `probe.sent` रिकॉर्ड करता है। गवाह `ack:<n>:<token>` का जवाब देता है और `probe.seen` और `probe.ack_sent` रिकॉर्ड करता है। एक ack जो 20 सेकंड के भीतर एक लाइव अपडेट के रूप में इस सत्र तक पहुँचता है, उसे `probe.acked` के रूप में रिकॉर्ड किया जाता है। अन्यथा वर्कस्पेस समूह का हालिया इतिहास पढ़ता है। वहाँ पाया गया एक एक् (ack) लेकिन जो लाइव डिलीवर नहीं हुआ, उसे कारण `probe_ack_missed_live` के साथ `coverage.gap` के रूप में दर्ज किया जाता है: पैनल एक अलर्ट जारी करता है और इवेंट इनटेक को विफल के रूप में चिह्नित करता है जब तक कि बाद में कोई एक् लाइव न आ जाए (`connection.restored`, कारण `probe_ack_live`)। कोई भी एक् `probe.unanswered` के रूप में दर्ज नहीं किया जाता है; प्रतीक्षा के दौरान कनेक्शन में रुकावट या एक अपठनीय इतिहास को `probe.inconclusive` के रूप में दर्ज किया जाता है। केवल-पठनीय, टेलीग्राम प्रतिबंध और फ्लडवेट (FloodWait) विराम को एक बार `probe.skipped` के रूप में दर्ज किया जाता है।

### टेलीथन `.session`

|  |  |
| --- | --- |
| यह क्या है | SQLite डेटाबेस जो Telethon-आधारित उपकरण बनाते हैं, उदाहरण के लिए `my_account.session` |
| द्वारा मान्यता प्राप्त | तालिकाएँ `sessions` (`dc_id`, `server_address`, `port`, `auth_key`) और `version` = 7 या 8 |
| आवश्यकताएँ | ठीक एक अधिकृत सत्र पंक्ति; एक बंद, पूर्ण डेटाबेस |

सबसे पहले उस प्रोग्राम को बंद करें जिसने फ़ाइल बनाई है। यदि इसके बगल में `my_account.session-journal` या `my_account.session-wal` मौजूद है, तो डेटाबेस अंतिम नहीं है: मूल क्लाइंट को साफ़-सुथरे तरीके से खोलें और बंद करें। उन साइडकार फ़ाइलों को हटाने से एक टूटी हुई कॉपी रह सकती है।

### पायरोग्राम `.session`

|  |  |
| --- | --- |
| यह क्या है | SQLite डेटाबेस जो Pyrogram-आधारित उपकरण बनाते हैं |
| द्वारा मान्यता प्राप्त | `sessions` को `dc_id`, `auth_key`, `test_mode`, `user_id`, `is_bot` के साथ तालिकाबद्ध करें; `version` = 2 या 3 |
| आवश्यकताएँ | प्रोडक्शन नेटवर्क पर एक अधिकृत **उपयोगकर्ता** सत्र। बॉट और टेस्ट-डीसी सत्र अस्वीकार किए जाते हैं। |

लॉगिन के दौरान संग्रहीत उपयोगकर्ता आईडी की टेलीग्राम के साथ जांच की जाती है।

### सत्र + JSON जोड़ी

खातों को अक्सर एक ही नाम वाली दो फ़ाइलों के रूप में वितरित किया जाता है, उदाहरण के लिए `447700900123.session` और `447700900123.json`। एक साथ दोनों चुनें।

- JSON से, TgWitness `app_id`/`api_id` और `app_hash`/`api_hash` का उपयोग करता है, इसलिए आपको आमतौर पर API क्रेडेंशियल टाइप नहीं करने पड़ते।
- कनेक्शन प्रोफ़ाइल `device_model` (उपनाम `device`), `system_version` (उपनाम `sdk`), `app_version`, `lang_code`, `system_lang_code` (उपनाम `system_lang_pack`), `lang_pack` और वैकल्पिक `tz_offset` (UTC से सेकंड, -43200 से 50400)। सप्लाई किए गए फ़ील्ड्स, जेनेरेटेड डिफ़ॉल्ट्स और पैनल/ब्राउज़र भाषा पर प्राथमिकता लेते हैं। टकराव वाले उपनाम अस्वीकार कर दिए जाते हैं। हल की गई प्रोफ़ाइल को एन्क्रिप्टेड वर्कस्पेस क्रेडेंशियल्स में सहेजा जाता है और रीस्टार्ट के बाद, इसके ऐप संस्करण सहित, पुन: उपयोग किया जाता है।
- `phone`, प्रॉक्सी सेटिंग्स और डिवाइस टोकन को **अनदेखा** किया जाता है। `twoFA` केवल-पठनीय है जब **'एक स्वतंत्र प्राधिकरण बनाएँ'** का चयन किया जाता है; प्रत्यक्ष आयात इसे अनदेखा करता है।
- एक समर्थित प्राधिकरण फ़ील्ड के बिना JSON केवल मेटाडेटा है। इसका सत्र फ़ाइल जोड़ें या फ़ोन या QR लॉगिन के साथ जारी रखें। एक समर्थित सत्र या Auth Key वाले JSON को स्वयं प्राधिकृत कर सकता है; [Account JSON](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#account-json) देखें।

### टेलीग्राम डेस्कटॉप (TData)

TData टेलीग्राम डेस्कटॉप एप्लिकेशन का`tdata` फ़ोल्डर है (desktop.telegram.org से क्रॉस-प्लेटफ़ॉर्म ऐप)।

| सिस्टम | डिफ़ॉल्ट `tdata` स्थान |
| --- | --- |
| विंडोज | `%APPDATA%\Telegram Desktop\tdata` (पोर्टेबल टेलीग्राम: `Telegram.exe` के बगल में) |
| लिनक्स | `~/.local/share/TelegramDesktop/tdata` |
| macOS | `~/Library/Application Support/Telegram Desktop/tdata` |

इसे आयात करने के लिए:

> **समानांतर सत्र चेतावनी।** डायरेक्ट TData आयात टेलीग्राम डेस्कटॉप की प्राधिकरण कुंजी का पुन: उपयोग करता है। उस कुंजी का डेस्कटॉप और TgWitness में एक साथ उपयोग न करें। टेलीग्राम `AUTH_KEY_DUPLICATED` के साथ प्राधिकरण को अमान्य कर सकता है, जिससे एक नए लॉगिन तक दोनों प्रतियां अप्रयुक्त हो जाएंगी।
>
>
>
> डेस्कटॉप को पूरी तरह से बंद कर दें, जिसमें इसकी ट्रे प्रक्रिया भी शामिल है, और जब TgWitness आयातित सत्र का उपयोग कर रहा हो तो उस कॉपी को बंद रखें। **सत्र को बंद करें, लॉग आउट न करें या रद्द न करें:** रद्दीकरण आयातित कॉपी को भी अमान्य कर देता है। यदि आपको दोनों क्लाइंट चलाने की आवश्यकता है, तो **'एक स्वतंत्र प्राधिकरण बनाएँ**' चुनें और जब तक नया लॉगिन सफल न हो जाए, तब तक डेस्कटॉप को बंद रखें, या फोन या क्यूआर द्वारा TgWitness में साइन इन करें। एक समर्पित खाते की अनुशंसा की जाती है, लेकिन यह क्लोन कीज़ को समानांतर रूप से उपयोग करने के लिए सुरक्षित नहीं बनाता है।
>
>
>
> यह आयातित पर भी लागू होता है `.session` फ़ाइलें, StringSession टेक्स्ट और Auth Key HEX पर भी लागू होता है। अन्य क्लाइंट जो अपने स्वयं के स्वतंत्र रूप से बनाए गए प्राधिकरणों के साथ हैं, वे साइन इन रह सकते हैं। [Telegram का AUTH_KEY_DUPLICATED दस्तावेज़](https://core.telegram.org/api/errors#406-not-acceptable) देखें।

1. Telegram डेस्कटॉप को पूरी तरह से बंद करें।
2. `tdata` से **केवल** इन दो आइटमों वाली एक ZIP बनाएं:

   - `key_datas`
   - 16-अक्षर वाली फ़ाइल जिसका अंत `s` पर होता है, उसके बगल में, आमतौर पर `D877F783D5D3EF8Cs`

   मीडिया कैश के साथ पूरे फ़ोल्डर को ज़िप करने पर आमतौर पर सीमा (512 प्रविष्टियाँ, 32 MiB अनपैक) से अधिक हो जाता है। 3. **फ़ाइल्स** में ज़िप चुनें। यदि टेलीग्राम डेस्कटॉप का कोई **स्थानीय पासकोड** है, तो पहले उसे **पासकोड या सत्र टेक्स्ट** के तहत दर्ज करें। यह 2FA पासवर्ड नहीं है।

समर्थित: प्रति आर्काइव एक खाता, आधुनिक `key_datas`/`key_data0`/`key_data1` स्टोरेज, स्थानीय पासकोड। समर्थित नहीं: कई लॉग-इन खातों वाले फ़ोल्डर, पुराने डेस्कटॉप लेआउट, पासवर्ड-संरक्षित ज़िप्स, और अलग नेटिव macOS ऐप "Telegram for macOS"।

### टेलीथॉन स्ट्रिंगसेशन

टेक्स्ट की एक पंक्ति, जो आमतौर पर `1` से शुरू होती है और लगभग 350 वर्णों की लंबी होती है। इसे `.txt` या `.tgwitness-session` फ़ाइल (अधिकतम 4 KiB) के रूप में लोड करें, या इसे **पासकोड या सेशन टेक्स्ट** के तहत पेस्ट करें। केवल टेलीथॉन स्ट्रिंग्स स्वीकार किए जाते हैं; पायरोग्राम और TDLib स्ट्रिंग्स अलग प्रारूपों का उपयोग करते हैं।

### ऑथ कुंजी और डीसी एक ही पंक्ति में

खाता सूचियों में अक्सर कच्ची प्राधिकृति (raw authorization) `<512 hexadecimal characters>:<DC id>` के रूप में होती है, उदाहरण के लिए `a1b2…ef:5`। उस पंक्ति को **पासकोड या सत्र पाठ (session text)** के तहत पेस्ट करें, इसे एक टेक्स्ट फ़ाइल के रूप में लोड करें, या इसे एक खाते के[JSON (Account JSON)](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#account-json)के `session` फ़ील्ड में डालें। TgWitness DC 1–5 को उसी प्रोडक्शन पते से मैप करता है जैसे `auth_key` + `dc_id` JSON आयात करता है और प्रारूप को **ऑथ की HEX और DC** के रूप में रिपोर्ट करता है। किसी भी अन्य DC नंबर या कुंजी लंबाई को अस्वीकार कर दिया जाता है।

### खाता JSON

एक JSON ऑब्जेक्ट, अधिकतम **64 KiB**, **`.json`** पर समाप्त होने वाली फ़ाइल में।

| क्षेत्र (उपनाम) | अर्थ |
| --- | --- |
| `api_id` (`app_id`) | एप्लिकेशन आईडी, एक धनात्मक संख्या |
| `api_hash` (`app_hash`) | एप्लिकेशन हैश, 32 हेक्साडेसिमल अक्षर |
| `string_session` (`session_string`, `session_str`; legacy `session`) | Telethon StringSession टेक्स्ट, या `<512 hexadecimal characters>:<DC id>`, फ़ाइल नाम नहीं |
| `auth_key` (`auth_key_hex`) + `dc_id` | 512-अक्षर की ऑथ कुंजी और DC 1–5 पूरा करें |
| `user_id` (`id`) | वैकल्पिक; प्राधिकरण सहेजे जाने से पहले टेलीग्राम के साथ जांचा जाता है |
| `device_model` (`device`) | कनेक्शन डिवाइस का विवरण |
| `system_version` (`sdk`) | कनेक्शन OS संस्करण |
| `app_version` | Telegram को भेजा गया एप्लिकेशन संस्करण |
| `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | क्लाइंट भाषा, सिस्टम भाषा और क्लाइंट भाषा पैक; एक खाली `lang_pack` की अनुमति है |
| `tz_offset` | वैकल्पिक UTC ऑफसेट सेकंड में, `initConnection.params` में भेजा गया; पूर्णांक या दशमलव पूर्णांक स्ट्रिंग |

यदि उपनाम और मुख्य नाम दोनों मौजूद हैं, तो उनका एक समान होना चाहिए। स्पष्ट टेलीथॉन `session` फ़ील्ड्स किसी अन्य प्रारूप में एक सामान्य <code>session</code> ब्लॉब पर प्राथमिकता लेते हैं। यदि दोनों में पहचानने योग्य टेलीथॉन सत्र होते हैं, तो उन्हें एक ही प्राधिकरण का वर्णन करना चाहिए। स्पष्ट फ़ील्ड के बिना, `session` एक वैध टेलीथॉन स्ट्रिंगसेशन या auth कुंजी और DC `<512 hexadecimal characters>:<DC id>` के रूप में होना चाहिए। उदाहरण:

```
{ "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
}
```

पहला उदाहरण केवल API क्रेडेंशियल भरता है; फोन या QR से साइन इन करें, या एक सत्र फ़ाइल जोड़ें। बल्क सूचियाँ (खातों की एक JSON ऐरे) स्वीकार नहीं की जाती हैं।

## पहचानें कि आपके पास क्या है

| आप देखते हैं | यह है | उपयोग करें |
| --- | --- | --- |
| `*.session`; इसे टेक्स्ट एडिटर में खोलने पर शीर्ष पर `SQLite format 3` दिखता है | टेलीथॉन या पायरोग्राम SQLite | **फ़ाइलें** (स्वचालित रूप से पता लगाई गई) |
| `tdata` नामक एक फ़ोल्डर जिसमें `key_datas` शामिल है | टेलीग्राम डेस्कटॉप टीडेटा | दो फ़ाइलों को ज़िप करें, फिर **फ़ाइलें** |
| `1` से शुरू होने वाली एक टेक्स्ट लाइन, लगभग 350 अक्षर | टेलीथॉन स्ट्रिंगसेशन | **फ़ाइलें** |
| `512 characters 0-9a-f` की एक टेक्स्ट लाइन, फिर `:` और एक अंक 1–5 | ऑथ कुंजी और डीसी | **फ़ाइलें**, बॉक्स **पासकोड या सत्र टेक्स्ट** |
| `*.json` के साथ `app_id`/`app_hash` | सहायक मेटाडेटा | **फ़ाइलें**, इसके सत्र के साथ |
| `*.json` के साथ `auth_key` या `string_session` | खाता JSON | **फ़ाइलें** |
| 512 वर्ण `0-9a-f` | ऑथ कुंजी | **ऑथ कुंजी** |
| 32 वर्ण `0-9a-f` | एपीआई हैश | **एपीआई आईडी + हैश** |
| TDLib ऐप से `td.binlog` या `db.sqlite` | TDLib स्टोरेज | समर्थित नहीं |
| `123456789:AA…` | बॉट टोकन | समर्थित नहीं |

## असमर्थित प्रारूप

| फ़ॉर्मेट | वैकल्पिक |
| --- | --- |
| TDLib स्टोरेज (`td.binlog`) और TDLib एक्सपोर्ट्स | फ़ोन या QR से साइन इन करें |
| पायरोग्राम सत्र स्ट्रिंग्स | Pyrogram फ़ाइल `.session` का उपयोग करें, या फ़ोन/QR |
| कई लॉग-इन खातों वाला TData | Telegram Desktop में अन्य खातों से लॉग आउट करें, या प्रत्येक खाते की अपनी सत्र फ़ाइल का उपयोग करें |
| बॉट टोकन | समर्थित नहीं: TgWitness एक उपयोगकर्ता खाते के रूप में अवलोकन करता है |
| कई खातों की CSV/JSON सूचियाँ | **खाते → खातों को आयात करें** के माध्यम से समर्थित सेशन फ़ाइलें आयात करें, या अलग-अलग वर्कस्पेस में फ़ोन/QR द्वारा साइन इन करें |
| टेस्ट-डीसी या बॉट सत्र | एक प्रोडक्शन उपयोगकर्ता खाता उपयोग करें |

## कई खाते

खाता चयनकर्ता के बगल में **+** दबाएँ, या खोलें **अधिक उपकरण → खाता → सेटिंग्स → कनेक्शन सेटिंग्स → वर्कस्पेस**, एक लेबल दर्ज करें और साइन इन करें।

- मुख्य सहित किसी भी संख्या में वर्कस्पेस। प्रत्येक का अपना सत्र, प्रॉक्सी मार्ग, स्रोत, कैप्चर नीति, जर्नल, हस्ताक्षर कुंजी, चेकपॉइंट और एक्सपोर्ट होते हैं।
- प्रदर्शित कार्यक्षेत्र को बदलने से अन्य कार्यक्षेत्र रुके नहीं हैं।
- एक जर्नल उसे बनाने वाले खाते से बंधा रहता है। एक अलग खाते से साइन इन करने के लिए एक अन्य वर्कस्पेस की आवश्यकता होती है, और एक खाते को दो वर्कस्पेस में असाइन नहीं किया जा सकता।
- मुख्य पैनल टोकन सभी वर्कस्पेस को नियंत्रित करता है। [जारी की गई पहुँच](https://phishdestroy.io/tgwitness/hi/docs/reference/access/) अन्य लोगों को चयनित खातों और चैट्स तक सीमित कर सकती है, अलग-अलग अनुमतियों और सत्र सीमाओं के साथ।
- **अकाउंट्स** एक वर्कस्पेस का नाम बदलता है और एक जोड़े गए वर्कस्पेस को उसके सत्र, जर्नल, स्रोतों और साइनिंग की के साथ हटा देता है। मुख्य वर्कस्पेस को पैनल से हटाया नहीं जा सकता।

### एक साथ आयात और खाता समूह

एकाधिक खाते जोड़ने, फ़ाइलों को बेसनेम के अनुसार जोड़ी बनाने और प्रत्येक लॉगिन परिणाम को देखने के लिए **खातों → खाते आयात करें**का उपयोग करें। प्रत्येक खाते को अपना स्वयं का वर्कस्पेस मिलता है।

एक समूह संबंधित खातों को उनके सत्रों, कुंजियों या साक्ष्यों को मर्ज किए बिना एक साथ रखता है। **खातों** पर **समूह खोलने से** यह उसके पृष्ठ पर ले जाता है `/groups/<id>`:

- **खाते:** प्रत्येक सदस्य का कनेक्शन मार्ग, अवलोकन और अंतिम संदेश, साथ ही **सभी** प्रारंभ करें और **सभी को रोकें**।
- **ध्यान देने की ज़रूरत:** वे खाते जो साइन आउट किए गए हैं, अनुपलब्ध हैं या जिनमें कनेक्शन, इनटेक, स्रोत या मीडिया की समस्या है; प्रत्येक नाम उसके कार्ड की ओर ले जाता है।
- **चैट्स कई खाते देख सकते हैं:** साझा स्रोत, उन्हें देखने वाले खाते और उपलब्ध कार्यक्षेत्र-निरीक्षण अवधि (सात दिनों तक) में रुकावटें। **N खातों के साथ एक्सपोर्ट** एक चैनल या सुपरग्रुप एक्सपोर्ट को उनके बीच विभाजित करता है और एक आर्काइव पर हस्ताक्षर करता है।
- **समूह निर्यात:** प्रत्येक खाते के हस्ताक्षरित एक्सपोर्ट के साथ एक ZIP `accounts/` और `manifest.json` उनके SHA-256 और कुंजी फिंगरप्रिंट्स की सूची, मुख्य द्वारा हस्ताक्षरित कार्यक्षेत्र में `manifest.signature.json`प्रत्येक खाते के आर्काइव को उसके स्वयं के साथ सत्यापित करें `python -m tgwitness.verify` और उस खाते के विश्वसनीय फिंगरप्रिंट के साथ।

सदस्य समूह की सेटिंग्स साझा करते हैं; एक खाता अपने स्वयं के मान रख सकता है। [साझा सेटिंग्स](https://phishdestroy.io/tgwitness/hi/docs/reference/settings/#account-groups), [आयात और समूह गाइड](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) और [MTProxy पूल डैशबोर्ड](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources) देखें।

## साइन आउट

**अधिक उपकरण → खाता → टेलीग्राम से साइन आउट करें** (निरीक्षण रुका हुआ) टेलीग्राम से सत्र समाप्त करने के लिए कहता है, ताकि यह खाते की **सेटिंग्स → डिवाइस** से भी गायब हो जाए, और कार्यक्षेत्र तिजोरी से सत्र को हटा दे। जर्नल, स्रोत, सेटिंग्स और हस्ताक्षर कुंजी बनी रहती हैं, और जर्नल साइन-आउट को रिकॉर्ड करता है। वर्कस्पेस अभी भी उसके खाते का है: केवल वही खाता फिर से इससे जुड़ सकता है। यदि टेलीग्राम जवाब नहीं देता है, तो सत्र यहां से हटा दिया जाता है और पैनल ऐसा बताता है; टेलीग्राम में **सेटिंग्स → डिवाइस** के तहत इसे समाप्त करें।

## जब टेलीग्राम सत्र समाप्त करता है

यदि टेलीग्राम खाते पर प्रतिबंध लगाता है, उसे फ्रीज करता है या साइन आउट करता है, या किसी अन्य डिवाइस से सत्र समाप्त करता है, तो जर्नल कारण, टेलीग्राम त्रुटि, मार्ग और डेटा सेंटर को रिकॉर्ड करता है। खाते की स्वास्थ्य स्थिति में **'खाता हानि रिपोर्ट डाउनलोड करें**' दिखाई देता है: यह हानि से पहले के 24 घंटों के जर्नल रिकॉर्ड वाली एक हस्ताक्षरित JSON फ़ाइल है, जिसमें कनेक्शन, मार्ग, सत्र, खाते के नोटिस और कवरेज गैप शामिल हैं, प्रत्येक अपने जर्नल हैश और हस्ताक्षर के साथ। इसकी जाँच करें `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`; सबूत निर्यात में पूरी हैश चेन होती है। एक फ्रीज़ किए गए खाते का पता भी तब लगता है जब वह कनेक्ट होता है और निरीक्षण के दौरान, और इसकी भेजने और जुड़ने की क्रियाएं बंद कर दी जाती हैं।

## खाता फ़ाइलों को सुरक्षित रखना

- हर `.session`, TData ZIP, StringSession, Auth Key और account JSON को एक पासवर्ड की तरह मानें। TgWitness आयातित प्राधिकरण को अपने एन्क्रिप्टेड वॉल्ट में रखता है; आप बाद में मूल फ़ाइलें हटा सकते हैं।
- एक ही प्राधिकरण को एक साथ दो प्रोग्रामों में न चलाएँ। टेलीग्राम इसे रद्द कर सकता है (`AUTH_KEY_DUPLICATED`), और दोनों प्रतियाँ काम करना बंद कर देंगी।
- समाप्त या रद्द किया गया सत्र रूपांतरण द्वारा पुनर्जीवित नहीं किया जा सकता। फिर से साइन इन करें।

## समस्या निवारण

| संदेश या लक्षण | क्या करें |
| --- | --- |
| *इस सत्र को पढ़ा नहीं जा सकता। इसके मूल क्लाइंट को बंद करें…* | SQLite फ़ाइल खुली या अधूरी है (`-journal`/`-wal` साइडकार)। मूल प्रोग्राम को साफ़-सुथरे तरीके से बंद करें और फ़ाइल को फिर से कॉपी करें। |
| *समर्थित टेलीथॉन SQLite स्कीमा: 7 और 8* / *पायरोग्राम … 2 और 3* | फ़ाइल किसी बहुत पुराने या अज्ञात लाइब्रेरी संस्करण द्वारा बनाई गई थी। इसके बजाय फोन/QR से साइन इन करें। |
| *केवल अधिकृत प्रोडक्शन उपयोगकर्ता सत्रों का ही समर्थन किया जाता है* | Pyrogram फ़ाइल किसी बॉट या परीक्षण नेटवर्क से संबंधित है। |
| *TData आर्काइव 512 प्रविष्टियों या 32 MiB से अधिक हो गया है* | केवल ZIP `key_datas` और `D877F783D5D3EF8Cs`, पूरा फ़ोल्डर नहीं। |
| *TData को डिक्रिप्ट नहीं किया जा सकता। डेस्कटॉप स्थानीय पासकोड की जाँच करें।* | **Passcode या session टेक्स्ट** में Telegram Desktop का स्थानीय पासकोड दर्ज करें। |
| *एक समय में एक TData खाते को आयात करें* | Telegram Desktop के कई खाते थे; [असमर्थित प्रारूप](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#unsupported-formats) देखें। |
| *चुनी गई फ़ाइलें विभिन्न खातों या API क्रेडेंशियल्स का वर्णन करती हैं* | केवल एक खाते की फ़ाइलें चुनें। |
| *JSON में कोई समर्थित API क्रेडेंशियल या प्राधिकरण शामिल नहीं है।* | [Account JSON](https://phishdestroy.io/tgwitness/hi/docs/reference/accounts/#account-json) में फ़ील्ड नामों की जाँच करें। |
| *केवल API मेटाडेटा* | JSON में कोई सत्र नहीं है। `.session` फ़ाइल जोड़ें या फ़ोन/QR का उपयोग करें। |
| *Auth Key HEX में सभी 512 हेक्साडेसिमल अक्षर शामिल होने चाहिए* | कुंजी संक्षिप्त की गई है या इसमें `…` शामिल है। |
| खाता आईडी आयात किए गए खाते से मेल नहीं खाता | फ़ाइल का उपयोगकर्ता आईडी टेलीग्राम द्वारा रिपोर्ट किए गए आईडी से भिन्न है; यह फ़ाइल किसी अन्य खाते के लिए है। |
| खाता पहले से ही किसी अन्य कार्यक्षेत्र का है | खाते को दो बार जोड़ने के बजाय उस वर्कस्पेस को खोलें। |
| कनेक्टेड, लेकिन **More tools → Sources** में चैट सूची से एक निजी समूह गायब है। | सदस्यता की जाँच करें। पिकर पहले 1,000 डायलॉगों का निरीक्षण करता है; **More tools → Parameters** के अंतर्गत सीमा बढ़ाएँ। |
| प्रॉक्सी कनेक्शन विफल | रूट और आईपी मोड की जाँच करें। स्वचालित MTProxy दूसरी कार्यशील प्रविष्टि आज़माता है। Hide the address waits; Direct as a last resort कॉन्फ़िगर की गई देरी के बाद सीधे कनेक्ट कर सकता है। [राउटिंग मोड](https://phishdestroy.io/tgwitness/hi/docs/reference/connection/#ip-modes) देखें। |

यह भी देखें: प्रॉक्सी और एन्क्रिप्शन के लिए [कनेक्शन और सुरक्षा](https://phishdestroy.io/tgwitness/hi/docs/reference/connection/), और साइन-इन के बाद क्या कैप्चर किया जाता है, इसके लिए [संग्रह कैसे काम करता है](https://phishdestroy.io/tgwitness/hi/docs/reference/collection/)।
