اکاؤنٹس اور سیشن فارمیٹس

TgWitness MTProto کے ذریعے ایک ٹیلیگرام صارف اکاؤنٹ (بوٹ نہیں) کے طور پر سائن ان کرتا ہے، Telethon استعمال کرتے ہوئے۔ ہر اکاؤنٹ اپنے مخصوص ورک اسپیس (جسے API اور کمانڈ لائن ٹولز میں ورک اسپیس کہا جاتا ہے) میں موجود ہوتا ہے، جس کا اپنا سیشن، ذرائع، جرنل اور دستخطی کلید ہوتی ہے۔

سیشن فائلز، سیشن سٹرنگز اور آتھ کیز اکاؤنٹ کی اجازت نامے ہیں: جو بھی ان میں سے کسی کو اپنے پاس رکھے وہ اس اکاؤنٹ کے طور پر کام کر سکتا ہے۔ ان میں پیغامات کی تاریخ شامل نہیں ہوتی۔

[!WARNING] ایسی کوئی بھی چیز استعمال نہ کریں جسے آپ کھونے کا متحمل نہ ہو سکیں۔ ہم سختی سے مشورہ دیتے ہیں کہ ذاتی یا دیگر قیمتی اکاؤنٹس کو منسلک نہ کریں، اور کسی ایسے اکاؤنٹ پر API ID / API ہیش نہ بنائیں جسے آپ اہم سمجھتے ہوں۔ یہ اس بات کے بارے میں نہیں ہے کہ ٹی جی وٹنس (TgWitness) آزمایا ہوا نہیں ہے: ٹیلیگرام غیر متوقع طور پر اکاؤنٹس کو محدود اور مستقل طور پر بلاک کر دیتا ہے — ایسے درخواستوں کے حجم کے لیے جنہیں یہ ضرورت سے زیادہ سمجھتا ہے، چاہے کلائنٹ یا مقصد کچھ بھی ہو، اور اس کے لیے کوئی مناسب دستاویزات فراہم نہیں کرتا۔ بہت سے بلاک ناقابل واپسی ہوتے ہیں۔ مخصوص اکاؤنٹس استعمال کریں۔ ٹیسٹ رنز کا ہموار چلنا ٹیلیگرام پر منحصر ہے، نہ کہ سافٹ ویئر پر، اور مستقبل کے لیے کسی چیز کی ضمانت نہیں دیتا۔

• ایک نظر میں
• شروع کرنے سے پہلے: API ID اور API ہیش
• فون نمبر · کیو آر کوڈ · آتھ کی + ڈی سی آئی ڈی
• اکاؤنٹ فائلیں: ٹیلی تھون .سیشن · پائروگرام .سیشن · سیشن + JSON جوڑا · TData · اسٹرنگ سیشن · اکاؤنٹ JSON
• پہچانیں کہ آپ کے پاس کیا ہے · غیر معاونت یافتہ فارمیٹس
• متعدد اکاؤنٹس · اکاؤنٹ فائلوں کو محفوظ رکھنا · مسئلہ حل کرنا

ایک نظر میں#

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 ہیش ٹیلیگرام کے پاس ایپلیکیشن کی شناخت کرتے ہیں؛ وہ خود بخود کسی اکاؤنٹ کو مجاز نہیں کرتے۔

اپنی ایپلیکیشن استعمال کرنے کے لیے (اس اکاؤنٹ کو خطرہ ہے جس نے اسے رجسٹر کیا ہے؛ دیکھیں: بلٹ ان 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 میں پیسٹ کر سکتے ہیں اور دونوں فیلڈز بھر جائیں گے۔ ایک جوڑا آپ کے تمام اکاؤنٹس کے لیے استعمال کیا جا سکتا ہے۔ کامیاب لاگ ان کے بعد یہ محفوظ، انکرپٹڈ، صرف اسی ورک اسپیس میں ہوتا ہے اور کبھی بھی براؤزر کو واپس نہیں بھیجا جاتا۔

تین مختلف اسناد ملوث ہیں:

اگر ٹیلیگرام تک رسائی کے لیے پروکسی استعمال کرنا ضروری ہو تو پہلے اکاؤنٹ → ترتیبات → کنکشن کی ترتیبات → کنکشن کا راستہ تبدیل کریں میں سیٹ کریں۔

فون نمبر#

1. اکاؤنٹ کھولیں، فون ٹیب پر جائیں، اور نمبر بین الاقوامی فارمیٹ میں درج کریں، مثال کے طور پر +44 7700 900123۔ خالی جگہیں اور ڈیشز خود بخود ہٹا دیے جاتے ہیں۔
2. جاری رکھیں پر کلک کریں۔ API ID + ہیش خالی رہ سکتے ہیں۔
3. وہ کوڈ درج کریں جو ٹیلیگرام بھیجتا ہے (عموماً ٹیلیگرام ایپ میں؛ ایس ایم ایس کی ضمانت نہیں)۔
4. اگر اکاؤنٹ میں دو مرحلوں کی توثیق فعال ہے تو وہ پاس ورڈ درج کریں۔ یہ پینل ٹوکن یا ڈیوائس پاس کوڈ نہیں ہے۔
5. لاگ ان کے بعد دکھائی گئی اکاؤنٹ آئی ڈی چیک کریں، پھر ذرائع منتخب کریں۔

لاگ ان کوڈز اور 2FA پاس ورڈ کبھی بھی ڈسک پر محفوظ نہیں کیے جاتے۔

کیو آر کوڈ#

اس کا استعمال اس وقت کریں جب اکاؤنٹ پہلے ہی فون یا کسی دوسرے کمپیوٹر پر سائن ان ہو چکا ہو۔

1. QR کوڈ ٹیب → QR کوڈ دکھائیں۔ API ID + ہیش خالی رہ سکتے ہیں۔
2. سائن ان شدہ ڈیوائس پر: سیٹنگز → ڈیوائسز → ڈیسک ٹاپ ڈیوائس کو لنک کریں، کوڈ اسکین کریں اور تصدیق کریں۔
3. اگر ٹیلیگرام درخواست کرے تو TgWitness میں 2FA پاس ورڈ درج کریں۔

QR تصویر مقامی طور پر تیار کی جاتی ہے۔ کوڈز کی میعاد ختم ہو جاتی ہے؛ دوبارہ کوشش کے لیے 'دوسرا QR کوڈ تیار کریں' پر کلک کریں۔ پینل کو لاک کرنے، ورک اسپیس تبدیل کرنے یا دوسرا لاگ ان شروع کرنے سے زیر التواء کوڈ منسوخ ہو جاتا ہے۔

آتھ کی + ڈی سی آئی ڈی#

ایک آتھ کی ہر ٹیلیگرام سیشن کے پیچھے موجود خام 256 بائٹ کی اجازت ہے، جو 512 ہیکساڈیسمل حروف میں لکھی جاتی ہے، ڈیٹا سینٹر نمبر DC 1–5 کے ساتھ۔

1. ٹیب 'Auth key'۔ مکمل کلید چسپاں کریں؛ ایک مختصر کلید جس میں صرف '…' شامل ہو، کام نہیں کرے گی۔
2. کلیدی کے ساتھ فراہم کردہ DC ID منتخب کریں۔
3. اختیاری طور پر صارف کی شناخت درج کریں۔ اگر ٹیلیگرام مختلف اکاؤنٹ رپورٹ کرے تو TgWitness کنکشن سے انکار کر دے گا۔
4. پریس کنیکٹ اکاؤنٹ۔

ایک آتھ کی (512 حروف) API ہیش (32 حروف) نہیں ہے۔ اسی کلید کو JSON کے طور پر بھی درآمد کیا جا سکتا ہے، دیکھیں اکاؤنٹ JSON۔

اکاؤنٹ فائلیں#

اوپن کریں، Add account → Files پر جائیں اور ایک اکاؤنٹ سے تعلق رکھنے والی زیادہ سے زیادہ چار فائلیں (کل 8 MiB) منتخب کریں، پھر Connect account دبائیں۔

• فائلیں آپ کے TgWitness سرور کی میموری میں تبدیل کی جاتی ہیں۔ اپلوڈز محفوظ نہیں کیے جاتے، ZIP فائلیں ڈسک پر نکالی نہیں جاتیں اور کسی بیرونی سروس سے رابطہ نہیں کیا جاتا۔
• پیدا ہونے والے سیشن کو پھر ٹیلیگرام کے ساتھ چیک کیا جاتا ہے۔ اگر کسی فائل میں صارف کی شناخت (یوزر آئی ڈی) درج ہو، تو اسے ٹیلیگرام کے رپورٹ کردہ اکاؤنٹ سے میل کھانا چاہیے۔
• وہ فائلیں جو مختلف اکاؤنٹس یا مختلف API کریڈنلز کو بیان کرتی ہیں مسترد کر دی جاتی ہیں ایک کو منتخب کرنے کے بجائے۔
• پاس کوڈ یا سیشن ٹیکسٹ میں TData کا مقامی پاس کوڈ فیلڈ ہوتا ہے، ایک باکس جہاں آپ بغیر سائن ان کیے StringSession اور Read فائلیں پیسٹ کر سکتے ہیں (یہ فارم ٹیلیگرام سے رابطہ کیے بغیر مکمل کرتا ہے).

ٹیلی تھون .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 درآمد شدہ سیشن استعمال کر رہا ہو، اس کاپی کو بند رکھیں۔ بند کریں، لاگ آؤٹ نہ کریں یا سیشن منسوخ نہ کریں: منسوخی درآمد شدہ کاپی کو بھی باطل کر دیتی ہے۔ اگر آپ کو دونوں کلائنٹس چلانے کی ضرورت ہے، تو TgWitness میں فون یا QR کے ذریعے سائن ان کریں تاکہ اپنی الگ اجازت نامہ بنا سکیں۔ ایک مخصوص اکاؤنٹ کی سفارش کی جاتی ہے، لیکن یہ کلون شدہ چابیاں کو ایک ساتھ استعمال کرنے کے لیے محفوظ نہیں بناتا۔

یہ درآمد شدہ پر بھی لاگو ہوتا ہے۔ .session فائلیں، StringSession ٹیکسٹ اور Auth Key HEX۔ دیگر کلائنٹس جن کے پاس اپنی آزادانہ طور پر بنائی گئی اجازتیں ہیں، وہ سائن ان رہ سکتے ہیں۔ Telegram کی AUTH_KEY_DUPLICATED دستاویزات دیکھیں۔

1. Telegram Desktop کو مکمل طور پر بند کر دیں۔

2. 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 سٹرنگز مختلف فارمیٹس استعمال کرتی ہیں۔

اکاؤنٹ 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 پول کا ڈیش بورڈ دیکھیں۔

سائن آؤٹ#

اکاؤنٹ → ٹیلیگرام سے سائن آؤٹ کریں (مشاہدہ معطل کے ساتھ) ٹیلیگرام سے سیشن ختم کرنے کی درخواست کرتا ہے، لہٰذا یہ اکاؤنٹ کی سیٹنگز → ڈیوائسز سے بھی غائب ہو جاتا ہے، اور ورک اسپیس والٹ سے سیشن کو ہٹا دیتا ہے۔ جرنل، ذرائع، سیٹنگز اور سگننگ کی موجود رہتی ہیں، اور جرنل سائن آؤٹ کو ریکارڈ کرتا ہے۔ ورک اسپیس اب بھی اپنے اکاؤنٹ کا ہی ہے: صرف وہی اکاؤنٹ دوبارہ اس سے کنیکٹ ہو سکتا ہے۔ اگر ٹیلیگرام جواب نہیں دیتا، تو سیشن یہاں سے پھر بھی ہٹا دیا جاتا ہے اور پینل اس کی اطلاع دیتا ہے؛ اسے ٹیلیگرام میں Settings → Devices کے تحت ختم کریں۔

ٹیلی تھون سیشن کو آف لائن میں تبدیل کریں#

پینل براہِ راست .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

کنورٹر صرف Telethon SQLite (64 MiB تک) پڑھتا ہے، ان پٹ میں کبھی ترمیم نہیں کرتا، کوئی نیٹ ورک درخواست نہیں کرتا اور موجودہ آؤٹ پٹ فائل کو اووررائٹ کرنے سے انکار کرتا ہے۔

اکاؤنٹ فائلوں کو محفوظ رکھنا#

• ہر .session، TData ZIP، StringSession، Auth Key اور اکاؤنٹ JSON کو پاس ورڈ کی طرح سمجھیں۔ TgWitness درآمد شدہ اجازت کو اپنے خفیہ کردہ والٹ میں محفوظ رکھتا ہے؛ آپ بعد میں اصل فائلیں حذف کر سکتے ہیں۔
• ایک ہی اجازت نامہ ایک ساتھ دو پروگراموں میں چلانے کی کوشش نہ کریں۔ ٹیلیگرام اسے منسوخ کر سکتا ہے (AUTH_KEY_DUPLICATED)، اور دونوں نقول کام کرنا بند کر دیں گی۔
• ایک ختم شدہ یا منسوخ شدہ سیشن کو تبدیلی کے ذریعے دوبارہ بحال نہیں کیا جا سکتا۔ دوبارہ سائن ان کریں۔

مسئلہ حل کرنا#

مزید دیکھیں: پروکسیز اور انکرپشن کے لیے کنکشن اور سیکیورٹی، اور سائن ان کے بعد کیا جمع کیا جاتا ہے اس کے لیے کلیکشن کیسے کام کرتی ہے۔