الحسابات وتنسيقات الجلسات

تقوم TgWitness بتسجيل الدخول كحساب مستخدم Telegram (وليس كروبوت) عبر بروتوكول MTProto، باستخدام Telethon. ويوجد كل حساب في مساحة عمل خاصة به (تُسمى «مساحة العمل» في واجهة برمجة التطبيقات وأدوات سطر الأوامر) مع جلسة عمل ومصادر وسجل ومفتاح توقيع خاص به.

ملفات الجلسة وسلاسل الجلسة ومفاتيح المصادقة هي تفويضات للحساب: فمن يمتلك أيًا منها يمكنه التصرف بصفته صاحب ذلك الحساب. ولا تحتوي هذه العناصر على سجل الرسائل.

[!تحذير] لا تستخدم أي شيء لا يمكنك تحمل خسارته. ننصح بشدة بعدم ربط حسابات شخصية أو حسابات قيّمة بأي شكل آخر، وكذلك بعدم إنشاء معرّف API / تجزئة API على حساب تقدّره. لا يتعلق الأمر هنا بعدم اختبار TgWitness: فـ Telegram يقيد و يحظر الحسابات بشكل دائم وبطريقة غير متوقعة — وذلك بسبب حجم الطلبات الذي يعتبره مفرطًا، بغض النظر عن العميل أو الغرض، ودون توثيق كافٍ. العديد من حالات الحظر لا رجعة فيها. استخدم حسابات مخصصة. تعتمد سلاسة عمليات الاختبار على Telegram، وليس على البرنامج، ولا تضمن أي شيء في المستقبل.

• لمحة عامة
• قبل البدء: معرّف واجهة برمجة التطبيقات (API ID) وتجزئة واجهة برمجة التطبيقات (API hash)
• رقم الهاتف · رمز الاستجابة السريعة (QR) · مفتاح المصادقة + معرّف DC
• ملفات الحسابات: Telethon .session · Pyrogram .session · زوج من الجلسة وملف JSON · TData · StringSession · حساب JSON
• حدد ما لديك · التنسيقات غير المدعومة
• حسابات متعددة · الحفاظ على أمان ملفات الحسابات · حل المشكلات

لمحة عامة#

تتعرف TgWitness على الملفات من خلال محتوياتها، وليس من خلال أسمائها. ولا تؤدي إعادة تسمية الملف إلى تحويله أبدًا.

قبل البدء: معرّف واجهة برمجة التطبيقات (API ID) وتجزئة واجهة برمجة التطبيقات (API hash)#

يمكنك تسجيل الدخول دون إنشاء تطبيق Telegram API. عندما لا يتم إدخال أي زوج، أو استيراده أو حفظه مسبقًا في مساحة العمل، تختار TgWitness زوجًا من مجموعتها المدمجة المكونة من 50 زوجًا من أزواج API العامة (tgwitness/api_pool.py) بترتيب عشوائي. إذا رفض Telegram زوجًا (API_ID_INVALID، API_ID_PUBLISHED_FLOOD، UPDATE_APP_TO_LOGIN)، يتم تجربة الزوج التالي، بحد أقصى ثمانية أزواج لكل عملية تسجيل دخول؛ ويتم تخطي الأزواج المرفوضة حتى إعادة التشغيل. يتم حفظ الزوج الذي تم تسجيل الدخول به مع الحساب وإعادة استخدامه له. يعمل معرّف واجهة برمجة التطبيقات (API ID) وتجزئة واجهة برمجة التطبيقات (API hash) على تعريف التطبيق لدى Telegram؛ وهما لا يصرحان بتسجيل الدخول إلى الحساب بمفردهما.

لاستخدام تطبيقك الخاص بدلاً من ذلك (الحساب الذي يسجله هو الذي يتعرض للخطر؛ انظر: لماذا توجد مجموعة واجهات برمجة تطبيقات (API) مدمجة؟):

1. افتح my.telegram.org وقم بتسجيل الدخول باستخدام أي رقم هاتف تمتلكه. سيصل الرمز إلى تطبيق Telegram، وليس عبر رسالة SMS.
2. اختر أدوات تطوير واجهة برمجة التطبيقات (API).
3. إنشاء تطبيق: أي عنوان واسم مختصر (5–32 حرفًا)، منصة سطح المكتب. يمكن ترك حقل عنوان URL والوصف فارغين.
4. انسخ معرّف التطبيق (api_id) (رقم) وتجزئة التطبيق (api_hash) (32 حرفًا سداسي عشري).

في اللوحة، يوجد «معرف API المفتوح + التجزئة» أسفل نموذج تسجيل الدخول. يمكنك لصق زوج واحد من api_id:api_hash في حقل «معرف API» ليتم ملء كلا الحقلين تلقائيًا. يمكن استخدام زوج واحد لجميع حساباتك. بعد تسجيل الدخول بنجاح، يتم حفظ البيانات مشفرة في مساحة العمل تلك فقط ولا يتم إرسالها أبدًا إلى المتصفح.

تتضمن هذه العملية ثلاثة أنواع مختلفة من بيانات الاعتماد:

إذا كان لا بد من الوصول إلى Telegram عبر وكيل (بروكسي)، فقم بتعيينه أولاً من خلال «الحساب» → «الإعدادات» → «إعدادات الاتصال» → «تغيير مسار الاتصال».

رقم الهاتف#

1. افتح حسابًا، ثم انتقل إلى علامة التبويب «الهاتف»، وأدخل الرقم بالصيغة الدولية، على سبيل المثال +44 7700 900123. تتم إزالة المسافات والشرطات تلقائيًا.
2. اضغط على «متابعة». يمكن ترك حقل «معرف API» و«التجزئة» فارغين.
3. أدخل الرمز الذي يرسله Telegram (عادةً إلى تطبيق Telegram؛ ولا يُضمن وصوله عبر الرسائل القصيرة).
4. إذا كان الحساب مزودًا بالتحقق بخطوتين، فأدخل كلمة المرور تلك. فهي ليست رمز اللوحة ولا رمز مرور الجهاز.
5. تحقق من معرّف الحساب الذي يظهر بعد تسجيل الدخول، ثم اختر المصادر.

لا يتم أبدًا تسجيل رموز تسجيل الدخول وكلمة مرور المصادقة الثنائية (2FA) على القرص.

رمز الاستجابة السريعة (QR)#

استخدم هذه الميزة عندما يكون الحساب مسجلاً بالفعل على هاتف أو جهاز كمبيوتر آخر.

1. انقر على رمز QR → اعرض رمز QR. يمكن ترك حقل معرّف API + التجزئة فارغًا.
2. على الجهاز الذي قمت بتسجيل الدخول إليه: الإعدادات → الأجهزة → ربط جهاز سطح المكتب، امسح الرمز ضوئيًّا ثم قم بالتأكيد.
3. أدخل كلمة مرور المصادقة الثنائية (2FA) في TgWitness إذا طلبها Telegram.

يتم إنشاء صورة رمز الاستجابة السريعة (QR) محليًّا. تنتهي صلاحية الرموز؛ اضغط على «إنشاء رمز QR آخر » لإعادة المحاولة. يؤدي قفل اللوحة أو التبديل بين مساحات العمل أو بدء عملية تسجيل دخول أخرى إلى إلغاء الرمز المعلق.

مفتاح المصادقة + معرّف DC#

مفتاح المصادقة (Auth Key) هو مفتاح المصادقة الخام المكون من 256 بايت الذي يقف وراء كل جلسة Telegram، ويُكتب على شكل 512 حرفًا سداسي عشريًّا، إلى جانب رقم مركز البيانات DC 1–5.

1. مفتاح المصادقة في علامة التبويب. الصق المفتاح كاملاً؛ فالمفتاح المختصر الذي يحتوي على … لا يعمل.
2. اختر معرّف DC المرفق مع المفتاح.
3. يمكنك إدخال معرّف المستخدم اختياريًّا. عندئذٍ يرفض TgWitness الاتصال إذا أبلغ Telegram عن حساب مختلف.
4. حساب Press Connect.

مفتاح المصادقة (512 حرفًا) ليس تجزئة واجهة برمجة التطبيقات (API) (32 حرفًا). يمكن أيضًا استيراد المفتاح نفسه بتنسيق JSON، انظر JSON الحساب.

ملفات الحسابات#

افتح «إضافة حساب» → «الملفات» واختر ما يصل إلى أربعة ملفات تابعة لحساب واحد، بحد أقصى 8 ميغابايت، ثم اضغط على «ربط الحساب».

• يتم تحويل الملفات في الذاكرة على خادم TgWitness الخاص بك. لا يتم تخزين الملفات التي يتم تحميلها، ولا يتم استخراج ملفات ZIP إلى القرص، ولا يتم الاتصال بأي خدمة خارجية.
• ثم يتم التحقق من الجلسة الناتجة مع Telegram. إذا كان الملف يحتوي على معرّف مستخدم، فيجب أن يتطابق مع الحساب الذي يبلغ عنه Telegram.
• يتم رفض الملفات التي تصف حسابات مختلفة أو بيانات اعتماد API مختلفة بدلاً من اختيار واحدة منها.
• يحتوي حقل «رمز المرور» أو «نص الجلسة» على حقل «TData local passcode»، وهو مربع مخصص للصق ملفات StringSession وRead دون تسجيل الدخول (يملأ النموذج دون الاتصال بـ Telegram).

Telethon .session#

أغلق أولاً البرنامج الذي أنشأ الملف. إذا كان my_account.session-journal أو my_account.session-wal موجودًا بجانبه، فهذا يعني أن قاعدة البيانات لم تكتمل بعد: افتح العميل الأصلي وأغلقه بشكل صحيح. قد يؤدي حذف ملفات «sidecar» هذه إلى ترك نسخة تالفة.

Pyrogram .session#

يتم التحقق من معرّف المستخدم المخزّن مقابل Telegram أثناء تسجيل الدخول.

زوج من الجلسة وملف 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).

Telegram Desktop (TData)#

TData هو المجلد tdata الخاص بتطبيق Telegram Desktop (التطبيق متعدد المنصات المتوفر على desktop.telegram.org).

لاستيرادها:

تحذير بشأن الجلسات المتوازية. يؤدي استيراد TData إلى إعادة استخدام مفتاح الترخيص الخاص بـ Telegram Desktop ؛ ولا يؤدي إلى إنشاء تسجيل دخول مستقل. لا تستخدم هذا المفتاح في Desktop و TgWitness في آن واحد. يمكن لـ Telegram إبطال صلاحية الترخيص باستخدام AUTH_KEY_DUPLICATED، مما يجعل كلا النسختين غير قابلتين للاستخدام حتى إجراء تسجيل دخول جديد.

أغلق Desktop تمامًا، بما في ذلك العملية الموجودة في علبة النظام، واحتفظ بهذه النسخة مغلقة أثناء استخدام TgWitness للجلسة المستوردة. أغلق التطبيق، ولا تقم بتسجيل الخروج أو إلغاء الجلسة: حيث يؤدي الإلغاء أيضًا إلى إبطال صلاحية النسخة المستوردة. إذا كنت بحاجة إلى تشغيل كلا العميلين، فقم بتسجيل الدخول إلى TgWitness عبر الهاتف أو رمز الاستجابة السريعة (QR) لإنشاء تفويض خاص به. يُنصح باستخدام حساب مخصص، ولكن هذا لا يجعل استخدام المفاتيح المستنسخة بالتوازي آمنًا.

وينطبق هذا أيضًا على الملفات المستوردة .session والنصوص في StringSession ومفتاح المصادقة HEX. يمكن للعملاء الآخرين الذين لديهم تصاريح تم إنشاؤها بشكل مستقل أن يظلوا مسجلين الدخول. انظر وثائق Telegram الخاصة بـ AUTH_KEY_DUPLICATED.

1. أغلق تطبيق Telegram Desktop تمامًا.

2. قم بإنشاء ملف ZIP يحتوي فقط على هذين العنصرين من tdata:

   • key_datas
   • الملف المكون من 16 حرفًا الذي ينتهي بـ «s» بجانبه، وعادةً ما يكون «D877F783D5D3EF8Cs»

   عادةً ما يتجاوز ضغط المجلد بأكمله مع ذاكرة التخزين المؤقتة للوسائط الحدود المسموح بها (512 إدخالًا، 32 ميغابايت بعد فك الضغط). 3. حدد ملف ZIP في قسم «الملفات». إذا كان لدى Telegram Desktop رمز مرور محلي، فأدخله أولاً في حقل «رمز المرور» أو نص الجلسة. هذه ليست كلمة مرور المصادقة الثنائية (2FA).

ميزات مدعومة: حساب واحد لكل أرشيف، تخزين حديث بنظام key_datas/key_data0/key_data1، ورمز مرور محلي. ميزات غير مدعومة: المجلدات التي تحتوي على عدة حسابات مسجلة الدخول، وتصميمات سطح المكتب القديمة، وملفات ZIP المحمية بكلمة مرور، والتطبيق الأصلي المنفصل لنظام macOS «Telegram for macOS».

Telethon StringSession#

سطر واحد من النص، يبدأ عادةً بـ 1 ويبلغ طوله حوالي 350 حرفًا. قم بتحميله كملف .txt أو .tgwitness-session (بحد أقصى 4 كيلوبايت)، أو الصقه تحت «رمز المرور» أو «نص الجلسة». لا تُقبل سوى سلاسل Telethon؛ أما سلاسل Pyrogram وTDLib فتستخدم تنسيقات مختلفة.

حساب JSON#

كائن JSON واحد، بحجم 64 كيلوبايت كحد أقصى، في ملف ينتهي بـ .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.

تسجيل الخروج#

الحساب → تسجيل الخروج من Telegram (مع إيقاف المراقبة مؤقتًا) يطلب من Telegram إنهاء الجلسة، وبالتالي تختفي أيضًا من «الإعدادات» → «الأجهزة» في الحساب، وتُزال الجلسة من خزينة مساحة العمل. ويبقى السجل والمصادر والإعدادات ومفتاح التوقيع، و يسجل السجل عملية تسجيل الخروج. لا تزال مساحة العمل مملوكة لحسابها: ولا يمكن إلا لهذا الحساب الاتصال بها مرة أخرى. إذا لم يستجب Telegram، تُزال الجلسة مع ذلك هنا وتشير اللوحة إلى ذلك؛ قم بإنهائها في Telegram ضمن الإعدادات → الأجهزة.

تحويل جلسة Telethon إلى وضع غير متصل بالإنترنت#

تستورد اللوحة ملفات .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 ميغابايت)، ولا يقوم أبدًا بتعديل البيانات المدخلة، ولا يرسل أي طلبات إلى الشبكة، ويرفض الكتابة فوق ملف الإخراج الموجود.

الحفاظ على أمان ملفات الحسابات#

• تعامل مع كل .session وملف TData ZIP وStringSession ومفتاح المصادقة وملف JSON الخاص بالحساب كما لو كان كلمة مرور. تحتفظ TgWitness بتفويضات الدخول المستوردة في خزينة مشفرة؛ ويمكنك إزالة الملفات الأصلية بعد ذلك.
• لا تقم بتشغيل نفس التفويض في برنامجين في آن واحد. فقد يقوم Telegram بإلغائه (AUTH_KEY_DUPLICATED)، وستتوقف النسختان عن العمل.
• لا يمكن إعادة تنشيط جلسة منتهية الصلاحية أو تم إلغاؤها عن طريق التحويل. يرجى تسجيل الدخول مرة أخرى.

حل المشكلات#

انظر أيضًا: الاتصال والأمان للوكلاء والتشفير، وكيفية عمل عملية التجميع لما يتم التقاطه بعد تسجيل الدخول.