جلسة تيليجرام لـ Telethon هي مفتاح، وليست تطبيقًا
جلسة تيليجرام لـ Telethon هي مفتاح مصادقة (عادةً ما يكون ملف SQLite بامتداد .session أو سلسلة نصية StringSession)، وليست نافذة تطبيق تيليجرام. هي التي تسمح لعميل Python الخاص بك بالتواصل عبر بروتوكول MTProto كأنه مستخدم. إذا نقرت نقرًا مزدوجًا على الملف وتوقعت ظهور قائمة محادثات، فقد طلبت الصيغة الخاطئة. أما إذا كنت تحتاج إلى أن تُرجع دالة get_me() كائن مستخدم، فهذا هو المنتج الصحيح.
هذا الدليل موجه للمطورين والمشغلين الذين يستخدمون Telethon بالفعل (أو يخططون لذلك)، ويريدون استلام الجلسات من مخزون مملوك، ويحتاجون إلى اختبار حي وواضح ومسار للاستبدال. يمكنك تصفح الكتالوج من حسابات تيليجرام. من المهم فهم أنك تشتري صيغة تسليم، وهذا يختلف عن المصطلحات الأوسع مثل الحسابات الجاهزة أو الجديدة أو القديمة.
النقاط الرئيسية
- جلسة Telethon هي ملف مفتاح مصادقة أو StringSession، وليست نافذة تطبيق سطح مكتب.
- اختر Session (Telethon) من صفحة حسابات تيليجرام؛ فالمخزون هو نفسه، لكن طريقة التسليم مختلفة.
- الاختبار الحي: اتصل باستخدام
api_id/api_hashالخاصين بك، ثم استدعِ دالةget_me().- غيّر المصادقة الثنائية (2FA) بعد نجاح الاختبار؛ تعامل مع كل نسخة إضافية من المفتاح على أنها ثغرة أمنية.
- المفاتيح المعطلة (
AuthKeyUnregistered، رقم هاتف خاطئ) هي حالة تستدعي الاستبدال، وليست مشكلة تتطلب تعديل ملف SQLite يدويًا.
ما هي جلسة Telethon بالضبط؟
جلسة Telethon هي مفتاح المصادقة الذي يستخدمه عميل Python الخاص بك للتواصل عبر بروتوكول MTProto كأنه مستخدم. يقوم Telethon بإنشائها عند بناء كائن مثل TelegramClient('anon') وإكمال عملية تسجيل الدخول. بعد ذلك، يصبح الملف هو نفسه بمثابة تسجيل الدخول.
داخل ملف .session نموذجي، ستجد أجزاءً أساسية وحيوية: مركز البيانات الذي يجب الاتصال به، ومفتاح المصادقة الذي يشفّر حركة المرور ليتعامل تيليجرام مع العملية على أنها تابعة لذلك المستخدم، وذاكرة تخزين مؤقت للكيانات التي رآها العميل. يمكن لذاكرة التخزين المؤقت أن تجعل حجم الملف أكبر من مجرد «مفتاح صغير» دون أن تحوله إلى سجل محادثات قابل للقراءة. لا تفتح ملف SQLite بحثًا عن الرسائل. الاختبار الحي هو إجراء اتصال ناجح.
StringSession هو نفس المفتاح ولكن بصيغة نصية. هذه الصيغة ملائمة في البيئات التي تتخلص من نظام الملفات الخاص بها. لكن تسريبها أسهل. أي شخص يمتلك السلسلة النصية يمكنه تسجيل الدخول بذلك المستخدم. احتفظ بالسلاسل النصية في مخزن أسرار، وليس في مستودع الشيفرة البرمجية. يمكن لتسجيل دخول حي واحد أن يتحول إلى مفتاحين عند تصديره؛ لذا احسب عدد النسخ.
توكن البوت هو كائن ثالث مختلف: وهو سر HTTP لواجهة برمجة تطبيقات البوت (Bot API). إنه ليس جلسة مستخدم. إذا كان اختبارك يتطلب من مستخدم الضغط على زر «ابدأ»، فأنت تحتاج إلى جلسة مستخدم. أما إذا كان اختبارك يتطلب من البوت أن يجيب، فأنت تحتاج إلى التوكن.
كيف تشتري تسليمًا بصيغة Session / Telethon على TgFather؟
على TgFather، يمكنك اختيار تسليم بصيغة Session (Telethon) من نفس كتالوج الحسابات المملوكة المتاح لصيغة TData. افتح صفحة حسابات تيليجرام، اختر Session، ثم حدد الدولة والفئة العمرية. يتم التسليم فورًا بعد الخصم من المحفظة. تكون التنزيلات متاحة عبر روابط موقّعة ومنتهية الصلاحية.
أنت تشتري صيغة تسليم، وليس نوعًا مختلفًا من الحسابات. اختر Session لأن شيفرتك البرمجية تستخدم Telethon. اختر TData إذا كان هناك شخص سيستخدم الحساب عبر Telegram Desktop. اختر رمز تسجيل دخول حي إذا كنت تريد إدخاله يدويًا في عميل تتحكم فيه. اختيار صيغة خاطئة لأنها «تبدو احترافية» سيظل خيارًا خاطئًا لحالتك.
إذا فشلت دالة get_me() مع جلسة تم تسليمها، فهذه حالة تستوجب الاستبدال، وليست نقاشًا حول بنية ملف SQLite. قم بإجراء اختبارك الخاص قبل بناء مهام إنتاجية على المفتاح.
هل يجب أن تختار صيغة Session قبل اختيار الدولة؟
نعم، حدد صيغة التسليم أولاً، ثم اختر الدولة والفئة العمرية. افتح صفحة حسابات تيليجرام، اختر Session (Telethon)، حدد الدولة والفئة العمرية، واحجز حسابًا يمكنك اختباره في نفس اليوم.
ما هو الاختبار الحي الذي يجب أن تجريه؟
قم بإجراء اتصال حقيقي واستدعاء لدالة get_me() باستخدام api_id و api_hash الخاصين بك قبل أن تثق بالملف. لا تثق بملف لمجرد أن امتداده هو .session. ولا تثق بسلسلة نصية لمجرد أنها طويلة.
ما الذي تبحث عنه:
- اتصال ناجح.
- الحصول على كائن مستخدم كناتج.
- تطابق معرّف المستخدم ورقم الهاتف مع الحساب الذي اعتقدت أنك اشتريته.
اسم المستخدم المميز يمكن أن يتغير. لكن المعرّف لا يتغير. عدم تطابق المعرّف هو سبب لطرح سؤال على الدعم الفني. عدم تطابق رقم الهاتف يعني أن هذا شخص آخر.
حالات الفشل:
- لا يمكن الاتصال: ليست جلسة حية.
- يتصل، ثم يطلب كلمة مرور سحابية لم تُعطَ لك: القفل الثاني مفقود.
AuthKeyUnregistered: المفتاح الموجود في الملف لم يعد مسجلاً. أصبح تذكارًا. اطلب استبدالاً؛ لا تحاول تعديل ملف SQLite يدويًا.
تثبت دالة get_me() أن المفتاح لا يزال قادرًا على العمل. لكنها لا تثبت «عمر الحساب ونشاطه». بعد نجاح الاختبار، قم بتعيين أو تغيير التحقق بخطوتين. كلمة المرور السحابية تمنع تسجيلات الدخول الجديدة؛ لكنها لا تحذف ملفات الجلسات التي تم تصديرها بالفعل. إذا وصلت كلمة مرور سحابية مع الجلسة، فغيّرها. لا تعيد استخدام كلمة المرور من حسابك الشخصي على تيليجرام.
مقارنة: Telethon مقابل StringSession مقابل TData مقابل توكن البوت
ملفات جلسات Telethon و StringSession هي مفاتيح مستخدم؛ TData مخصصة لـ Telegram Desktop؛ وتوكن البوت مخصص لواجهة Bot API. طابق الصيغة مع حالة استخدامك قبل الدفع.
Telethon .session |
StringSession | TData | توكن البوت | |
|---|---|---|---|---|
| ما هو | ملف SQLite يحتوي على مفتاح المصادقة + ذاكرة تخزين مؤقت | نفس المفتاح كنص | مجلد عمل Telegram Desktop | سر HTTP لبوت |
| ما الذي يفتحه | Telethon | Telethon | Telegram Desktop | Bot API / أي عميل HTTP |
| هل يبدو كتطبيق؟ | لا | لا | نعم، على سطح المكتب | لا |
| الاختبار الحي | اتصال + get_me() |
اتصال + get_me() |
الإعدادات تظهر الرقم | getMe على Bot API |
| تعامل معه كـ | كلمة مرور | كلمة مرور سهلة اللصق | كلمة مرور في مجلد | كلمة مرور |
كل من Telethon و Pyrogram يتحدثان بروتوكول MTProto وكلاهما يكتب «جلسات». لكن ملفاتهما غير قابلة للتبديل. لا تُدخل ملف .session من Telethon إلى عميل Pyrogram. ولا تلصق سلسلة نصية من Pyrogram في StringSession. إذا كان مشروعك يستخدم Pyrogram، فاشترِ أو أنشئ جلسة Pyrogram. القوائم التي تذكر فقط كلمة «جلسة» دون تحديد المكتبة البرمجية هي مضيعة لوقتك.
كيف يجب تخزين المفتاح واستخدامه بأمان؟
خزّن ملف الجلسة أو السلسلة النصية كما تفعل مع كلمة المرور: لا تلصقها في أي مكان، لا تضفها إلى مستودع الشيفرة البرمجية، ولا تنشئ نسخًا عشوائية منها. أي شخص يمتلك المفتاح يكون مسجلاً دخوله بذلك المستخدم من أي مكان يقوم فيه بتشغيل العميل.
قواعد عملية:
- لا تلصقها في مجموعة «فقط للتأكد».
- لا تضفها إلى مستودع الشيفرة البرمجية (commit).
- جهازان بنسختين يعني وجود مفتاحين.
- إذا قمت بإلغاء الصف الخاطئ في قائمة أجهزة تيليجرام، فسيفشل استدعاء
get_me()التالي مع خطأAuthKeyUnregistered. - بعد أول استدعاء ناجح لـ
get_me()، توقف عن العبث. ضع الملف حيث يمكن للعملية قراءته. تعامل مع كل نسخة إضافية على أنها ثغرة أمنية.
الاستخدامات المشروعة: بيئة اختبار تحتاج إلى مستخدم حقيقي يتحدث إلى بوت، أو سكربت دعم يسحب محادثة طلبها مستخدم، أو صندوق وارد لمرحلة التطوير لتطبيق مصغر (Mini App). الإيصال لا يمنحك إعفاءً من إرسال رسائل جماعية غير مرغوب فيها.
هل تحتاج بدلاً من ذلك إلى حساب مخصص للاستخدام البشري عبر تطبيق سطح المكتب؟ يمكنك العثور على صيغ مختلفة ضمن حسابات تيليجرام. هل تحتاج إلى معرف بوت بدلاً من مفتاح مستخدم؟ تتوفر أيضاً بوتات تيليجرام القديمة.
من أين تشتري، وماذا يغطي الاستبدال؟
اشترِ تسليمًا بصيغة Session من حسابات TgFather؛ يغطي الاستبدال المفاتيح المعطلة، وليس أخطاء تخزين الأسرار. ابدأ من حسابات تيليجرام: اختر Session (Telethon)، والدولة، والفئة العمرية. ادفع من المحفظة. قم بالتنزيل من الرابط الموقّع. شغّل get_me(). غيّر كلمة المرور السحابية. ابدأ بالبناء فقط بعد أن يثبت المفتاح أنه حي.
المفتاح المعطل (AuthKeyUnregistered، رقم هاتف خاطئ، مصادقة ثنائية مفقودة وُعدت بها) هو مسار للاستبدال للمخزون المملوك، وليس حجة بأن «الجلسات هكذا». احتفظ بـ api_id / api_hash الخاصين بك وبطريقة تخزين آمنة للأسرار. الكتالوج يسلّم الصيغة؛ وعمليتك هي المسؤولة عن النظافة الأمنية بعد التسليم.
جلسة تيليجرام هي مفتاح المصادقة هذا. و Telethon هي مكتبة Python التي تطرح السؤال على تيليجرام. إذا بحثت عن تسليم بصيغة Telethon، فأنت لا تزال تشتري ملفًا (أو سلسلة نصية)، وليس نافذة تطبيق.
عندما تكون جاهزًا: اشترِ حسابات تيليجرام مع تسليم بصيغة Session.
أسئلة متكررة
ما هي StringSession في Telethon؟
الـ StringSession هي مفتاح المصادقة الخاص بك بصيغة سطر نصي واحد، بدلاً من تخزينه في ملف .session. تحتوي على نفس المعلومات الحيوية، مثل مركز البيانات ومفتاح المصادقة. هذه الصيغة ملائمة للبيئات التي يكون فيها نظام الملفات مؤقتًا. ومع ذلك، لأنها مجرد نص، يمكن أن يكون تسريبها أسهل عن طريق الخطأ. يجب عليك تخزين StringSession في مدير أسرار، وليس مباشرة في مستودع الشيفرة البرمجية الخاص بك.
هل يمكنني قراءة سجل المحادثات من ملف .session؟
لا، لا يمكنك قراءة سجل محادثاتك مباشرة من ملف .session. الملف عبارة عن قاعدة بيانات SQLite تحتوي على مفتاح المصادقة الخاص بك وذاكرة تخزين مؤقت للكيانات التي رآها عميلك، وليس تصديرًا للرسائل. إذا كنت بحاجة إلى الوصول إلى الرسائل، فيجب عليك استخدام الجلسة مع عميل Telethon حي للاتصال بخوادم تيليجرام واستردادها. لا تحاول فتح الملف للبحث عن الرسائل.
هل أحتاج إلى api id خاص بي لجلسة مشتراة؟
نعم، يجب عليك استخدام api_id و api_hash الخاصين بك عند الاتصال بجلسة Telethon مشتراة. ملف الجلسة نفسه هو مجرد مفتاح مصادقة المستخدم، بينما تحدد بيانات اعتماد API تطبيقك المحدد لتيليجرام. يتطلب الاختبار الحي للتحقق من جلسة جديدة أن تتصل باستخدام تفاصيل API الخاصة بك. هذا يثبت أن المفتاح يمكنه التحدث نيابة عن المستخدم من خلال نسخة تطبيقك.
هل يجب تغيير كلمة المرور السحابية لجلسة جديدة؟
نعم، يجب عليك تغيير كلمة مرور التحقق بخطوتين، المعروفة أيضًا باسم كلمة المرور السحابية، فورًا بعد التأكد من أن الجلسة تعمل. كلمة المرور السحابية تقفل محاولات تسجيل الدخول الجديدة، مما يضيف طبقة من الأمان. إذا تم تزويدك بكلمة مرور مع الجلسة، فغيّرها إلى كلمة مرور لا يعرفها سواك. هذا يساعد في تأمين الحساب ضد أي شخص آخر قد يكون لديه حق الوصول إلى بيانات الاعتماد الأصلية أو ملف الجلسة.