دليل الاستخدام ومركز المساعدة

تعلم كيفية تجهيز، إدارة وإطلاق بوتك بكل سهولة وسرعة

1. كيف تبدأ؟ 2. طريقة رفع البوت 3. التشغيل والمتابعة 4. حل الأخطاء الشائعة

1. مرحباً بك – كيف تبدأ رحلتك؟

لبدء تشغيل بوتك يجب أن تمتلك حساباً على المنصة. لا يتطلب منك التسجيل تأكيد بريد إلكتروني، فقط أدخل اسم مستخدم وكلمة مرور للدخول للوحة التحكم الأساسية الخاصة بك (Dashboard).

2. طريقة رفع وإعداد البوت

خطوات تجهيز مشروعك:

1
اضغط على "+ NEW ENGINE" واختر نوع السيرفر (Python أو PHP) وأطلق عليه اسماً لتمييزه.
2
قم بالدخول للملفات واسحب ملفات لغة البايثون .py لمربع الرفع أو أنشئ ملف جديد.
3
هام: اكتب اسم الملف الرئيسي لبوتك في المكان المخصص لـ Entrypoint (مثلاً: bot.py) حتى يعلم النظام من أين يقلع السيرفر.

لا تنسَ وضع التوكن الخاص في الملف أو استخدام متغيرات النظام (Environment Variables) إذا كان الكود يدعمها.

3. التشغيل ومتابعة التحديثات الحية

بعد تعيين الملف الرئيسي، يمكنك النقر على زر "إقلاع / Start".

ستقوم استضافة الذئب بقراءة الملفات وإن كُشفت مكتبات غير مثبته (مثل Telethon أو Requests) سيتم تنزيلها أوتوماتيكيا بفضل تقنية Auto-Install.

افتح نافذة Terminal / Logs الخاصة بالبوت لرؤية مخرجات الطرفية والأخطاء (إن وجدت) والمخرجات المطبوعة بـ print.

4. حل الأخطاء الشائعة والمشاكل المعتادة

- خطأ ModuleNotFoundError لا يزول؟
هذا يعني أن النظام واجه مشكلة أثناء التثبيت التلقائي للمكتبة، يُفضل إنشاء ملف requirements.txt ووضع أسماء المكتبات داخله.

- السيرفر يقوم بحالة (Offline) باستمرار؟
غالباً كود البوت مكتوب بطريقة خاطئة فيتوقف لحظة تشغيله، راجع قسم السجلات لمعرفة رسالة الخطأ.

- تم حظر الملفات الخاصة بي؟
إذا تم استهلاك المساحة أو استخدام سيرفرك لأغراض ضارة (سبام) سيضطر الإداريين لإيقافه. يمكنك التواصل عبر تلجرام لفك الحظر إذا كان هناك سوء فهم.