README.md

بوت النشر التلقائي للمحتوى العربي على تيليجرام

هذا البوت يقوم بإنشاء وجدولة ونشر محتوى عربي عالي الجودة في قنوات تيليجرام تلقائياً باستخدام نماذج Gemini AI من Google.

المميزات

• 🤖 إنشاء محتوى عربي تلقائي باستخدام Gemini 2.0 Flash
• 📅 جدولة المنشورات على فترات منتظمة
• 📊 لوحة تحكم سهلة الاستخدام باللغة العربية
• 📱 واجهة مدير كاملة عبر محادثة تيليجرام الخاصة
• 📈 إحصائيات وتقارير لمراقبة أداء البوت
• 🔄 نظام تنويع المحتوى لضمان جودة المنشورات

متطلبات النظام

• PHP 7.3 أو أحدث
• إمكانية استخدام cURL
• إمكانية إعداد مهام كرون (CRON Jobs)
• توكن بوت تيليجرام
• مفتاح API لـ Gemini

خطوات التثبيت

1. إنشاء بوت تيليجرام:

   • تحدث مع BotFather على تيليجرام
   • اكتب الأمر /newbot واتبع التعليمات للحصول على توكن البوت

2. إضافة البوت إلى قناتك:

   • أضف البوت كمشرف في القناة التي ترغب بنشر المحتوى فيها
   • تأكد من إعطاء البوت صلاحية نشر الرسائل

3. الحصول على مفتاح API من Gemini:

   • قم بزيارة Google AI Studio
   • أنشئ مشروعاً جديداً واحصل على مفتاح API

4. إعداد البوت:

   • انسخ ملفات البوت إلى مجلد على خادم الويب
   • عدل المعلومات في ملف config.php (توكن البوت، معرف القناة، مفتاح API)
   • قم بزيارة الرابط https://your-domain.com/path/to/index.php?setup لإعداد البوت

5. إعداد مهمة كرون:

   • أضف سطر كرون التالي لتشغيل البوت كل 5 دقائق:

     */5 * * * * php /path/to/cron.php
     

ملفات المشروع

• config.php - ملف الإعدادات والثوابت
• functions.php - الدوال المساعدة للتعامل مع واجهة تيليجرام
• content_generator.php - إنشاء المحتوى باستخدام Gemini API
• scheduler.php - نظام جدولة المنشورات
• admin_panel.php - لوحة تحكم المشرف
• webhook.php - معالج ويب هوك لاستقبال التحديثات من تيليجرام
• cron.php - مهمة كرون لمعالجة المنشورات المجدولة
• setup.php - أداة الإعداد والتثبيت
• index.php - الصفحة الرئيسية ونقطة الدخول للتطبيق

طريقة استخدام البوت

1. بعد إكمال عملية التثبيت، قم بمراسلة البوت على تيليجرام:

   • أرسل /start لعرض القائمة الرئيسية

2. استخدم أزرار لوحة التحكم للتفاعل مع البوت:

   • 📊 إحصائيات - عرض إحصائيات المنشورات والنشاط
   • 📅 المنشورات المجدولة - عرض المنشورات القادمة
   • 📝 إنشاء منشور - إنشاء منشور جديد يدوياً
   • ⚙️ الإعدادات - تعديل إعدادات البوت
   • 📋 سجل النشر - عرض سجل المنشورات السابقة

3. عند إنشاء منشور جديد:

   • يمكنك نشره فوراً باستخدام 📢 نشر الآن
   • أو جدولته لوقت لاحق باستخدام ⏰ جدولة النشر

أوامر البوت المتاحة

• /start - بدء استخدام البوت وعرض القائمة الرئيسية
• /posts [العدد] - تعديل عدد المنشورات اليومية (مثال: /posts 4)
• /active - تفعيل النشر التلقائي
• /inactive - إيقاف النشر التلقائي
• /refresh - تحديث جدول المنشورات لليوم الحالي
• /schedule HH MM - جدولة منشور في وقت محدد (مثال: /schedule 18 30)
• /delete [معرف] - حذف منشور مجدول

أنواع المحتوى

يدعم البوت خمسة أنواع من المحتوى:

• أخبار تكنولوجية
• نصائح تقنية
• توعية تقنية
• برمجة وتطوير
• أمن سيبراني

استكشاف الأخطاء وإصلاحها

• البوت لا يرسل المنشورات: تأكد من إضافة البوت كمشرف في القناة
• خطأ في توليد المحتوى: تحقق من صلاحية مفتاح API الخاص بـ Gemini
• مشاكل في الجدولة: تأكد من تكوين مهمة كرون بشكل صحيح
• أخطاء في webhook: تأكد من أن الخادم يمكنه استقبال طلبات HTTPS

الدعم والمساهمة

للحصول على المساعدة أو تقديم اقتراحات، يمكنك التواصل مع مطور البوت.