TgWitness / दस्तावेज़ीकरण

क्या परीक्षण किया गया है →

संदर्भ / सेटअप

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

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

टीजीविटनेस / दस्तावेज़ीकरण · शुरुआत करना

शुरुआत करना

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

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

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

एक नज़र में#

आपके पास क्या है खाता जोड़ें टैब आपको इनकी भी आवश्यकता होगी
फ़ोन नंबर और उसके लॉगिन कोड्स तक पहुँच फ़ोन यदि सक्षम हो तो 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 कैटलॉग से एक निर्धारणात्मक डिवाइस/ओएस जोड़ी का उपयोग करते हैं: डेस्कटॉप 2040, एंड्रॉइड 6, एंड्रॉइड X 21724, आईओएस 10840, मैकओएस 2834, और वेब 2496। एंड्रॉइड का सोर्स-बिल्ड आईडी 4 भी एंड्रॉइड कैटलॉग का उपयोग करता है, जैसा कि Telegram Android के BuildVars में पहचाना गया है। वेब डिफ़ॉल्ट रूप से 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 एल्गोरिथम (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) बाद के अनुरोधों को रोकता है; एक अनुपस्थित परिणाम अज्ञात बना रहता है। नेटवर्क जाँचों को छोड़ दिया जाता है, जबकि स्थानीय जाँचें अभी भी अपने परिणाम रिपोर्ट कर सकती हैं। सख्त चुनी हुई चैट्स चालू होने पर, वर्तमान अधिकृतण का अनुरोध नहीं किया जाता है और उस जाँच को छोड़ा हुआ दिखाया जाता है।

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

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

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

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

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

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

  1. 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।

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

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

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

एक प्रमाणित डिप्लॉयमेंट (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 त्रुटि डेटाबेस 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 देखें।

टेलीग्राम डेस्कटॉप (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 दस्तावेज़ देखें।

  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) के 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 द्वारा साइन इन करें
टेस्ट-डीसी या बॉट सत्र एक प्रोडक्शन उपयोगकर्ता खाता उपयोग करें

कई खाते#

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

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

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

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

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

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

सदस्य समूह की सेटिंग्स साझा करते हैं; एक खाता अपने स्वयं के मान रख सकता है। साझा सेटिंग्स, आयात और समूह गाइड और MTProxy पूल डैशबोर्ड देखें।

साइन आउट#

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

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

यदि टेलीग्राम खाते पर प्रतिबंध लगाता है, उसे फ्रीज करता है या साइन आउट करता है, या किसी अन्य डिवाइस से सत्र समाप्त करता है, तो जर्नल कारण, टेलीग्राम त्रुटि, मार्ग और डेटा सेंटर को रिकॉर्ड करता है। खाते की स्वास्थ्य स्थिति में 'खाता हानि रिपोर्ट डाउनलोड करें' दिखाई देता है: यह हानि से पहले के 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 के कई खाते थे; असमर्थित प्रारूप देखें।
चुनी गई फ़ाइलें विभिन्न खातों या API क्रेडेंशियल्स का वर्णन करती हैं केवल एक खाते की फ़ाइलें चुनें।
JSON में कोई समर्थित API क्रेडेंशियल या प्राधिकरण शामिल नहीं है। 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 कॉन्फ़िगर की गई देरी के बाद सीधे कनेक्ट कर सकता है। राउटिंग मोड देखें।

यह भी देखें: प्रॉक्सी और एन्क्रिप्शन के लिए कनेक्शन और सुरक्षा, और साइन-इन के बाद क्या कैप्चर किया जाता है, इसके लिए संग्रह कैसे काम करता है।