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

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

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

[!चेतावनी] किसी भी ऐसी चीज़ का उपयोग न करें जिसे आप खोने का जोखिम नहीं उठा सकते। हम व्यक्तिगत या अन्यथा मूल्यवान खातों को जोड़ने, और किसी ऐसे खाते पर API ID / API हैश बनाने के खिलाफ दृढ़ता से सलाह देते हैं जिसे आप महत्व देते हैं। यह TgWitness के परीक्षण न किए जाने के बारे में नहीं है: टेलीग्राम अनिश्चित रूप से खातों को प्रतिबंधित करता है और स्थायी रूप से ब्लॉक कर देता है — अनुरोधों की उस मात्रा के लिए जिसे वह अत्यधिक मानता है, क्लाइंट या उद्देश्य की परवाह किए बिना, और बिना किसी पर्याप्त दस्तावेज़ीकरण के। कई प्रतिबंध अपरिवर्तनीय होते हैं। समर्पित खाते का उपयोग करें। सुचारू परीक्षण रन टेलीग्राम पर निर्भर करते हैं, न कि सॉफ़्टवेयर पर, और भविष्य के लिए कोई गारंटी नहीं देते हैं।

• एक नज़र में
• शुरू करने से पहले: एपीआई आईडी और एपीआई हैश
• फ़ोन नंबर · क्यूआर कोड · ऑथ कुंजी + डीसी आईडी
• खाता फ़ाइलें: टेलीथॉन .सेशन · पायरोग्राम .सेशन · सत्र + JSON जोड़ी · टीडेटा · स्ट्रिंगसेशन · खाता JSON
• पहचानें कि आपके पास क्या है · असमर्थित प्रारूप
• कई खाते · खाता फ़ाइलों को सुरक्षित रखना · समस्या निवारण

एक नज़र में#

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

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

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

इसके बजाय अपना स्वयं का एप्लिकेशन उपयोग करने के लिए (जिसे पंजीकृत करने वाला खाता जोखिम में है; देखें: अंतर्निहित 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 में पेस्ट कर सकते हैं और दोनों फ़ील्ड भर जाएँगे। एक जोड़ी का उपयोग आपके सभी खातों के लिए किया जा सकता है। सफल लॉगिन के बाद यह केवल उसी वर्कस्पेस में सहेजा, एन्क्रिप्ट किया जाता है और कभी भी ब्राउज़र में वापस नहीं भेजा जाता है।

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

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

फ़ोन नंबर#

1. खाता खोलें, फ़ोन टैब पर जाएँ, और नंबर अंतरराष्ट्रीय प्रारूप में दर्ज करें, उदाहरण के लिए +44 7700 900123। रिक्त स्थान और डैश स्वचालित रूप से हटा दिए जाते हैं।
2. Continue दबाएँ। API ID + हैश खाली रह सकते हैं।
3. Telegram द्वारा भेजा गया कोड दर्ज करें (आमतौर पर Telegram ऐप में; SMS की गारंटी नहीं)।
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 सर्वर की मेमोरी में ही परिवर्तित की जाती हैं। अपलोड्स संग्रहीत नहीं किए जाते, ZIP फ़ाइलें डिस्क पर एक्सट्रेक्ट नहीं की जातीं और किसी भी बाहरी सेवा से संपर्क नहीं किया जाता।
• फिर इस सत्र की जाँच टेलीग्राम के साथ की जाती है। यदि कोई फ़ाइल उपयोगकर्ता आईडी बताती है, तो उसका मिलान टेलीग्राम द्वारा रिपोर्ट किए गए खाते से होना चाहिए।
• विभिन्न खातों या विभिन्न API क्रेडेंशियल्स का वर्णन करने वाली फ़ाइलें अस्वीकार की जाती हैं, एक को चुनने के बजाय।
• पासकोड या सत्र टेक्स्ट में TData स्थानीय पासकोड फ़ील्ड होता है, जो बिना साइन इन किए स्ट्रिंगसेशन और रीड फ़ाइलें पेस्ट करने के लिए एक बॉक्स है (टेलिग्राम से संपर्क किए बिना फ़ॉर्म भरता है)।

टेलीथन .session#

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

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

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

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

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

• JSON से, TgWitness app_id/api_id और app_hash/api_hash का उपयोग करता है, इसलिए आपको आमतौर पर API क्रेडेंशियल टाइप नहीं करने पड़ते।
• phone, device, sdk, app_version, lang_pack या संग्रहीत twoFA पासवर्ड जैसे अन्य फ़ील्ड्स को अनदेखा किया जाता है। यदि खाते में 2FA है, तो TgWitness इसे माँगता है।
• एक JSON अपने आप में केवल मेटाडेटा है। सत्र फ़ाइल के बिना, फ़ोन या QR लॉगिन से जारी रखें।

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

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

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

समांतर सत्र चेतावनी। TData आयात करने से टेलीग्राम डेस्कटॉप की प्राधिकरण कुंजी का पुन: उपयोग होता है; यह एक स्वतंत्र लॉगिन नहीं बनाता है। उस कुंजी का डेस्कटॉप और TgWitness में एक साथ उपयोग न करें। टेलीग्राम AUTH_KEY_DUPLICATED के साथ प्राधिकरण को अमान्य कर सकता है, जिससे नई लॉगिन तक दोनों प्रतियां अनुपयोगी हो जाएंगी।

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

खाता JSON#

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

यदि उपनाम और मुख्य नाम दोनों मौजूद हैं, तो उन्हें मेल खाना चाहिए। उदाहरण:

{ "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 ऐरे) स्वीकार नहीं की जाती हैं।

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

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

कई खाते#

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

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

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

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

साइन आउट#

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

एक टेलीथॉन सत्र को ऑफ़लाइन कन्वर्ट करें#

पैनल सीधे .session फ़ाइलों को आयात करता है। ऑफ़लाइन कनवर्ज़न के लिए StringSession फ़ाइल में, प्रोजेक्ट फ़ोल्डर से चलाएँ:

.venv\Scripts\python.exe -m tgwitness.sessions account.session --out account.tgwitness-session   # Windows

.venv/bin/python -m tgwitness.sessions account.session --out account.tgwitness-session          # Linux/macOS

कनवर्टर केवल टेलीथॉन SQLite (64 MiB तक) पढ़ता है, इनपुट को कभी भी संशोधित नहीं करता, कोई नेटवर्क अनुरोध नहीं करता और मौजूदा आउटपुट फ़ाइल को ओवरराइट करने से इनकार करता है।

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

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

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

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