حوالہ / سیٹ اپ
Telegram · اکاؤنٹس اور سیشن فارمیٹس
فون، QR کوڈ یا auth کلید کے ذریعے سائن ان کریں، Telethon، Pyrogram یا Telegram Desktop سیشنز کو امپورٹ کریں، اور متعدد اکاؤنٹس چلائیں۔
ٹی جی وٹنس / دستاویزات · شروع کرنا
TgWitness MTProto کے ذریعے ایک ٹیلیگرام صارف اکاؤنٹ (بوٹ نہیں) کے طور پر سائن ان کرتا ہے، Telethon استعمال کرتے ہوئے۔ ہر اکاؤنٹ اپنے مخصوص ورک اسپیس (جسے API اور کمانڈ لائن ٹولز میں ورک اسپیس کہا جاتا ہے) میں موجود ہوتا ہے، جس کا اپنا سیشن، ذرائع، جرنل اور دستخطی کلید ہوتی ہے۔
سیشن فائلز، سیشن سٹرنگز اور آتھ کیز اکاؤنٹ کی اجازت نامے ہیں: جو بھی ان میں سے کسی کو اپنے پاس رکھے وہ اس اکاؤنٹ کے طور پر کام کر سکتا ہے۔ ان میں پیغامات کی تاریخ شامل نہیں ہوتی۔
[!انتباہ] مخصوص اکاؤنٹس استعمال کریں۔ ٹیلیگرام ایسے اکاؤنٹس کو محدود کرتی ہے اور مستقل طور پر بلاک بھی کر سکتی ہے جن کے لیے وہ درخواستوں کے حجم کو حد سے زیادہ سمجھتی ہے، چاہے کلائنٹ یا مقصد کچھ بھی ہو، اور ان حدود کو صرف جزوی طور پر دستاویزی شکل دیتی ہے۔ ذاتی یا کسی اور قسم کے قیمتی اکاؤنٹس کے بجائے مشاہدے کے لیے تیار کردہ اکاؤنٹس سے کنیکٹ کریں، اور ایک مخصوص اکاؤنٹ پر API ID / API ہیش بنائیں۔
- ایک نظر میں
- شروع کرنے سے پہلے: API ID اور API ہیش
- فون نمبر · کیو آر کوڈ · آتھ کی + ڈی سی آئی ڈی
- اکاؤنٹ فائلیں: ٹیلی تھون .سیشن · پائروگرام .سیشن · سیشن + JSON جوڑا · TData · اسٹرنگ سیشن · Auth کلید اور DC ایک ہی لائن میں · اکاؤنٹ JSON
- پہچانیں کہ آپ کے پاس کیا ہے · غیر معاونت یافتہ فارمیٹس
- متعدد اکاؤنٹس · اکاؤنٹ فائلوں کو محفوظ رکھنا · مسئلہ حل کرنا
ایک نظر میں#
| آپ کے پاس کیا ہے | اکاؤنٹ شامل کریں ٹیب | آپ کو یہ بھی درکار ہوگا |
|---|---|---|
| فون نمبر اور اس کے لاگ ان کوڈز تک رسائی | فون | اگر فعال ہو تو 2FA پاس ورڈ |
| ٹیلیگرام دوسری ڈیوائس پر کھلا ہوا | کیو آر کوڈ | اگر فعال ہو تو 2FA پاس ورڈ |
.sessionفائل (Telethon یا Pyrogram) |
فائلیں | ایپ سیٹنگز کے لیے اختیاری JSON |
.session + .json ایک ہی نام کے ساتھ |
فائلیں (دونوں منتخب کریں) | عام طور پر کچھ نہیں |
ٹیلیگرام ڈیسک ٹاپ کا tdata فولڈر |
فائلیں (ZIP کے طور پر) | اگر ڈیسک ٹاپ کا مقامی پاس کوڈ مقرر ہو تو |
ایک ٹیلی تھون سٹرنگ سیشن (متن، .txt، .tgwitness-session) |
فائلیں | الگ API جوڑے کی ضرورت نہیں |
ایک auth کلید اور DC ایک ہی لائن میں، <512 hex>:<1–5> |
فائلیں (پیسٹ یا ٹیکسٹ فائل) | الگ API جوڑے کی ضرورت نہیں |
.json، سیشن یا آتھ کی کے ساتھ |
فائلیں | الگ API جوڑے کی ضرورت نہیں |
| ایک آتھ کی (512 ہیکس اکر) اور اس کا ڈی سی نمبر | آتھ کی | اختیاری صارف شناختی نام |
TgWitness فائلوں کو ان کے ناموں کی بجائے ان کے مواد کی بنیاد پر پہچانتا ہے۔ فائل کا نام تبدیل کرنے سے وہ کبھی تبدیل نہیں ہوتی۔
شروع کرنے سے پہلے: API ID اور API ہیش#
آپ ٹیلیگرام API ایپلیکیشن بنائے بغیر سائن ان کر سکتے ہیں۔ جب ورک اسپیس میں کوئی جوڑا درج نہ ہو، درآمد یا پہلے سے محفوظ نہ ہو، تو TgWitness اپنے اندرونی پول سے 50 عوامی API جوڑوں میں سے ایک جوڑا منتخب کرتا ہے (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 کیٹلاگز سے ایک ڈیٹرمنسٹک ڈیوائس/OS جوڑے کا استعمال کرتے ہیں:
ڈیسک ٹاپ 2040، اینڈرائیڈ 6، اینڈرائیڈ X 21724، iOS 10840، macOS 2834، اور ویب 2496۔
اینڈرائیڈ کا سورس-بلڈ ID 4 بھی اینڈرائیڈ کیٹلاگ استعمال کرتا ہے، جیسا کہ Telegram Android کے BuildVars میں شناخت کیا گیا ہے۔
ویب بطورِ ڈیفالٹ A ہے؛ ایک درآمد شدہ K ایپ-ورژن سفیکس یا macos لینگویج پیک K کو منتخب کرتا ہے، اور ورژن 0.7.0 ویبوگرام کو منتخب کرتا ہے۔ نامعلوم ایپلیکیشن IDs ٹیلی تھون کے ہوسٹ ڈیفالٹس کو برقرار رکھتی ہیں۔ درآمد شدہ فیلڈز ہمیشہ غالب رہتی ہیں، بشمول پرانا ایپ ورژن اور خالی لینگویج پیک۔ کیٹلاگ کبھی بھی API ID/ہیش کو تبدیل نہیں کرتا۔ اس کا ورژن سنپ شاٹ واضح طور پر جائزہ لیا جاتا ہے، لاگ ان کے دوران حاصل نہیں کیا جاتا۔ ایک محفوظ شدہ پروفائل اپ ڈیٹس کے بعد مستحکم رہتا ہے۔
account.getAuthorizations ٹیلیگرام کے محفوظ شدہ اجازت نامے کے میٹا ڈیٹا کی رپورٹ کرتا ہے؛ یہ ہر نئے initConnection کی عکاسی نہیں کرتا۔ اسے اصل بھیجے گئے پروفائل سے موازنہ کریں۔
موجودہ اجازت نامے کو منسلک کرنے سے اس کے ہمراہ API ہیش کی توثیق نہیں ہوتی:
initConnection API ID بھیجتا ہے، جبکہ ہیش لاگ ان درخواستوں کے لیے استعمال ہوتا ہے۔
نئے فون یا QR کی تصدیق کے بعد، TgWitness کنفیگ، قریب ترین ڈی سی، آن لائن اسٹیٹس، زبانیں (جب لینگویج پیک خالی نہ ہو)، ایپ اپ ڈیٹس اور سروس کی شرائط کی اپ ڈیٹس کی درخواست کرتا ہے، درخواستوں کے درمیان 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 کنفیگ، قریب ترین ڈی سی، موجودہ اجازت، جائزہ شدہ لیئر بیس لائن، زبانیں، ایپ اپ ڈیٹس اور سروس کی شرائط کی اپ ڈیٹس چیک کرتا ہے۔ یہ تشخیصات ہر کلائنٹ کی مثال کے لیے ایک بار، کلیکشن سے پہلے چلتی ہیں، اور اپنے وقت کے ساتھ کنکشن کی تفصیلات کے تحت دکھائی جاتی ہیں۔
account.connection_checked سیشن ہیشز، آئی پیز، ٹوکنز یا اے پی آئی ہیشز کے بغیر نتیجہ ریکارڈ کرتا ہے۔ یہ کبھی بھی شرائط قبول نہیں کرتیں یا اپ ڈیٹس انسٹال نہیں کرتیں۔ ایک درخواست کی ناکامی یا FloodWait بعد کی درخواستوں کو روک دیتا ہے؛ ایک غائب نتیجہ نامعلوم ہی رہتا ہے۔
مقامی چیکس اب بھی اپنے نتائج رپورٹ کر سکتے ہیں جبکہ نیٹ ورک چیکس کو چھوڑ دیا جاتا ہے۔
سخت منتخب چیٹس آن ہونے کی صورت میں، موجودہ
اجازت طلب نہیں کی جاتی اور اس چیک کو چھوڑا ہوا دکھایا جاتا ہے۔
سائن ان کرنے کے بعد اور ہر نئے کنکشن پر، ٹی جی وِٹنیس اکاؤنٹ کی حساس مواد کی سیٹنگ پڑھتا ہے۔ جب یہ بند ہو اور ٹیلیگرام تبدیلی کی اجازت دے، تو TgWitness اسے آن کر دیتا ہے تاکہ ٹیلیگرام کی جانب سے حساس (18+) قرار دی گئی مواد محفوظ ہو سکے، اور
account.content_settings کو ریکارڈ کرے۔ یہ سیٹنگ اکاؤنٹ کی ملکیت ہے اور ہر ٹیلیگرام ایپ میں لاگو ہوتی ہے۔ منتخب کردہ سخت چیٹس اسے متاثر نہیں کرتیں؛ سائن ان کرنے سے پہلے اسے آن کر لیں۔
ایک ورک اسپیس کے کنکشن کو بحال کرنے کی متوازی درخواستیں ایک ہی کلائنٹ کو شیئر کرتی ہیں اور اس کے کنکشن سیٹ اپ کے مکمل ہونے کا انتظار کرتی ہیں۔ ایک ناکام یا منسوخ شدہ کوشش اگلی درخواست کو دوبارہ کوشش کرنے کے لیے آزاد کر دیتی ہے۔ اگر سیٹ اپ کے دوران محفوظ شدہ اسناد، کلائنٹ یا اجازت کی حالت تبدیل ہو جائے تو پرانی کوشش ایک تیار کنکشن کی رپورٹ کرنے کے بجائے رک جاتی ہے۔
FloodWait تشخیص میں ناکام TL طریقہ، کوئی بھی Takeout/range ریپرز، سرور کی درخواست کردہ انتظار اور مؤثر ڈیڈ لائن کو telegram.backoff میں برقرار رکھا جاتا ہے۔ کنکشن کی تفصیلات میں طریقہ اور ڈیڈ لائن دکھائی جاتی ہے جب درخواستیں معطل ہوں۔ تشخیص میں ہر طریقہ کے لیے کلائنٹ کال کاؤنٹرز شامل ہیں جب سے وہ کلائنٹ بنایا گیا ہے؛ یہ نیسٹڈ پیئر ریزولوشن کو علیحدہ طور پر گنتے ہیں، لیکن پیکٹس یا Telethon کی اندرونی دوبارہ کوششوں کو نہیں گنتے۔ موجودہ کاؤنٹرز اسٹیٹس API میں
collector.rpc_activity کے طور پر بھی دستیاب ہیں۔ کوئی درخواست کے دلائل، صارف کے نام، رسائی کے ہیشز یا استثنا کا متن شامل نہیں کیا جاتا ہے۔ آخری تشخیص اور مکمل ڈیڈ لائن ری اسٹارٹ کے بعد بھی برقرار رہتی ہے۔ پہلے کے انتظار جن میں طریقہ کار کا ریکارڈ نہیں ہوتا، ان کی بعد میں شناخت نہیں کی جا سکتی۔ ماخذ کے جائزے کے لیے برآمد کی حدیں اور دریافت اور تاریخ کے حصول کے درمیان فرق دیکھیں۔
official_app=True یا False ٹیلیگرام کا موجودہ اجازت نامہ کا فلیگ ہے۔ ان میں سے کوئی بھی
قدر یہ طے نہیں کرتی کہ اکاؤنٹ محدود ہے، قابلِ اعتماد ہے یا نگرانی کے تحت ہے۔
موجودہ ثبوت-موڈ کے account.devices کے اسنیپ شاٹس تمام
سائن ان شدہ ڈیوائسز کی تاریخ کو برقرار رکھتے ہیں؛ کنکشن کی تشخیص صرف موجودہ ڈیوائس کی تفصیل کو برقرار رکھتی ہے۔
کنکشن سے پہلے، مشاورتی چیکس API پلیٹ فارم، لینگویج پیک، ڈیوائس/آپریٹنگ سسٹم اور ایپ-ورژن فارمیٹس، موبائل سسٹم لوکل، اور ٹیلی تھون کی اصل اسکیما لیئر کا موازنہ جائزہ شدہ کیٹلاگ بیس لائن سے کرتی ہیں۔ انتباہات سرور لاگ اور اکاؤنٹ اسٹیٹس میٹا ڈیٹا میں ظاہر ہوتے ہیں؛ یہ کبھی بھی درآمد شدہ قدروں کو تبدیل نہیں کرتے یا اسکیما لیئر کو تبدیل نہیں کرتے۔ ایک مختلف لیئر مطابقت کا جائزہ لینے کا اشارہ ہے؛ اکاؤنٹ کی اپنی کنکشن اسٹیٹس بتاتی ہے کہ آیا یہ کام کر رہا ہے۔ ٹیلیگرام اپنی جانب سے پابندیاں طے کرتا ہے، چاہے کوئی بھی کلائنٹ پروفائل استعمال ہو۔ منقطع اکاؤنٹ کی حیثیت ایک اور ڈیوائس کی تفصیل بنانے کے بجائے محفوظ شدہ پروفائل استعمال کرتی ہے۔
اس کے بجائے اپنا ایپلیکیشن استعمال کرنے کے لیے:
- اپنا my.telegram.org کھولیں اور اپنے کسی بھی فون نمبر سے سائن ان کریں۔ کوڈ Telegram ایپ میں آتا ہے، SMS کے ذریعے نہیں۔
- API ترقی کے اوزار منتخب کریں۔
- ایک ایپلیکیشن بنائیں: کوئی بھی عنوان اور مختصر نام (5–32 حروف)، پلیٹ فارم: ڈیسک ٹاپ۔ URL اور وضاحت خالی رہ سکتی ہیں۔
- ایپ کا api_id (ایک عدد) اور api_hash (32 ہیکساڈیسمل حروف) کاپی کریں۔
پینل میں، سائن ان فارم کے نیچے اوپن API ID + ہیش۔ آپ ایک واحد
api_id:api_hash جوڑا API ID میں پیسٹ کر سکتے ہیں اور دونوں فیلڈز بھر جائیں گے۔ ایک جوڑا
آپ کے تمام اکاؤنٹس کے لیے استعمال کیا جا سکتا ہے۔ کامیاب لاگ ان کے بعد یہ محفوظ، انکرپٹڈ،
صرف اسی ورک اسپیس میں ہوتا ہے اور کبھی بھی براؤزر کو واپس نہیں بھیجا جاتا۔
تین مختلف اسناد ملوث ہیں:
| خفیہ | کھولتا ہے | جہاں یہ موجود ہے |
|---|---|---|
| پینل ٹوکن | ٹی جی وِٹنس ویب پینل | ڈیٹا ڈائریکٹری میں panel-token.txt یا TGWITNESS_TOKEN |
| API آئی ڈی + ہیش | اپنے آپ میں کچھ نہیں؛ ایپ کی شناخت کرتا ہے | بلٹ ان جوڑا، درآمد شدہ ترتیبات، یا my.telegram.org پر آپ کی اپنی ایپ |
| اکاؤنٹ کی اجازت | ٹیلیگرام اکاؤنٹ | فون/QR لاگ ان کے ذریعے تخلیق کیا گیا یا سیشن کے طور پر لایا گیا |
اگر ٹیلیگرام تک رسائی پروکسی کے ذریعے ضروری ہو تو پہلے اسے More tools → Account → Settings → Connection settings → Change connection route میں سیٹ کریں۔
فون نمبر#
- مزید ٹولز کھولیں → اکاؤنٹ، فون ٹیب پر جائیں، اور نمبر بین الاقوامی فارمیٹ میں درج کریں،
مثال کے طور پر
+44 7700 900123۔ خالی جگہیں اور ڈیش خود بخود ہٹا دیے جاتے ہیں۔ - جاری رکھیں پر کلک کریں۔ API ID + ہیش خالی رہ سکتے ہیں۔
- وہ کوڈ درج کریں جو ٹیلیگرام بھیجتا ہے، عام طور پر ٹیلیگرام ایپ میں؛ ٹیلیگرام فیصلہ کرتا ہے کہ SMS بھیجنا ہے یا نہیں۔
- اگر اکاؤنٹ میں دو مرحلوں کی توثیق فعال ہے تو وہ پاس ورڈ درج کریں۔ یہ پینل ٹوکن یا ڈیوائس پاس کوڈ نہیں ہے۔
- لاگ ان کے بعد دکھائی گئی اکاؤنٹ آئی ڈی چیک کریں، پھر ذرائع منتخب کریں۔
لاگ ان کوڈز اور 2FA پاس ورڈ کبھی بھی ڈسک پر محفوظ نہیں کیے جاتے۔
کیو آر کوڈ#
اس کا استعمال اس وقت کریں جب اکاؤنٹ پہلے ہی فون یا کسی دوسرے کمپیوٹر پر سائن ان ہو چکا ہو۔
- QR کوڈ ٹیب → QR کوڈ دکھائیں۔ API ID + ہیش خالی رہ سکتے ہیں۔
- سائن ان شدہ ڈیوائس پر: سیٹنگز → ڈیوائسز → ڈیسک ٹاپ ڈیوائس کو لنک کریں، کوڈ اسکین کریں اور تصدیق کریں۔
- اگر ٹیلیگرام درخواست کرے تو TgWitness میں 2FA پاس ورڈ درج کریں۔
QR تصویر مقامی طور پر تیار کی جاتی ہے۔ کوڈز کی میعاد ختم ہو جاتی ہے؛ دوبارہ کوشش کے لیے 'دوسرا QR کوڈ تیار کریں' پر کلک کریں۔ پینل کو لاک کرنے، ورک اسپیس تبدیل کرنے یا دوسرا لاگ ان شروع کرنے سے زیر التواء کوڈ منسوخ ہو جاتا ہے۔
آتھ کی + ڈی سی آئی ڈی#
ایک آتھ کی ہر ٹیلیگرام سیشن کے پیچھے موجود خام 256 بائٹ کی اجازت ہے، جو 512 ہیکساڈیسمل حروف میں لکھی جاتی ہے، ڈیٹا سینٹر نمبر DC 1–5 کے ساتھ۔
- ٹیب 'Auth key'۔ مکمل کلید چسپاں کریں؛ ایک مختصر کلید جس میں صرف '
…' شامل ہو، کام نہیں کرے گی۔ - کلیدی کے ساتھ فراہم کردہ DC ID منتخب کریں۔
- اختیاری طور پر صارف کی شناخت درج کریں۔ اگر ٹیلیگرام مختلف اکاؤنٹ رپورٹ کرے تو TgWitness کنکشن سے انکار کر دے گا۔
- پریس کنیکٹ اکاؤنٹ۔
ایک آتھ کی (512 حروف) API ہیش (32 حروف) نہیں ہے۔ اسی کلید کو JSON کے طور پر بھی درآمد کیا جا سکتا ہے، دیکھیں اکاؤنٹ JSON۔
اکاؤنٹ فائلیں#
کھولیں 'اکاؤنٹ میں اضافہ' → 'فائلیں' اور ایک ہی اکاؤنٹ سے تعلق رکھنے والی چار فائلیں منتخب کریں (کل 8 MiB)، 'فائلیں چیک کریں' دبائیں، پھر 'اکاؤنٹ کنیکٹ کریں'۔ فائلیں منتخب کرنے یا سیشن کا متن پیسٹ کرنے سے کچھ بھی نہیں بھیجا جاتا؛ 'فائلیں چیک کریں' آپ کی فائلیں آپ کے TgWitness سرور پر بھیجتا ہے، جو انہیں بغیر سائن ان کیے پڑھتا ہے اور جو سیشن ملا ہے وہ دکھاتا ہے۔
فائلز، آتھ کی اور بلک امپورٹ فارم کنکٹ کرنے سے پہلے متوازی سیشن کی وارننگ دکھاتے ہیں۔ ڈیفالٹ کے طور پر درآمد شدہ اجازت نامے دوبارہ استعمال کیے جاتے ہیں۔ جب تک اس کی کی یہاں استعمال میں ہو، اصل کلائنٹ کو بند رکھیں۔ فائلز اور آتھ کی ایک آزاد اجازت نامہ بھی بنانے کی پیشکش کرتے ہیں، جس کی تفصیل نیچے دی گئی ہے۔ بلک امپورٹ اب بھی براہ راست موڈ استعمال کرتا ہے۔ فون اور انٹرایکٹو QR لاگ ان الگ الگ اجازت نامے بناتے ہیں۔ انتباہ کا عنوان درآمد فارم میں دکھائی دیتا رہتا ہے؛ جب فائلیں یا کلید/سیشن سٹرنگ فراہم کی جاتی ہیں تو اس کی مکمل وضاحت خود بخود کھل جاتی ہے۔ اسے پڑھنے کے بعد بند کیا جا سکتا ہے، تاکہ فائل پککر اور کنکشن کنٹرولز فون پر استعمال کے قابل رہیں۔
تصدیق شدہ تعیناتی (Phala Cloud, Intel TDX) درآمد شدہ کلید پر جمع نہیں ہوتی۔ وہاں، فائلز اور Auth کلید صرف ایک آزاد اجازت نامہ منتخب کرنے پر ہی منسلک ہوتی ہیں؛ بڑے پیمانے پر درآمد سے انکار کر دیا جاتا ہے۔ فون اور QR لاگ ان معمول کے مطابق کام کرتے ہیں۔
- فائلیں آپ کے TgWitness سرور کی میموری میں تبدیل کی جاتی ہیں۔ اپلوڈز محفوظ نہیں کیے جاتے، ZIP فائلیں ڈسک پر نکالی نہیں جاتیں اور کسی بیرونی سروس سے رابطہ نہیں کیا جاتا۔
- پیدا ہونے والے سیشن کو پھر ٹیلیگرام کے ساتھ چیک کیا جاتا ہے۔ اگر کسی فائل میں صارف کی شناخت (یوزر آئی ڈی) درج ہو، تو اسے ٹیلیگرام کے رپورٹ کردہ اکاؤنٹ سے میل کھانا چاہیے۔
- وہ فائلیں جو مختلف اکاؤنٹس یا مختلف API کریڈنلز کو بیان کرتی ہیں مسترد کر دی جاتی ہیں ایک کو منتخب کرنے کے بجائے۔
- پاس کوڈ یا سیشن ٹیکسٹ میں TData کا مقامی پاس کوڈ فیلڈ ہوتا ہے، ایک باکس ہے جس میں StringSession کو پیسٹ کیا جاتا ہے اور بغیر سائن ان کیے فائلیں پڑھی جاتی ہیں (فارم کو ٹیلیگرام سے رابطہ کیے بغیر بھرتا ہے). اسٹرنگ سیشن کو پیسٹ کرنے سے منتخب کردہ فائلیں صاف ہو جاتی ہیں، اور فائلیں منتخب کرنے سے پیسٹ شدہ متن صاف ہو جاتا ہے، لہٰذا چیک اور کنکشن تازہ ترین انتخاب استعمال کرتے ہیں۔ پاس کوڈ تبدیل کرنے کے بعد دوبارہ 'فائلیں چیک کریں' دبائیں۔
ایک آزاد اجازت نامہ بنائیں#
درآمد شدہ فائلوں یا ایک Auth Key کو مربوط کرنے سے پہلے ایک آزاد اجازت نامہ بنائیں۔ TgWitness درآمد شدہ ڈونر کو مختصراً مربوط کرتا ہے، اسے نئے کلائنٹ کے QR لاگ ان ٹوکن کی منظوری کے لیے استعمال کرتا ہے، اور منظوری کے فوراً بعد ڈونر کو منقطع کر دیتا ہے۔ نئے کلائنٹ کی اپنی اجازت نامہ کلید اور علیحدہ منتخب کردہ ڈیسک ٹاپ پروفائل ہوتی ہے۔ ڈونر کی فراہم کردہ API کی تصدیق نامے اور ڈیوائس پروفائل صرف ڈونر کنکشن کے لیے استعمال کیے جاتے ہیں۔ کوئی موجودہ اجازت نامہ لاگ آؤٹ یا منسوخ نہیں کیا جاتا۔
اس مرحلے کے دوران عطیہ کنندہ کے اصل کلائنٹ کو مکمل طور پر بند رکھیں۔ ابتدائی کنکشن اب بھی اپنی کاپی شدہ کلید استعمال کرتا ہے، لہٰذا یہ موڈ اس ابتدائی متوازی استعمال کے خطرے کو ختم نہیں کر سکتا۔ ایک بار جب نیا اجازت نامہ منسلک ہو جائے، تو مالک اصل کلائنٹ کو دوبارہ کھول سکتا ہے اور دونوں کو ایک ہی وقت میں استعمال کر سکتا ہے۔ انٹرایکٹو QR کوڈ لاگ ان اصل کلائنٹ کو یہاں اپنی کلید کاپی کیے یا منسلک کیے بغیر لاگ ان کی منظوری دینے کی اجازت دیتا ہے۔
ڈونر سیشن سے لاگ آؤٹ یا ختم نہ کریں۔ جب وہ سیشن جو QR لاگ ان کو منظور کرتا ہے ختم ہوتا ہے، تو ٹیلیگرام بھی اس سیشن کو ختم کر دیتا ہے جسے اس نے منظور کیا تھا؛ لائیو چیک میں نئی اجازت ڈونر کے لاگ آؤٹ کرنے کے ایک سیکنڈ کے اندر رک گئی۔ امپورٹ ڈونر سیشن کو ریکارڈ کرتا ہے (session_origin.approved_by: ڈیوائس، API ID اور تخلیق کا وقت)۔
سیشن کی فہرست اسے نشان زد کرتی ہے، End session اسے مسترد کر دیتا ہے، اور End all other sessions اور Make this the only session اسے سائن ان رکھتے ہیں۔
اگر ٹیلیگرام 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 سے ایک بار حاصل کرتا ہے، جو اسے حذف کر دیتا ہے، اور جب آپ اس اکاؤنٹ کے سیشنز کھولتے ہیں تو اسے دستی بہاؤ والے ڈائیلاگ میں ہی دکھاتا ہے۔ کنکشن صفحہ نوٹ کرتا ہے کہ ایک پاس ورڈ انتظار کر رہا ہے۔ یہ کبھی جرنل میں داخل نہیں ہوتا اور جب تک اسے دکھایا نہ جائے، ری اسٹارٹ کے بعد بھی برقرار رہتا ہے۔
مشاہدے کے دوران نئے سیشنز کی بھی اطلاع دی جاتی ہے: جب ٹیلیگرام کی سیشن لسٹ میں کوئی اندراج شامل ہوتا ہے، تو account.sessions ریکارڈ اسے added کے تحت نامزد کرتا ہے اور پینل اس سنیپ شاٹ سے ڈیوائس، ایپلیکیشن اور ملک کے ساتھ ایک الرٹ اٹھاتا ہے۔
ویٹنس پروب#
مزید ٹولز → اکاؤنٹ → اکاؤنٹ سیکیورٹی → وٹنس پروب چیک کرتا ہے کہ آیا کوئی دوسرا کلائنٹ اس اکاؤنٹ کی اپ ڈیٹس وصول کر رہا ہے۔ ایک دوسرے ورک اسپیس کو ایک مختلف ٹیلیگرام اکاؤنٹ اور اپنی سیشن کی کے ساتھ سائن ان کریں، دونوں اکاؤنٹس کے ساتھ ایک نجی گروپ بنائیں، پھر اس گروپ کو پروب چیٹ کے طور پر اور دوسرے ورک اسپیس کو وٹنس ورک اسپیس کے طور پر منتخب کریں اور پروب آن کر دیں۔ دونوں اکاؤنٹس کے لیے ریڈ-اونلی بند ہونا ضروری ہے، اور وٹنس ورک اسپیس کو مشاہدہ کر رہا ہونا چاہیے۔
مشاہدہ کرتے وقت، یہ ورک اسپیس ہر 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 کے طور پر ریکارڈ کیا جاتا ہے: پینل ایک الرٹ جاری کرتا ہے اور ایونٹ انٹیک کو ناکام قرار دیتا ہے جب تک کہ بعد میں کوئی ایک (ack) براہِ راست نہ پہنچ جائے (connection.restored، وجہ probe_ack_live)۔ کوئی ایک (ack)
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 لاگ ان کے ساتھ جاری رکھیں۔ ایک JSON جس میں سپورٹڈ سیشن یا Auth Key موجود ہو خود بخود اجازت دے سکتا ہے؛ دیکھیں اکاؤنٹ 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 درآمد شدہ سیشن استعمال کر رہا ہو تو اس کاپی کو بند رکھیں۔ بند کریں، لاگ آؤٹ نہ کریں یا سیشن منسوخ نہ کریں: منسوخی درآمد شدہ کاپی کو بھی باطل کر دیتی ہے۔ اگر آپ کو دونوں کلائنٹس چلانے کی ضرورت ہے، تو 'ایک آزاد اجازت نامہ بنائیں' کا انتخاب کریں اور جب تک نیا لاگ ان کامیاب نہ ہو جائے تب تک ڈیسک ٹاپ کو بند رکھیں، یا فون یا QR کے ذریعے TgWitness میں سائن ان کریں۔ ایک مخصوص اکاؤنٹ کی سفارش کی جاتی ہے، لیکن یہ کلون شدہ چابیاں کو متوازی طور پر استعمال کرنے کے لیے محفوظ نہیں بناتا۔
یہ درآمد شدہ پر بھی لاگو ہوتا ہے۔
.sessionفائلیں، StringSession ٹیکسٹ اور Auth Key HEX۔ دیگر کلائنٹس جن کے پاس اپنی آزادانہ طور پر بنائی گئی اجازتیں ہیں، وہ سائن ان رہ سکتے ہیں۔ Telegram کی AUTH_KEY_DUPLICATED دستاویزات دیکھیں۔
- Telegram Desktop کو مکمل طور پر بند کر دیں۔
-
tdataسے صرف ان دو آئٹمز پر مشتمل ایک ZIP بنائیں:key_datas- 16 حروف پر مشتمل فائل جو
sپر ختم ہوتی ہے، اس کے ساتھ، عام طور پرD877F783D5D3EF8Cs
میڈیا کیش کے ساتھ پورے فولڈر کو زپ کرنے سے عام طور پر حدیں (512 اندراجات، 32 MiB بغیر پیک) پار ہو جاتی ہیں۔ 3. فائلز میں زپ کو منتخب کریں۔ اگر ٹیلیگرام ڈیسک ٹاپ کا کوئی مقامی پاس کوڈ ہے تو پہلے اسے پاس کوڈ یا سیشن ٹیکسٹ کے تحت درج کریں۔ یہ 2FA پاس ورڈ نہیں ہے۔
مدد یافتہ: ہر آرکائیو میں ایک اکاؤنٹ، جدید key_datas/key_data0/key_data1 اسٹوریج،
مقامی پاس کوڈ۔ غیر مدد یافتہ: متعدد لاگ ان شدہ اکاؤنٹس والے فولڈرز، پرانے ڈیسک ٹاپ
لی آؤٹس، پاس ورڈ سے محفوظ شدہ ZIPs، اور الگ نیٹیو macOS ایپ "Telegram for macOS"۔
ٹیلی تھون سٹرنگ سیشن#
ایک سطر پر مشتمل متن، عام طور پر 1 سے شروع ہوتا ہے اور تقریباً 350 حروف پر مشتمل ہوتا ہے۔ اسے .txt یا .tgwitness-session فائل (زیادہ سے زیادہ 4 KiB) کے طور پر لوڈ کریں، یا پاس کوڈ یا سیشن ٹیکسٹ کے تحت پیسٹ کریں۔ صرف Telethon سٹرنگز قبول کی جاتی ہیں؛ Pyrogram اور TDLib سٹرنگز مختلف فارمیٹس استعمال کرتی ہیں۔
Auth کلید اور DC ایک ہی لائن میں#
اکاؤنٹ لسٹس میں اکثر خام اجازت <512 hexadecimal characters>:<DC id> کے طور پر ہوتی ہے، مثال کے طور پر a1b2…ef:5۔ اس لائن کو پاس کوڈ یا سیشن ٹیکسٹ کے نیچے پیسٹ کریں، اسے ایک ٹیکسٹ فائل کے طور پر لوڈ کریں، یا اسے اکاؤنٹ JSON کے session فیلڈ میں ڈالیں۔ TgWitness، DC 1–5 کو اسی پروڈکشن ایڈریسز سے منسلک کرتا ہے جیسا کہ auth_key + dc_id JSON امپورٹ میں ہوتا ہے اور فارمیٹ کو Auth key HEX اور DC کے طور پر رپورٹ کرتا ہے۔ کوئی بھی دوسرا DC نمبر یا کی لمبائی مسترد کر دی جاتی ہے۔
اکاؤنٹ JSON#
ایک JSON آبجیکٹ، زیادہ سے زیادہ 64 KiB، ایک فائل میں جو .json پر ختم ہوتی ہے۔
| میدان (عرف) | معنی |
|---|---|
api_id (app_id) |
ایپلیکیشن آئی ڈی، ایک مثبت عدد |
api_hash (app_hash) |
ایپلیکیشن ہیش، 32 ہیکساڈیسمل اعداد |
string_session (session_string, session_str; پرانا session) |
Telethon StringSession متن، یا <512 hexadecimal characters>:<DC id>، فائل کا نام نہیں |
auth_key (auth_key_hex) + dc_id |
512 حروف پر مشتمل Auth Key اور DC 1–5 مکمل کریں۔ |
user_id (id) |
اختیاری؛ اجازت محفوظ ہونے سے پہلے ٹیلیگرام کے خلاف چیک کیا جاتا ہے۔ |
device_model (device) |
کنکشن ڈیوائس کی تفصیل |
system_version (sdk) |
کنیکشن OS ورژن |
app_version |
ٹیلیگرام کو بھیجا گیا ایپلیکیشن ورژن |
lang_code, system_lang_code (system_lang_pack), lang_pack |
کلائنٹ زبان، سسٹم زبان اور کلائنٹ زبان پیک؛ خالی lang_pack کی اجازت ہے |
tz_offset |
اختیاری UTC آفس سیکنڈز میں، جو initConnection.params میں بھیجا جاتا ہے؛ عدد یا اعشاریہ عدد کی سٹرنگ |
اگر عرفی نام اور اصل نام دونوں موجود ہوں تو ان کا ایک جیسا ہونا ضروری ہے۔ واضح Telethon
سیشن کے فیلڈز کسی دوسرے فارمیٹ میں ایک عمومی session بلاک پر فوقیت رکھتے ہیں۔ اگر
دونوں میں قابلِ شناخت Telethon سیشنز موجود ہوں، تو ان کا ایک ہی اجازت نامہ بیان کرنا ضروری ہے۔
بغیر کسی واضح فیلڈ کے، session ایک درست Telethon StringSession یا auth key اور 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 دکھائی دیتا ہے |
Telethon یا Pyrogram SQLite | فائلیں (خودکار طور پر شناخت شدہ) |
tdata فولڈر جس میں key_datas شامل ہے۔ |
ٹیلیگرام ڈیسک ٹاپ ٹی ڈیٹا | دو فائلوں کو ZIP کریں، پھر فائلیں |
1 سے شروع ہونے والی ایک ٹیکسٹ لائن، تقریباً 350 حروف |
ٹیلی تھون سٹرنگ سیشن | فائلیں |
ایک ٹیکسٹ لائن 512 characters 0-9a-f، پھر : اور ایک ہندسہ 1–5 |
Auth کلید اور DC | فائلیں، باکس پاس کوڈ یا سیشن کا متن |
*.json کے ساتھ app_id/app_hash |
متعلقہ میٹا ڈیٹا | فائلیں، اس کے سیشن کے ساتھ |
*.json کے ساتھ auth_key یا string_session |
اکاؤنٹ JSON | فائلیں |
512 حروف 0-9a-f |
آتھ کی | آتھ کی |
32 حروف 0-9a-f |
API ہیش | API آئی ڈی + ہیش |
td.binlog یا db.sqlite، TDLib ایپ سے |
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 پول ڈیش بورڈ۔
سائن آؤٹ#
مزید ٹولز → اکاؤنٹ → ٹیلیگرام سے سائن آؤٹ کریں (مشاہدہ معطل کے ساتھ) ٹیلیگرام سے سیشن ختم کرنے کو کہتا ہے، تاکہ یہ اکاؤنٹ کی سیٹنگز → ڈیوائسز سے بھی غائب ہو جائے، اور ورک اسپیس والٹ سے سیشن کو ہٹا دے۔ جرنل، ذرائع، سیٹنگز اور سائننگ کی موجود رہتی ہیں، اور جرنل سائن آؤٹ کو ریکارڈ کرتا ہے۔ ورک اسپیس اب بھی اپنے اکاؤنٹ کا ہی ہے: صرف وہی اکاؤنٹ دوبارہ اس سے کنیکٹ ہو سکتا ہے۔ اگر ٹیلیگرام جواب نہ دے، تب بھی سیشن یہاں سے ہٹا دیا جاتا ہے اور پینل اس کی اطلاع دیتا ہے؛ ٹیلیگرام میں Settings → Devices کے تحت اسے ختم کریں۔
جب ٹیلیگرام سیشن ختم کرتا ہے#
اگر ٹیلیگرام اکاؤنٹ کو بین کرے، منجمد کرے یا سائن آؤٹ کرے، یا کسی دوسرے آلے سے سیشن ختم کرے، تو جرنل وجہ، ٹیلیگرام کی خرابی، راستہ اور ڈیٹا سینٹر ریکارڈ کرتا ہے۔ اکاؤنٹ کی ہیلتھ میں اکاؤنٹ نقصان کی رپورٹ ڈاؤن لوڈ کریں: ایک دستخط شدہ JSON فائل جس میں نقصان سے پہلے 24 گھنٹوں کے جرنل ریکارڈز شامل ہیں، یعنی کنکشنز، راستے، سیشنز، اکاؤنٹ نوٹس اور کوریج گیپس، ہر ایک اپنے جرنل ہیش اور دستخط کے ساتھ۔ اسے کے ساتھ چیک کریں
python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP؛ ثبوت کی برآمد (evidence export) مکمل ہیش چین (hash chain) پر مشتمل ہوتی ہے۔ ایک منجمد اکاؤنٹ کو بھی اس کے کنکشن اور مشاہدے کے دوران شناخت کر لیا جاتا ہے، اور اس کی بھیجنے اور شامل ہونے کی کارروائیاں بند کر دی جاتی ہیں۔
اکاؤنٹ فائلوں کو محفوظ رکھنا#
- ہر
.session، TData ZIP، StringSession، Auth Key اور اکاؤنٹ JSON کو پاس ورڈ کی طرح سمجھیں۔ TgWitness درآمد شدہ اجازت کو اپنے خفیہ کردہ والٹ میں محفوظ رکھتا ہے؛ آپ بعد میں اصل فائلیں حذف کر سکتے ہیں۔ - ایک ہی اجازت نامہ ایک ساتھ دو پروگراموں میں چلانے کی کوشش نہ کریں۔ ٹیلیگرام اسے منسوخ کر سکتا ہے (
AUTH_KEY_DUPLICATED)، اور دونوں نقول کام کرنا بند کر دیں گی۔ - ایک ختم شدہ یا منسوخ شدہ سیشن کو تبدیلی کے ذریعے دوبارہ بحال نہیں کیا جا سکتا۔ دوبارہ سائن ان کریں۔
مسئلہ حل کرنا#
| پیغام یا علامت | کیا کرنا ہے |
|---|---|
| اس سیشن کو پڑھا نہیں جا سکتا۔ اس کے اصل کلائنٹ کو بند کریں… | SQLite فائل کھلی یا نامکمل ہے (-journal/-wal سائیڈ کار). اصل پروگرام کو صاف طریقے سے بند کریں اور فائل کو دوبارہ کاپی کریں۔ |
| Telethon SQLite سکیمے جن کی حمایت کی جاتی ہے: 7 اور 8 / پائروگرام … 2 اور 3 | فائل ایک بہت پرانی یا نامعلوم لائبریری ورژن نے بنائی۔ اس کے بجائے فون/QR کے ذریعے سائن ان کریں۔ |
| صرف مجاز پروڈکشن صارف سیشنز کی حمایت کی جاتی ہے۔ | Pyrogram فائل کسی بوٹ یا ٹیسٹ نیٹ ورک سے تعلق رکھتی ہے۔ |
| TData آرکائیو 512 اندراجات یا 32 MiB سے تجاوز کر گیا ہے۔ | صرف ZIP کریں key_datas اور D877F783D5D3EF8Cs، پورا فولڈر نہیں۔ |
| TData کو ڈیکرپٹ نہیں کیا جا سکتا۔ ڈیسک ٹاپ کا مقامی پاس کوڈ چیک کریں۔ | Telegram Desktop کا مقامی پاس کوڈ Passcode یا سیشن ٹیکسٹ کے تحت درج کریں۔ |
| ایک وقت میں ایک TData اکاؤنٹ درآمد کریں | Telegram Desktop کے متعدد اکاؤنٹس تھے؛ غیر معاونت یافتہ فارمیٹس دیکھیں۔ |
| منتخب فائلیں مختلف اکاؤنٹس یا API کی اسناد بیان کرتی ہیں۔ | صرف ایک اکاؤنٹ کی فائلیں منتخب کریں۔ |
| JSON میں کوئی سپورٹڈ API کریڈینشلز یا اجازت نامہ شامل نہیں ہے۔ | اکاؤنٹ JSON میں فیلڈ کے نام چیک کریں۔ |
| صرف API میٹا ڈیٹا | JSON میں کوئی سیشن نہیں ہے۔.session فائل شامل کریں یا فون/QR استعمال کریں۔ |
| Auth Key HEX میں تمام 512 ہیکساڈیسمل اعداد شامل ہونے چاہئیں۔ | کلیدی ٹکڑے میں چھانٹی گئی ہے یا اس میں … شامل ہے۔ |
| اکاؤنٹ آئی ڈی درآمد شدہ اکاؤنٹ سے مطابقت نہیں رکھتی | فائل کا صارف آئی ڈی ٹیلیگرام کی رپورٹ کردہ معلومات سے مختلف ہے؛ یہ فائل کسی دوسرے اکاؤنٹ کے لیے ہے۔ |
| اکاؤنٹ پہلے ہی کسی دوسرے ورک اسپیس کا حصہ ہے۔ | اکاؤنٹ کو دو بار شامل کرنے کے بجائے اس ورک اسپیس کو کھولیں۔ |
| منسلک ہے، لیکن مزید ٹولز → ذرائع میں چیٹ لسٹ سے ایک نجی گروپ غائب ہے۔ | رکنیت چیک کریں۔ پِکر پہلے 1,000 ڈائیلاگز کا معائنہ کرتا ہے؛ حد کو More tools → Parameters کے تحت بڑھائیں۔ |
| پراکسی کنکشن ناکام | روٹ اور آئی پی موڈ چیک کریں۔ خودکار MTProxy ایک اور قابلِ عمل اندراج آزمائیں۔ 'ایڈریس چھپائیں' انتظار کرتا ہے؛ 'براہِ راست' آخری چارہ کے طور پر متعین کردہ تاخیر کے بعد براہِ راست کنکٹ کر سکتا ہے۔ روٹنگ موڈز دیکھیں۔ |
مزید دیکھیں: پروکسیز اور انکرپشن کے لیے کنکشن اور سیکیورٹی، اور سائن ان کے بعد کیا جمع کیا جاتا ہے اس کے لیے کلیکشن کیسے کام کرتی ہے۔