TgWitness / ডকুমেন্টেশন

কি পরীক্ষা করা হয়েছে →

এই পৃষ্ঠার কিছু অংশ এখনও ইংরেজিতে রয়েছে: অনুবাদ করার পর মূল ইংরেজি সংস্করণটি পরিবর্তিত হয়েছে।

তথ্যসূত্র / সেটআপ

Telegram · অ্যাকাউন্ট এবং সেশন ফরম্যাটসমূহ

ফোন, QR কোড বা auth কী দিয়ে সাইন ইন করুন, Telethon, Pyrogram বা Telegram Desktop সেশন আমদানি করুন, এবং একাধিক অ্যাকাউন্ট চালান।

টিজিউইটনেস / ডকুমেন্টেশন · শুরু করা

শুরু করা

TgWitness MTProto ব্যবহার করে টেলিথন-এর মাধ্যমে একটি টেলিগ্রাম ব্যবহারকারী অ্যাকাউন্ট (বট নয়) হিসেবে সাইন ইন করে। প্রতিটি অ্যাকাউন্ট তার নিজস্ব সেশন, সোর্স, জার্নাল এবং সই করার কী সহ নিজস্ব একটি কর্মস্থলে (API এবং কমান্ড-লাইন টুলসে workspace নামে পরিচিত) অবস্থান করে।

সেশন ফাইল, সেশন স্ট্রিং এবং অ্যথ কী-গুলো অ্যাকাউন্ট অনুমোদন: যার কাছে এগুলো থাকবে, সে ঐ অ্যাকাউন্ট হিসেবে কাজ করতে পারবে। এগুলোতে বার্তার ইতিহাস থাকে না।

[!WARNING] নিবেদিত অ্যাকাউন্ট ব্যবহার করুন। টেলিগ্রাম অনুরোধের পরিমাণ যা অতিরিক্ত বলে মনে করে তার জন্য অ্যাকাউন্ট সীমিত বা স্থায়ীভাবে নিষিদ্ধ করতে পারে, ক্লায়েন্ট বা উদ্দেশ্য যাই হোক না কেন, এবং সেই সীমাগুলো কেবল আংশিকভাবে নথিভুক্ত করে। ব্যক্তিগত বা অন্যথায় মূল্যবান অ্যাকাউন্টের পরিবর্তে পর্যবেক্ষণের জন্য প্রস্তুত অ্যাকাউন্ট সংযুক্ত করুন, এবং একটি নিবেদিত অ্যাকাউন্টে একটি API ID / API হ্যাশ তৈরি করুন।

এক নজরে#

তোমার কাছে যা আছে অ্যাকাউন্ট যোগ করুন-এ ট্যাব আপনাকে আরও প্রয়োজন হবে
ফোন নম্বর এবং লগইন কোডে প্রবেশাধিকার ফোন যদি 2FA পাসওয়ার্ড সক্ষম করা থাকে
টেলিগ্রাম অন্য ডিভাইসে খোলা আছে কিউআর কোড যদি 2FA পাসওয়ার্ড সক্ষম করা থাকে
.session ফাইল (টেলিথন বা পাইরোগ্রাম) ফাইলসমূহ অ্যাপ সেটিংসের জন্য ঐচ্ছিক সঙ্গী JSON
.session+.json একই নামে ফাইলসমূহ (উভয়টি নির্বাচন করুন) সাধারণত আর কিছুই না
টেলিগ্রাম ডেস্কটপ tdata ফোল্ডার ফাইলসমূহ (ZIP হিসেবে) যদি ডেস্কটপের স্থানীয় পাসকোড সেট করা থাকে
একটি টেলিথন স্ট্রিংসেশন (টেক্সট, .txt, .tgwitness-session) ফাইলসমূহ কোনো পৃথক API জোড়ার প্রয়োজন নেই
একই লাইনে auth কী এবং DC, <512 hex>:<1–5> ফাইলসমূহ (পেস্ট বা টেক্সট ফাইল) কোনো পৃথক API জোড়ার প্রয়োজন নেই
.json, সেশন বা অথ কী সহ ফাইলসমূহ কোনো পৃথক API জোড়ার প্রয়োজন নেই
একটি অ্যাক্সেস কী (৫১২ হেক্সাডেসিমাল অক্ষর) এবং এর DC নম্বর অথ কী ঐচ্ছিক ব্যবহারকারী আইডি

TgWitness ফাইলগুলোকে তাদের নামের পরিবর্তে তাদের বিষয়বস্তু অনুযায়ী চিনে। একটি ফাইলের নাম পরিবর্তন করলে তা কখনই রূপান্তরিত হয় না।

শুরু করার আগে: API আইডি এবং API হ্যাশ#

আপনি টেলিগ্রাম API অ্যাপ্লিকেশন তৈরি না করেই সাইন ইন করতে পারেন। যখন কোনো জোড়া ইনপুট করা হয়নি, আমদানি করা হয়নি বা ওয়ার্কস্পেসে ইতিমধ্যেই সংরক্ষণ করা হয়নি, TgWitness তার বিল্ট-ইন ৫০টি পাবলিক API জোড়ার পুল থেকে একটি জোড়া বেছে নেয় (tgwitness/api_pool.py), নতুন লগইনের জন্য টেলিগ্রাম ডেস্কটপকে অগ্রাধিকার দিয়ে এবং প্রথমে সংরক্ষিত জোড়াটি ধরে রেখে; বাকি প্রার্থীদের র‌্যান্ডম করা হয়। যদি টেলিগ্রাম কোনো জোড়া প্রত্যাখ্যান করে (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), পরবর্তীটি চেষ্টা করা হয়, প্রতি সাইন-ইন-এ সর্বোচ্চ আটটি; প্রত্যাখ্যাত জোড়াগুলো রিস্টার্ট না হওয়া পর্যন্ত এড়িয়ে যাওয়া হয়। যে জোড়াটি সাইন-ইন করেছে তা অ্যাকাউন্টের সাথে সংরক্ষিত হয় এবং পরবর্তীতে পুনরায় ব্যবহার করা হয়।

বিল্ট-ইন পেয়ারগুলো পাবলিক: এগুলো টেলিগ্রাম ক্লায়েন্ট এবং লাইব্রেরির ওপেন সোর্স কোডে প্রকাশিত। একটি API আইডি এবং API হ্যাশ টেলিগ্রামের কাছে অ্যাপ্লিকেশনটিকে চিহ্নিত করে এবং অ্যাকাউন্ট ডেটাতে কোনো অ্যাক্সেস দেয় না। সাইন-ইন অ্যাকাউন্টের নিজস্ব অনুমোদন ব্যবহার করে: একটি লগইন কোড এবং 2FA পাসওয়ার্ড, অথবা এমন একটি সেশন যা অ্যাকাউন্ট ইতিমধ্যেই অনুমোদন করেছে। প্রতিটি observation.started প্রতি রেকর্ডে ব্যবহৃত পেয়ারের নাম উল্লেখ থাকে, তাই একটি বিল্ট-ইন পেয়ার আপনার নিজের পেয়ারের মতোই আদালতের জন্য নথিভুক্ত করা হয়। পরিবর্তে আপনি my.telegram.org থেকে আপনার নিজস্ব পেয়ার প্রবেশ করাতে পারেন। প্রকল্পের অভিজ্ঞতা অনুযায়ী, একটি নতুন ব্যক্তিগত পেয়ার বেশিরভাগ অ্যাকাউন্টকে লগ আউট করে দেয়, তাই এটি শুধুমাত্র তখনই ব্যবহার করুন যখন কোনো মামলায় আপনার নিজস্ব অ্যাপ্লিকেশন প্রয়োজন: এটি একটি নিবেদিত অ্যাকাউন্ট দিয়ে তৈরি করুন এবং সংগ্রহ শুরু হওয়ার আগে এটি প্রবেশ করান (নিচের ধাপগুলো দেখুন)।

সংযোগ ক্ষেত্র অনুপস্থিত থাকলে, বান্ডিলকৃত opentele2 2.0.0 ক্যাটালগ থেকে একটি নির্ধারণাত্মক ডিভাইস/ওএস যুগল ব্যবহার করা হয়: ডেস্কটপ 2040, অ্যান্ড্রয়েড 6, অ্যান্ড্রয়েড X 21724, iOS 10840, macOS 2834, এবং ওয়েব 2496। অ্যান্ড্রয়েডের সোর্স-বিল্ড আইডি 4 ও Android ক্যাটালগ ব্যবহার করে, যেমনটি Telegram Android's BuildVars-এ চিহ্নিত হয়েছে। Web ডিফল্টরূপে A; একটি আমদানি করা K অ্যাপ-সংস্করণ সফিক্স বা macos ভাষা প্যাক K নির্বাচন করে, এবং সংস্করণ 0.7.0 Webogram নির্বাচন করে। অজানা অ্যাপ্লিকেশন আইডিগুলো টেলিথনের হোস্টের ডিফল্টগুলো বজায় রাখে। আমদানি করা ফিল্ডগুলো সবসময় প্রাধান্য পায়, যার মধ্যে রয়েছে পুরনো অ্যাপ সংস্করণ এবং একটি খালি ভাষা প্যাক। ক্যাটালগ কখনই API আইডি/হ্যাশ পরিবর্তন করে না। এর সংস্করণ স্ন্যাপশট স্পষ্টভাবে পর্যালোচনা করা হয়, লগইন করার সময় তা আনা হয় না। আপডেটের পর সংরক্ষিত প্রোফাইল স্থিতিশীল থাকে।

account.getAuthorizations টেলিগ্রামের সংরক্ষিত অনুমোদন মেটাডেটা রিপোর্ট করে; এটি প্রতিটি নতুন initConnection-এর প্রতিধ্বনি নয়। এটিকে প্রকৃত প্রেরিত প্রোফাইলের সাথে তুলনা করুন। বিদ্যমান অনুমোদন সংযুক্ত করা তার সঙ্গী API হ্যাশকে বৈধতা দেয় না: initConnection API আইডি পাঠায়, যখন হ্যাশ লগইন অনুরোধগুলিতে ব্যবহৃত হয়।

নতুন ফোন বা QR অনুমোদনের পর, TgWitness কনফিগারেশন, নিকটতম DC, অনলাইন স্ট্যাটাস, ভাষা (যখন ভাষা প্যাক খালি থাকে না), অ্যাপ আপডেট এবং পরিষেবার শর্তাবলী আপডেট অনুরোধ করে, অনুরোধগুলোর মধ্যে 0.3–1.5 সেকেন্ডের ব্যবধান রেখে। স্ট্যাটাস আপডেট অল্প সময়ের জন্য অ্যাকাউন্টকে অনলাইন হিসেবে চিহ্নিত করে। এই সিকোয়েন্স লগইন সম্পন্ন হওয়ার পর একবার চলে, ইমপোর্ট, পুনঃসংযোগ বা রিস্টার্টের সময় নয়। অনুমোদন প্রথমে সংরক্ষণ করা হয়; একটি ব্যর্থ অনুরোধ লগইন পুনরায় চেষ্টা না করে বা বাতিল না করে সিকোয়েন্সটি থামিয়ে দেয়। ফলাফলগুলি রেসপন্স বডির পরিবর্তে ত্রুটির নাম দিয়ে account.initialized হিসেবে রেকর্ড করা হয়। টেলিগ্রামের নিজস্ব নীতিগুলি অ্যাকাউন্টের বিধিনিষেধ নির্ধারণ করে।

tdesktop -এর জন্য, অনুপস্থিত tz_offset সার্ভারের স্থানীয় UTC অফসেট ব্যবহার করে, 900 সেকেন্ডে opentele2 অ্যালগরিদম (MIT; লাইসেন্স tgwitness/client_profiles.LICENSE -এ) ব্যবহার করে রাউন্ড করা হয়। এটি প্রতিটি সংযোগে রিফ্রেশ করা হয় যাতে ডে-লাইট সেভিং পরিবর্তনগুলি প্রতিফলিত হয়। আমদানি করা tz_offset প্রতিটি প্ল্যাটফর্মে অগ্রাধিকার পায় এবং শূন্যসহ সঠিকভাবে রাখা হয়। অন্যান্য initConnection.params এন্ট্রিগুলো সংরক্ষিত থাকে। HTTP সাইন-ইন ফর্ম ফাইল ইমপোর্ট দ্বারা ফেরত আসা সংখ্যাসূচক টাইমজোন গ্রহণ করে; সমর্থিত পরিসরের বাইরে থাকা বুলিয়ান, ভগ্নাংশ এবং অফসেটগুলো প্রত্যাখ্যাত হয়।

Direct, SOCKS5 এবং HTTP CONNECT রুটগুলো Telethon-এর ConnectionTcpObfuscated (অবফাস্কডেড সংক্ষিপ্ত MTProto) ব্যবহার করে। HTTPS CONNECT প্রক্সি পর্যন্ত TLS বজায় রাখে এবং টানেলের ভিতরে একই অবফাস্কিটেড ট্রান্সপোর্ট ব্যবহার করে। MTProxy তার প্রয়োজনীয় র‍্যান্ডমাইজড মধ্যবর্তী ট্রান্সপোর্ট এবং গোপনীয় হ্যান্ডলিং বজায় রাখে। রুট সুইচগুলো একই পছন্দ প্রয়োগ করে। অবফাস্কেশন প্যাকেট ফ্রেমিং পরিবর্তন করে; এটি টেলিগ্রাম থেকে অ্যাকাউন্ট বা এর ক্লায়েন্ট মেটাডেটা লুকিয়ে রাখে না বা বিধিনিষেধ থেকে অব্যাহতি নির্দেশ করে না।

একজন অনুমোদিত ক্লায়েন্ট সংযুক্ত করার পর, TgWitness কনফিগারেশন, নিকটতম ডিসি, বর্তমান অনুমোদন, পর্যালোচিত লেয়ার বেসলাইন, ভাষা, অ্যাপ আপডেট এবং পরিষেবার শর্তাবলী আপডেট পরীক্ষা করে। এই ডায়াগনস্টিকগুলো প্রতিটি ক্লায়েন্ট ইনস্ট্যান্সে একবার, সংগ্রহের আগে চলে এবং সংযোগের বিবরণের অধীনে তাদের সময়সহ দেখানো হয়। account.connection_checked সেশন হ্যাশ, আইপি, টোকেন বা এপিআই হ্যাশ ছাড়া ফলাফল রেকর্ড করে। এগুলো কখনই শর্তাবলী গ্রহণ করে না বা আপডেট ইনস্টল করে না। একটি অনুরোধ ব্যর্থতা বা FloodWait পরবর্তী অনুরোধগুলো বন্ধ করে; অনুপস্থিত ফলাফল অজানা থেকে যায়। স্থানীয় চেকগুলো তাদের ফলাফল রিপোর্ট করতে পারে, যখন নেটওয়ার্ক চেকগুলো বাদ দেওয়া হয়। স্ট্রিক্ট চোজেন চ্যাটস চালু থাকলে, বর্তমান অনুমতি অনুরোধ করা হয় না এবং সেই চেকটি বাদ দেওয়া হিসেবে দেখানো হয়।

সাইন-ইন করার পর এবং প্রতিটি নতুন সংযোগে, TgWitness অ্যাকাউন্টের সংবেদনশীল বিষয়বস্তু সেটিং পড়ে। যখন এটি বন্ধ থাকে এবং টেলিগ্রাম পরিবর্তনটি অনুমোদন করে, TgWitness এটি চালু করে যাতে টেলিগ্রাম যেসব বিষয়বস্তুকে সংবেদনশীল (১৮+) হিসেবে চিহ্নিত করে সেগুলো সংরক্ষিত হয়, এবং account.content_settings রেকর্ড করে। এই সেটিংটি অ্যাকাউন্টের অন্তর্গত এবং প্রতিটি টেলিগ্রাম অ্যাপে প্রযোজ্য। Strict chosen chats এটিকে অক্ষত রাখে; সাইন ইন করার আগে সেটি চালু করুন।

একই সময়ে একটি ওয়ার্কস্পেসের সংযোগ পুনরুদ্ধারের অনুরোধগুলো একই ক্লায়েন্ট শেয়ার করে এবং সংযোগ সেটআপ শেষ হওয়া পর্যন্ত অপেক্ষা করে। একটি ব্যর্থ বা বাতিল হওয়া প্রচেষ্টা পরবর্তী অনুরোধটিকে পুনরায় চেষ্টা করার সুযোগ দেয়। যদি সেটআপ চলাকালীন সংরক্ষিত শংসাপত্র, ক্লায়েন্ট বা অনুমোদন অবস্থা পরিবর্তিত হয়, তবে পুরনো প্রচেষ্টা প্রস্তুত সংযোগ রিপোর্ট করার পরিবর্তে থেমে যায়।

FloodWait ডায়াগনস্টিকস ব্যর্থ TL পদ্ধতি, যেকোনো Takeout/range wrapper, সার্ভার-অনুরোধিত অপেক্ষা এবং কার্যকর সময়সীমা telegram.backoff-এ ধরে রাখে। সংযোগের বিবরণ পদ্ধতি এবং সময়সীমা দেখায় যখন অনুরোধগুলো বিরতিতে থাকে। ডায়াগনস্টিকে প্রতিটি পদ্ধতির ক্লায়েন্ট-কল কাউন্টার অন্তর্ভুক্ত থাকে, যেহেতু সেই ক্লায়েন্ট তৈরি হয়েছিল; এগুলো নেস্টেড পিয়ার রেজোলিউশন আলাদাভাবে গণনা করে, তবে প্যাকেট বা টেলিথনের অভ্যন্তরীণ পুনঃচেষ্টা গণনা করে না। বর্তমান কাউন্টারগুলি স্ট্যাটাস API-তে collector.rpc_activity হিসেবেও উপলব্ধ। কোনও অনুরোধ আর্গুমেন্ট, ব্যবহারকারীর নাম, অ্যাক্সেস হ্যাশ বা ব্যতিক্রমের টেক্সট অন্তর্ভুক্ত করা হয় না। শেষ ডায়াগনস্টিক এবং সম্পূর্ণ ডেডলাইন রিস্টার্টের পরও থাকে। পদ্ধতি রেকর্ড ছাড়া পূর্বের অপেক্ষাগুলিকে পরবর্তীতে আরোপ করা যায় না। উৎস পর্যালোচনা এবং আবিষ্কার ও ইতিহাস আহরণের মধ্যে পার্থক্য জানতে এক্সপোর্ট সীমাদেখুন।

official_app=True বা False হল টেলিগ্রামের বর্তমান-অনুমোদন ফ্ল্যাগ। কোনো মানই নির্ধারণ করে না যে অ্যাকাউন্টটি সীমাবদ্ধ, বিশ্বাসযোগ্য বা পর্যবেক্ষণের অধীনে। বিদ্যমান প্রমাণ-মোড account.devices স্ন্যাপশটগুলো সমস্ত সাইন-ইন করা ডিভাইসের ইতিহাস ধরে রাখে; সংযোগ নির্ণয় শুধুমাত্র বর্তমান ডিভাইসের বিবরণই ধরে রাখে।

সংযোগের আগে, পরামর্শমূলক যাচাইকরণ API প্ল্যাটফর্ম, ভাষা প্যাক, ডিভাইস/ওএস এবং অ্যাপ-সংস্করণ ফর্ম্যাট, মোবাইল সিস্টেম লোকেল, এবং টেলিথনের প্রকৃত স্কিমা স্তরকে পর্যালোচিত ক্যাটালগ বেসলাইনের সাথে তুলনা করে। সতর্কবার্তাগুলো সার্ভার লগ এবং অ্যাকাউন্ট স্ট্যাটাস মেটাডেটায় প্রদর্শিত হয়; এগুলো কখনই আমদানি করা মানগুলো প্রতিস্থাপন করে না বা স্কিমা স্তর পরিবর্তন করে না। একটি ভিন্ন স্তর সামঞ্জস্য পর্যালোচনার সংকেত দেয়; অ্যাকাউন্টের নিজস্ব সংযোগ স্থিতি দেখায় এটি কাজ করছে কিনা। টেলিগ্রাম তার নিজস্ব পক্ষ থেকে, যে কোনো ক্লায়েন্ট প্রোফাইলই ব্যবহার করা হোক না কেন, বিধিনিষেধ নির্ধারণ করে। বিচ্ছিন্ন অ্যাকাউন্টের স্ট্যাটাস অন্য কোনো ডিভাইসের বিবরণ তৈরি করার পরিবর্তে সংরক্ষিত প্রোফাইল ব্যবহার করে।

তার পরিবর্তে আপনার নিজস্ব অ্যাপ্লিকেশন ব্যবহার করতে:

  1. my.telegram.org খুলুন এবং আপনার যেকোনো ফোন নম্বর দিয়ে সাইন ইন করুন। কোডটি Telegram অ্যাপে আসে, SMS-এ নয়।
  2. API ডেভেলপমেন্ট টুলস নির্বাচন করুন।
  3. একটি অ্যাপ্লিকেশন তৈরি করুন: যেকোন শিরোনাম এবং সংক্ষিপ্ত নাম (৫–৩২ অক্ষর), প্ল্যাটফর্ম ডেস্কটপ। URL এবং বর্ণনা ফাঁকা রাখা যেতে পারে।
  4. অ্যাপের api_id (একটি সংখ্যা) এবং অ্যাপের api_hash (৩২ হেক্সাডেসিমাল অক্ষর) কপি করুন।

প্যানেলে, সাইন-ইন ফর্মের নিচে API আইডি + হ্যাশ খুলুন। আপনি একটি একক api_id:api_hash জোড়া API আইডি এবং উভয় ক্ষেত্রেই পেস্ট করতে পারেন। একটি জোড়া আপনার সমস্ত অ্যাকাউন্টের জন্য ব্যবহার করা যেতে পারে। সফল লগইন করার পর এটি শুধুমাত্র সেই ওয়ার্কস্পেসে এনক্রিপ্ট করা অবস্থায় সংরক্ষণ করা হয় এবং কখনই ব্রাউজারে ফেরত পাঠানো হয় না।

তিনটি ভিন্ন শংসাপত্র জড়িত:

গোপন খোলে যেখানে এটি বাস করে
প্যানেল টোকেন টিজিউইটনেস ওয়েব প্যানেল ডেটা ডিরেক্টরিতে panel-token.txt অথবা TGWITNESS_TOKEN
এপিআই আইডি + হ্যাশ নিজে থেকে কিছুই নয়; অ্যাপটিকে চিহ্নিত করে নির্মিত যুগল, আমদানি করা সেটিংস, অথবা আপনার নিজস্ব অ্যাপ my.telegram.org-এ
অ্যাকাউন্ট অনুমোদন টেলিগ্রাম অ্যাকাউন্ট ফোন/কিউআর লগইন দ্বারা তৈরি বা একটি সেশন হিসেবে আনা হয়েছে

যদি টেলিগ্রাম প্রক্সির মাধ্যমে অ্যাক্সেস করতে হয়, তবে প্রথমে More tools → Account → Settings → Connection settings → Change connection route-এ সেট করুন।

ফোন নম্বর#

  1. আরও টুলস → অ্যাকাউন্ট খুলুন, ফোন ট্যাবে যান, এবং নম্বরটি আন্তর্জাতিক ফরম্যাটে লিখুন, উদাহরণস্বরূপ +44 7700 900123। ফাঁকা স্থান এবং ড্যাশগুলো স্বয়ংক্রিয়ভাবে সরিয়ে ফেলা হয়।
  2. Continue চাপুন। API আইডি + হ্যাশ ফাঁকা থাকতে পারে।
  3. Telegram যে কোড পাঠায়, সাধারণত Telegram অ্যাপে, তা প্রবেশ করান; Telegram সিদ্ধান্ত নেয় SMS পাঠানো হবে কিনা।
  4. যদি অ্যাকাউন্টে দুই-ধাপ যাচাইকরণ থাকে, তবে সেই পাসওয়ার্ডটি লিখুন। এটি প্যানেল টোকেন নয় এবং ডিভাইস পাসকোডও নয়।
  5. লগইন করার পর প্রদর্শিত অ্যাকাউন্ট আইডি পরীক্ষা করুন, তারপর উৎসগুলো নির্বাচন করুন।

লগইন কোড এবং 2FA পাসওয়ার্ড কখনই ডিস্কে লেখা হয় না।

কিউআর কোড#

যখন অ্যাকাউন্ট ইতিমধ্যেই কোনো ফোনে বা অন্য কোনো কম্পিউটারে সাইন ইন করা থাকে, তখন এটি ব্যবহার করুন।

  1. QR কোডে ট্যাপ করুন → QR কোড দেখান। API আইডি + হ্যাশ ফাঁকা থাকতে পারে।
  2. সাইন-ইন করা ডিভাইসে: সেটিংস → ডিভাইসসমূহ → ডেস্কটপ ডিভাইস লিঙ্ক করুন, কোড স্ক্যান করুন এবং নিশ্চিত করুন।
  3. যদি টেলিগ্রাম অনুরোধ করে, TgWitness-এ 2FA পাসওয়ার্ড লিখুন।

QR চিত্রটি স্থানীয়ভাবে তৈরি করা হয়। কোডগুলির মেয়াদ শেষ হয়; পুনরায় চেষ্টা করতে 'অন্য QR কোড তৈরি করুন' চাপুন। প্যানেল লক করা, কর্মক্ষেত্র পরিবর্তন করা বা অন্য লগইন শুরু করলে অপেক্ষমান কোড বাতিল হয়ে যায়।

অথ কী + ডি সি আইডি#

একটি অ্যথ কী হল প্রতিটি টেলিগ্রাম সেশনের পেছনের কাঁচা ২৫৬-বাইট অনুমোদন, যা ৫১২ হেক্সাডেসিমাল অক্ষরে লেখা হয়, ডেটা-সেন্টার নম্বর DC 1–5-এর সাথে।

  1. Tab Auth কী। সম্পূর্ণ কীটি পেস্ট করুন; … ধারণকারী সংক্ষিপ্ত কীটি কাজ করবে না।
  2. চাবির সাথে সরবরাহিত DC আইডি নির্বাচন করুন।
  3. ঐচ্ছিকভাবে ব্যবহারকারী আইডি লিখুন। যদি টেলিগ্রাম ভিন্ন কোনো অ্যাকাউন্ট রিপোর্ট করে, তাহলে TgWitness সংযোগ করতে অস্বীকার করবে।
  4. প্রেস কানেক্ট অ্যাকাউন্ট।

একটি অ্যথ কী (৫১২ অক্ষর) API হ্যাশ (৩২ অক্ষর) নয়। একই কী JSON হিসেবেও আমদানি করা যেতে পারে, দেখুন অ্যাকাউন্ট JSON।

অ্যাকাউন্ট ফাইলসমূহ#

Open Add account → Files and select up to four files belonging to one account, 8 MiB in total, press Check files, then Connect account. Choosing files or pasting session text sends nothing; Check files sends them to your TgWitness server, which reads them without signing in and shows the session it found.

Files, Auth key এবং bulk-import ফর্মগুলো সংযোগের আগে সমান্তরাল-সেশনের সতর্কতা দেখায়। ডিফল্টভাবে আমদানি করা অনুমোদনগুলো পুনরায় ব্যবহার করা হয়। মূল ক্লায়েন্টটি বন্ধ রাখুন যতক্ষণ তার কী এখানে ব্যবহৃত হচ্ছে। Files এবং Auth key এছাড়াও Create an independent authorization অফার করে, যা নিচে বর্ণনা করা হয়েছে। বাল্ক ইমপোর্ট এখনও সরাসরি মোড ব্যবহার করে। ফোন এবং ইন্টারেক্টিভ QR লগইন পৃথক অনুমোদন তৈরি করে। আমদানি ফর্মে সতর্কবার্তার শিরোনাম দৃশ্যমান থাকে; ফাইল বা একটি কী/সেশন স্ট্রিং সরবরাহ করলে এর সম্পূর্ণ ব্যাখ্যা স্বয়ংক্রিয়ভাবে খুলে যায়। পড়ার পর এটি সংকুচিত করা যায়, যাতে ফোনে ফাইল পিকার এবং সংযোগ নিয়ন্ত্রণগুলো ব্যবহারযোগ্য থাকে।

একটি প্রত্যয়িত ডিপ্লয়মেন্ট (Phala Cloud, Intel TDX) আমদানি করা কী-তে সংগ্রহ করে না। সেখানে, Files এবং Auth কী শুধুমাত্র একটি স্বাধীন অনুমোদন নির্বাচন করার পরেই সংযুক্ত হয়; বাল্ক আমদানি প্রত্যাখ্যাত হয়। ফোন এবং QR লগইন স্বাভাবিকভাবেই কাজ করে।

  • ফাইলগুলো আপনার TgWitness সার্ভারের মেমরিতে রূপান্তরিত হয়। আপলোডগুলো সংরক্ষণ করা হয় না, ZIP ফাইলগুলো ডিস্কে এক্সট্র্যাক্ট করা হয় না এবং কোনো বাহ্যিক পরিষেবার সাথে যোগাযোগ করা হয় না।
  • এরপর প্রাপ্ত সেশন টেলিগ্রামের সাথে যাচাই করা হয়। যদি কোনো ফাইলে ব্যবহারকারী আইডি উল্লেখ থাকে, তবে তা টেলিগ্রাম যে অ্যাকাউন্ট রিপোর্ট করে তার সাথে মিলতে হবে।
  • বিভিন্ন অ্যাকাউন্ট বা বিভিন্ন API শংসাপত্র বর্ণনা করে এমন ফাইলগুলো বাছাই করার পরিবর্তে প্রত্যাখ্যাত হয়।
  • পাসকোড বা সেশন টেক্সট TData-এর লোকাল পাসকোড ফিল্ড ধারণ করে, একটি বক্স যা একটি StringSession পেস্ট করার জন্য এবং সাইন ইন না করে ফাইল পড়ার জন্য (টেলিগ্রামের সাথে যোগাযোগ না করে ফর্ম পূরণ করে)। একটি StringSession পেস্ট করলে নির্বাচিত ফাইলগুলো মুছে যায়, এবং ফাইল নির্বাচন করলে পেস্ট করা টেক্সট মুছে যায়, তাই চেক এবং সংযোগ সর্বশেষ পছন্দটি ব্যবহার করে। পাসকোড পরিবর্তনের পর আবার 'ফাইলগুলো পরীক্ষা করুন' চাপুন।

স্বতন্ত্র অনুমোদন তৈরি করুন#

স্বতন্ত্র অনুমোদননির্বাচন করুন, আমদানি করা ফাইল বা Auth Key সংযোগ করার আগে। TgWitnessআমদানি করা ডোনরকে সংক্ষিপ্তভাবে সংযুক্ত করে, নতুন ক্লায়েন্টের QR লগইন টোকেন অনুমোদন করতে এটি ব্যবহার করে, এবং অনুমোদনের পর অবিলম্বে ডোনরকে বিচ্ছিন্ন করে। নতুন ক্লায়েন্টের নিজস্ব অনুমোদন কী এবং পৃথকভাবে নির্বাচিত ডেস্কটপ প্রোফাইল রয়েছে। দাতার সরবরাহকৃত API শংসাপত্র এবং ডিভাইস প্রোফাইল শুধুমাত্র দাতার সংযোগের জন্য ব্যবহৃত হয়। কোনো বিদ্যমান অনুমোদন লগআউট বা বাতিল করা হয় না।

এই ধাপে ডোনরের মূল ক্লায়েন্টকে সম্পূর্ণরূপে বন্ধ রাখুন। প্রাথমিক সংযোগ এখনও এর অনুলিপি করা কী ব্যবহার করে, তাই এই মোড সেই প্রাথমিক সমান্তরাল-ব্যবহারের ঝুঁকি দূর করতে পারে না। একবার নতুন অনুমোদন সংযুক্ত হয়ে গেলে, মালিক মূল ক্লায়েন্টটি পুনরায় খুলতে পারবেন এবং উভয়ই একসঙ্গে ব্যবহার করতে পারবেন। ইন্টার‌্যাক্টিভ QR কোড লগইন মূল ক্লায়েন্টকে এখানে তার কী কপি বা সংযোগ না করেই লগইন অনুমোদন করতে দেয়।

দাতা সেশন থেকে লগ আউট করবেন না বা সেশন শেষ করবেন না। যখন QR লগইন অনুমোদনকারী সেশন শেষ হয়, টেলিগ্রামও অনুমোদিত সেশনটি শেষ করে; একটি লাইভ চেকে দেখা গেছে দাতা লগ আউট করার এক সেকেন্ডের মধ্যে নতুন অনুমোদন বন্ধ হয়ে গেছে। ইমপোর্ট দাতা সেশন রেকর্ড করে (session_origin.approved_by: ডিভাইস, API আইডি এবং তৈরি সময়)। সেশন তালিকা এটিকে চিহ্নিত করে, 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-এ, একটি নিবেদিত অ্যাকাউন্ট Telethon, Pyrogram এবং TData দাতাদের সাথে লাইভ চেক সম্পন্ন করেছে: 2FA সম্পন্ন, স্বতন্ত্র নতুন অনুমোদন কী, দাতা এবং নতুন ক্লায়েন্টের সমান্তরাল অ্যাক্সেস, এবং একটি পাবলিক চ্যানেল পড়া। Telethon ক্ষেত্রেও পাসওয়ার্ড ধাপে একটি বিঘ্নের পর সংরক্ষিত প্রার্থী পুনরায় শুরু করা হয়েছিল। প্রতিটি নতুন অনুমোদন ছয়টি লগইন-পরবর্তী প্রাথমিকীকরণ অনুরোধ সম্পন্ন করেছিল, এবং এর স্বাক্ষরিত জার্নাল যাচাই করা হয়েছিল। মূল সেশন চারটি সরবরাহিত ফরম্যাটেই ব্যবহারযোগ্য ছিল।

টেলিগ্রামের 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। টেলিগ্রাম ২৪ ঘণ্টার জন্য সাইন-ইন করা একটি সেশন থেকে এটি গ্রহণ করে। যখন এই ওয়ার্কস্পেসটি আমদানি করা একটি সেশন থেকে 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 হিসেবে রেকর্ড করা হয় টেলিগ্রামের কারণসহ, এবং কালেক্টর ছয় ঘণ্টা পর্যন্ত ক্রমবর্ধমান বিলম্ব নিয়ে পুনরায় চেষ্টা করে। এখানে শুধুমাত্র-পঠন (Read-only) কোনো প্রভাব ফেলে না: সেশন শেষ করা একটি অ্যাকাউন্ট-নিরাপত্তা ব্যবস্থা, চ্যাট-অ্যাকশন নয়।

স্বয়ংক্রিয় রানের মাধ্যমে তৈরি একটি দুই-ধাপের পাসওয়ার্ড টেলিগ্রাম সেট করার আগে ওয়ার্কস্পেস ভল্টে ওয়ার্কস্পেস কী দিয়ে এনক্রিপ্ট করে সংরক্ষণ করা হয়। প্যানেল একবার এটিকে থেকে আনয়ন করে POST /api/account/sessions/only/password থেকে একবার এটি আনতে হয়, যা এটি মুছে ফেলে, এবং আপনি যখন এই অ্যাকাউন্টের সেশন খুলবেন তখন ম্যানুয়াল ফ্লো-এর একই ডায়ালগে এটি দেখায়। সংযোগ পৃষ্ঠায় উল্লেখ থাকে যে একটি পাসওয়ার্ড অপেক্ষমান। এটি কখনোই জার্নালে প্রবেশ করে না এবং দেখানো না হওয়া পর্যন্ত রিস্টার্টের পরও টিকে থাকে।

পর্যবেক্ষণ করার সময় নতুন সেশনগুলিও রিপোর্ট করা হয়: যখন টেলিগ্রামের সেশন তালিকায় একটি এন্ট্রি যোগ হয়, account.sessions রেকর্ড এটিকে added এর অধীনে নামকরণ করে এবং প্যানেল সেই স্ন্যাপশট থেকে ডিভাইস, অ্যাপ্লিকেশন এবং দেশ সহ একটি সতর্কতা দেখায়।

সাক্ষী প্রব#

অতিরিক্ত টুল → অ্যাকাউন্ট → অ্যাকাউন্ট নিরাপত্তা → উইটনেস প্রোব পরীক্ষা করে অন্য কোনো ক্লায়েন্ট এই অ্যাকাউন্টের আপডেট পাচ্ছে কিনা। একটি ভিন্ন টেলিগ্রাম অ্যাকাউন্ট এবং নিজস্ব সেশন কী দিয়ে সাইন ইন করে দ্বিতীয় একটি ওয়ার্কস্পেস যোগ করুন, উভয় অ্যাকাউন্ট দিয়ে একটি ব্যক্তিগত গ্রুপ তৈরি করুন, তারপর সেই গ্রুপটিকে প্রোব চ্যাট এবং দ্বিতীয় ওয়ার্কস্পেসটিকে উইটনেস ওয়ার্কস্পেস হিসেবে নির্বাচন করুন এবং প্রোব চালু করুন। উভয় অ্যাকাউন্টে 'শুধুমাত্র-পঠন' (Read-only) বন্ধ থাকতে হবে, এবং উইটনেস ওয়ার্কস্পেসটি পর্যবেক্ষণে (observing) থাকতে হবে।

পর্যবেক্ষণ করার সময়, এই ওয়ার্কস্পেস প্রতি 60–120 সেকেন্ডে গ্রুপে probe:<n>:<token> পাঠায় এবং probe.sent রেকর্ড করে। সাক্ষী ack:<n>:<token> উত্তর দেয় এবং probe.seen ও probe.ack_sent রেকর্ড করে। 20 সেকেন্ডের মধ্যে লাইভ আপডেট হিসেবে এই সেশনে পৌঁছানো একটি ack probe.acked হিসেবে রেকর্ড করা হয়। অন্যথায় ওয়ার্কস্পেস গ্রুপের সাম্প্রতিক ইতিহাস পড়ে। সেখানে পাওয়া কিন্তু লাইভে ডেলিভারি না হওয়া একটি ack coverage.gap হিসেবে রেকর্ড করা হয়, কারণ probe_ack_missed_live: প্যানেল একটি সতর্কতা জারি করে এবং ইভেন্ট গ্রহণকে ব্যর্থ হিসেবে চিহ্নিত করে যতক্ষণ না পরে একটি ack লাইভে আসে (connection.restored, কারণ probe_ack_live)। কোনো ack probe.unanswered হিসেবে রেকর্ড করা হয় না; অপেক্ষার সময় সংযোগ বিঘ্নিত হলে বা ইতিহাস অস্পষ্ট হলে তা probe.inconclusive হিসেবে রেকর্ড করা হয়। শুধুমাত্র-পঠনযোগ্য, টেলিগ্রাম সীমাবদ্ধতা এবং FloodWait বিরতি একবার probe.skipped হিসেবে রেকর্ড করা হয়।

টেলিথন .session#

এটি কী SQLite ডাটাবেস টেলিথন-ভিত্তিক টুলগুলো তৈরি করে, উদাহরণস্বরূপ 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 ফোল্ডার (desktop.telegram.org থেকে ক্রস-প্ল্যাটফর্ম অ্যাপ)।

সিস্টেম ডিফল্ট tdata অবস্থান
উইন্ডোজ %APPDATA%\Telegram Desktop\tdata (পোর্টেবল টেলিগ্রাম: Telegram.exe-এর পাশে)
লিনাক্স ~/.local/share/TelegramDesktop/tdata
ম্যাকওএস ~/Library/Application Support/Telegram Desktop/tdata

এটি আমদানি করতে:

সমান্তরাল সেশন সতর্কতা। সরাসরি TData আমদানি Telegram Desktop-এর অনুমোদন কী পুনর্ব্যবহার করে। সেই কী Desktop-এ এবং TgWitness একই সাথে ব্যবহার করবেন না। Telegram অনুমোদন বাতিল করতে পারে, ফলে AUTH_KEY_DUPLICATED উভয় কপি নতুন লগইন না হওয়া পর্যন্ত অকার্যকর হয়ে যাবে।

Desktop সম্পূর্ণরূপে বন্ধ করুন, এর ট্রে প্রসেসসহ, এবং সেই কপিটি বন্ধ রাখুন যতক্ষণ না TgWitness আমদানি করা সেশন ব্যবহার করছে। বন্ধ করুন, লগ আউট বা সেশন বাতিল করবেন না: বাতিলকরণ আমদানি করা কপিকেও অকার্যকর করে। যদি উভয় ক্লায়েন্ট চালানোর প্রয়োজন হয়, নির্বাচন করুন, একটি স্বাধীন অনুমোদন তৈরি করুন এবং নতুন লগইন সফল না হওয়া পর্যন্ত ডেস্কটপ বন্ধ রাখুন, অথবা ফোন বা QR দ্বারা TgWitness-এ সাইন ইন করুন। একটি নিবেদিত অ্যাকাউন্টের পরামর্শ দেওয়া হয়, তবে এটি সমান্তরালভাবে ব্যবহারের জন্য ক্লোন করা কী-গুলোকে নিরাপদ করে না।

এটি আমদানি করা .session ফাইল, StringSession টেক্সট এবং Auth Key HEX-এর ক্ষেত্রেও প্রযোজ্য। অন্যান্য ক্লায়েন্টগুলো, যাদের নিজস্ব স্বতন্ত্র অনুমোদন রয়েছে, তারা সাইন-ইন অবস্থায় থাকতে পারে। Telegram-এর AUTH_KEY_DUPLICATED ডকুমেন্টেশন দেখুন।

  1. টেলিগ্রাম ডেস্কটপ সম্পূর্ণরূপে বন্ধ করুন।
  2. tdata থেকে শুধুমাত্র এই দুইটি আইটেম নিয়ে একটি ZIP তৈরি করুন:

    • key_datas
    • পাশের ১৬-অক্ষরের ফাইলটি যা s দিয়ে শেষ হয়, সাধারণত D877F783D5D3EF8Cs

    মিডিয়া ক্যাশসহ পুরো ফোল্ডারটি জিপ করলে সাধারণত সীমা অতিক্রম হয় (৫১২ এন্ট্রি, ৩২ MiB আনপ্যাকড)। ৩. ফাইলসে ZIP নির্বাচন করুন। যদি টেলিগ্রাম ডেস্কটপের একটি লোকাল পাসকোড থাকে, তবে প্রথমে সেটি Passcode বা সেশন টেক্সটের নিচে লিখুন। এটি 2FA পাসওয়ার্ড নয়।

সমর্থিত: প্রতি আর্কাইভে একটি অ্যাকাউন্ট, আধুনিক key_datas/key_data0/key_data1 স্টোরেজ এবং স্থানীয় পাসকোড। সমর্থিত নয়: একাধিক লগইন করা অ্যাকাউন্টের ফোল্ডার, পুরোনো Desktop ফাইল বিন্যাস, পাসওয়ার্ড-সুরক্ষিত ZIP এবং পৃথক নেটিভ macOS অ্যাপ "Telegram for macOS"।

টেলিথন স্ট্রিংসেশন#

একটি একক লাইনের টেক্সট, সাধারণত 1 দিয়ে শুরু হয় এবং প্রায় ৩৫০ অক্ষরের দীর্ঘ। এটিকে .txt বা .tgwitness-session ফাইল হিসেবে লোড করুন (সর্বোচ্চ ৪ KiB), অথবা পাসকোড বা সেশন টেক্সটের নিচে পেস্ট করুন। শুধুমাত্র Telethon স্ট্রিং গ্রহণ করা হয়; Pyrogram এবং TDLib স্ট্রিং ভিন্ন ফরম্যাট ব্যবহার করে।

অথ কী এবং 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 দিয়ে শেষ হওয়া একটি ফাইলে সর্বোচ্চ ৬৪ কিবি একটি JSON অবজেক্ট।

ক্ষেত্র (উপনামসমূহ) অর্থ
api_id (app_id) অ্যাপ্লিকেশন আইডি, একটি ধনাত্মক সংখ্যা
api_hash (app_hash) অ্যাপ্লিকেশন হ্যাশ, ৩২ হেক্সাডেসিমাল অক্ষর
string_session (session_string, session_str; legacy session) টেলিথন স্ট্রিংসেশন টেক্সট, অথবা <512 hexadecimal characters>:<DC id>, কোনো ফাইলের নাম নয়
auth_key (auth_key_hex) + dc_id ৫১২-অক্ষরের অ্যাক্সেস কী এবং 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 দেখা যায়। টেলিথন অথবা পাইরোগ্রাম এসকিউএলআইটি ফাইলসমূহ (স্বয়ংক্রিয়ভাবে সনাক্ত)
tdata ফোল্ডার যা key_datas ধারণ করে টেলিগ্রাম ডেস্কটপ টিডাটা দুটি ফাইল ZIP করুন, তারপর ফাইলসমূহ।
1 দিয়ে শুরু একটি টেক্সট লাইন, প্রায় ৩৫০ অক্ষর টেলিথন স্ট্রিংসেশন ফাইলসমূহ
একটি টেক্সট লাইন 512 characters 0-9a-f, তারপর : এবং একটি অঙ্ক 1–5 অথ কী এবং ডি‌সি ফাইল, বক্স পাসকোড বা সেশন টেক্সট
*.json app_id/app_hash সঙ্গী মেটাডেটা ফাইলসমূহ, এর সেশনের সাথে
*.json, auth_key বা string_session-এর সাথে অ্যাকাউন্ট JSON ফাইলসমূহ
৫১২ অক্ষর 0-9a-f অথ কী অথ কী
৩২টি অক্ষর 0-9a-f এপিআই হ্যাশ এপিআই আইডি + হ্যাশ
TDLib অ্যাপ থেকে td.binlog বা db.sqlite টিডিএলিব স্টোরেজ সমর্থিত নয়
123456789:AA… বট টোকেন সমর্থিত নয়

সমর্থনবিহীন ফরম্যাটসমূহ#

ফরম্যাট বিকল্প
TDLib স্টোরেজ (td.binlog) এবং TDLib এক্সপোর্টস ফোন বা QR দিয়ে সাইন ইন করুন
পাইরোগ্রাম সেশন স্ট্রিংসমূহ Pyrogram .session ফাইল ব্যবহার করুন, অথবা ফোন/কিউআর
অনেকগুলো লগইন করা অ্যাকাউন্টসহ TData টেলিগ্রাম ডেস্কটপে অন্যান্য অ্যাকাউন্টগুলো থেকে লগ আউট করুন, অথবা প্রতিটি অ্যাকাউন্টের নিজস্ব সেশন ফাইল ব্যবহার করুন।
বট টোকেনসমূহ সমর্থিত নয়: TgWitness একটি ব্যবহারকারী অ্যাকাউন্ট হিসেবে পর্যবেক্ষণ করে
অনেক অ্যাকাউন্টের CSV/JSON তালিকা হিসাবসমূহ → অ্যাকাউন্ট আমদানি করুন-এর মাধ্যমে সমর্থিত সেশন ফাইল আমদানি করুন, অথবা আলাদা ওয়ার্কস্পেসে ফোন/QR দিয়ে সাইন ইন করুন
টেস্ট-ডিসি বা বট সেশন একটি প্রোডাকশন ব্যবহারকারী অ্যাকাউন্ট ব্যবহার করুন

অনেকগুলো অ্যাকাউন্ট#

অ্যাকাউন্ট সিলেক্টরের পাশে + চাপুন, অথবা আরও টুলস → অ্যাকাউন্ট → সেটিংস → সংযোগ সেটিংস → ওয়ার্কস্পেস খুলুন, একটি লেবেল লিখুন এবং সাইন ইন করুন।

  • মূল সহ যেকোনো সংখ্যক ওয়ার্কস্পেস। প্রতিটিই নিজস্ব সেশন, প্রক্সি রুট, সোর্স, ক্যাপচার নীতি, জার্নাল, স্বাক্ষর কী, চেকপয়েন্ট এবং এক্সপোর্ট রয়েছে।
  • প্রদর্শিত কর্মক্ষেত্র পরিবর্তন করলে অন্যান্যগুলো থামে না।
  • একটি জার্নাল সবসময়ই সেটি তৈরি করা অ্যাকাউন্টের সাথে আবদ্ধ থাকে। অন্য একটি অ্যাকাউন্ট হিসেবে সাইন ইন করতে একটি আলাদা ওয়ার্কস্পেস প্রয়োজন, এবং একটি অ্যাকাউন্টকে দুটি ওয়ার্কস্পেসে বরাদ্দ করা যায় না।
  • প্রধান প্যানেলের টোকেন সমস্ত ওয়ার্কস্পেস নিয়ন্ত্রণ করে। ইস্যুকৃত অ্যাক্সেস অন্যদের নির্বাচিত অ্যাকাউন্ট এবং চ্যাটে সীমাবদ্ধ করতে পারে, পৃথক অনুমতি এবং সেশন সীমাসহ।
  • Accounts একটি ওয়ার্কস্পেসের নাম পরিবর্তন করে এবং একটি যোগ করা ওয়ার্কস্পেসকে তার সেশন, জার্নাল, সোর্স এবং স্বাক্ষর কীসহ মুছে ফেলে। প্রধান ওয়ার্কস্পেস প্যানেল থেকে মুছে ফেলা যায় না।

একসঙ্গে আমদানি ও অ্যাকাউন্ট গ্রুপ#

অ্যাকাউন্টস → ইমপোর্ট অ্যাকাউন্টস ব্যবহার করে একাধিক অ্যাকাউন্ট যোগ করুন, basename অনুযায়ী ফাইলগুলো জোড়া করুন এবং প্রতিটি লগইন ফলাফল দেখুন। প্রতিটি অ্যাকাউন্টের জন্য একটি নিজস্ব ওয়ার্কস্পেস তৈরি হয়।

একটি গ্রুপ সম্পর্কিত অ্যাকাউন্টগুলোকে একত্রিত রাখে, তাদের সেশন, কী বা প্রমাণ একত্রিত না করেই। গ্রুপ খুলুন-এ হিসাবসমূহ-এর লিঙ্ক এটিকে তার পৃষ্ঠায় নিয়ে যায় /groups/<id>:

  • হিসাবসমূহ: প্রতিটি সদস্যের সংযোগ পথ, পর্যবেক্ষণ এবং সর্বশেষ বার্তা, সাথে সব শুরু করুন এবং সব বিরতি দিন।
  • মনোযোগ প্রয়োজন: যে অ্যাকাউন্টগুলো সাইন আউট হয়েছে, অনুপলব্ধ বা সংযোগ, ইনটেক, সোর্স বা মিডিয়া সমস্যা রয়েছে; প্রতিটি নামের সাথে তার কার্ডের লিঙ্ক রয়েছে।
  • চ্যাটগুলো একাধিক অ্যাকাউন্টে দেখা যায়: শেয়ারকৃত উৎসসমূহ, সেগুলো পর্যবেক্ষণকারী অ্যাকাউন্টসমূহ এবং উপলব্ধ ওয়ার্কস্পেস-পর্যবেক্ষণ সময়সীমা (সর্বোচ্চ সাত দিন) এর মধ্যে বিঘ্ন। Nটি অ্যাকাউন্টের সাথে এক্সপোর্ট একটি চ্যানেল বা সুপারগ্রুপ এক্সপোর্টকে তাদের মধ্যে ভাগ করে এবং একটি আর্কাইভ স্বাক্ষর করে।
  • গ্রুপ রপ্তানি: প্রতিটি অ্যাকাউন্টের স্বাক্ষরিত এক্সপোর্টসহ একটি ZIP accounts/ এবং manifest.json তাদের SHA-256 এবং কী ফিঙ্গারপ্রিন্ট তালিকাভুক্ত করে, প্রধান ওয়ার্কস্পেস দ্বারা স্বাক্ষরিত manifest.signature.jsonপ্রতিটি অ্যাকাউন্ট আর্কাইভ স্বতন্ত্রভাবে যাচাই করুন python -m tgwitness.verify এবং সেই অ্যাকাউন্টের ট্রাস্টেড ফিঙ্গারপ্রিন্ট ব্যবহার করে যাচাই করুন।

সদস্যরা গ্রুপের সেটিংস শেয়ার করে; একটি অ্যাকাউন্ট তার নিজস্ব মান রাখতে পারে। শেয়ারকৃত সেটিংস, ইমপোর্ট এবং গ্রুপ গাইড দেখুন এবং MTProxy পুল ড্যাশবোর্ড।

সাইন আউট#

অতিরিক্ত টুল → অ্যাকাউন্ট → টেলিগ্রাম থেকে সাইন আউট (পর্যবেক্ষণ স্থগিত সহ) টেলিগ্রামকে সেশন শেষ করতে বলে, তাই এটি অ্যাকাউন্টের সেটিংস → ডিভাইস থেকেও অদৃশ্য হয়ে যায় এবং ওয়ার্কস্পেস ভল্ট থেকে সেশন সরিয়ে দেয়। জার্নাল, সোর্স, সেটিংস এবং স্বাক্ষর কী থাকে, এবং জার্নাল সাইন-আউট রেকর্ড করে। ওয়ার্কস্পেসটি এখনও তার অ্যাকাউন্টেরই: শুধুমাত্র সেই অ্যাকাউন্টই আবার এতে সংযোগ করতে পারবে। যদি টেলিগ্রাম সাড়া না দেয়, তবুও সেশনটি এখানে সরিয়ে ফেলা হবে এবং প্যানেল সেটি দেখাবে; টেলিগ্রামে Settings → Devices-এ গিয়ে এটি শেষ করুন।

যখন টেলিগ্রাম সেশন শেষ করে#

যদি টেলিগ্রাম অ্যাকাউন্ট নিষিদ্ধ করে, ফ্রিজ করে বা সাইন আউট করে, অথবা অন্য কোনো ডিভাইস থেকে সেশন শেষ করে, তাহলে জার্নাল কারণ, টেলিগ্রাম ত্রুটি, পথ এবং ডেটা সেন্টার রেকর্ড করে। অ্যাকাউন্টের হেলথ দেখায় 'অ্যাকাউন্ট ক্ষতি রিপোর্ট ডাউনলোড করুন': একটি স্বাক্ষরিত 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 স্কিমা: ৭ এবং ৮ / পাইরোগ্রাম … ২ এবং ৩ ফাইলটি একটি খুব পুরনো বা অজানা লাইব্রেরি সংস্করণ দ্বারা তৈরি করা হয়েছে। পরিবর্তে ফোন/কিউআর কোড দিয়ে সাইন ইন করুন।
শুধুমাত্র অনুমোদিত প্রোডাকশন ব্যবহারকারী সেশনগুলো সমর্থিত। Pyrogram ফাইলটি একটি বট বা টেস্ট নেটওয়ার্কের অন্তর্গত।
TData আর্কাইভ ৫১২ এন্ট্রি বা ৩২ MiB অতিক্রম করেছে শুধুমাত্র key_datas এবং D877F783D5D3EF8Cs-এর জিপ, পুরো ফোল্ডার নয়।
TData ডিক্রিপ্ট করা যাচ্ছে না। ডেস্কটপের স্থানীয় পাসকোড পরীক্ষা করুন। Passcode বা সেশন টেক্সট-এ Telegram Desktop-এর স্থানীয় পাসকোড লিখুন।
একবারে একটি TData অ্যাকাউন্ট আমদানি করুন টেলিগ্রাম ডেস্কটপে একাধিক অ্যাকাউন্ট ছিল; সমর্থিত নয় এমন ফরম্যাট দেখুন।
নির্বাচিত ফাইলগুলো বিভিন্ন অ্যাকাউন্ট বা API শংসাপত্র বর্ণনা করে। শুধুমাত্র একটি অ্যাকাউন্টের ফাইল নির্বাচন করুন।
JSON-এ কোনো সমর্থিত API শংসাপত্র বা অনুমোদন নেই। Account JSON-এ ফিল্ডের নামগুলো পরীক্ষা করুন।
শুধুমাত্র API মেটাডেটা JSON-এ কোনো সেশন নেই।.session ফাইল যোগ করুন অথবা ফোন/QR ব্যবহার করুন।
অথ কী HEX-এ সমস্ত ৫১২টি হেক্সাডেসিমাল অক্ষর থাকতে হবে। কীটি সংক্ষিপ্ত করা হয়েছে বা এতে … রয়েছে।
অ্যাকাউন্ট আইডি আমদানি করা অ্যাকাউন্টের সাথে মিলছে না। ফাইলের ব্যবহারকারী আইডি টেলিগ্রামের রিপোর্ট করা আইডি থেকে ভিন্ন; ফাইলটি অন্য একটি অ্যাকাউন্টের জন্য।
অ্যাকাউন্ট ইতিমধ্যেই অন্য একটি ওয়ার্কস্পেসের অন্তর্গত। অ্যাকাউন্টটি দুইবার যোগ করার পরিবর্তে সেই ওয়ার্কস্পেসটি খুলুন।
সংযুক্ত, কিন্তু More tools → Sources-এ চ্যাট তালিকায় একটি ব্যক্তিগত গ্রুপ অনুপস্থিত। সদস্যপদ যাচাই করুন। পিকার প্রথম 1,000টি ডায়ালগ পরিদর্শন করে; More tools → Parameters-এ গিয়ে সীমা বাড়ান।
প্রক্সি সংযোগ ব্যর্থ হয়েছে রুট এবং আইপি মোড পরীক্ষা করুন। স্বয়ংক্রিয় MTProxy অন্য একটি কার্যকর এন্ট্রি চেষ্টা করে। Hide the address অপেক্ষা করে; Direct, শেষ বিকল্প হিসেবে, নির্ধারিত বিলম্বের পর সরাসরি সংযোগ করতে পারে। রাউটিং মোড দেখুন।

আরও দেখুন: প্রক্সি এবং এনক্রিপশনের জন্য সংযোগ ও নিরাপত্তা, এবং সাইন-ইন করার পর কী সংগ্রহ করা হয় তা কীভাবে কাজ করে।