هذا المشروع عبارة عن بوت تيليجرام (Telegram Bot) إسلامي، صُمم خصيصاً لتسهيل نشر آيات القرآن الكريم مع تلاوة صوتية عالية الجودة بأصوات نخبة من مشاهير القرّاء في القنوات و المجموعات.
يتميز البوت بواجهة استخدام بسيطة و لوحة تحكم مخصصة للمديرين، مما يضمن تجربة سلسة سواء في القنوات أو المجموعات.
الصفحات و الأقسام داخل البوت
- واجهة الترحيب للمستخدمين العاديين.
- لوحة تحكم المديرين.
- إدارة القنوات والجروبات.
- إحصائيات مفصلة.
- إعدادات الفاصل الزمني للنشر التلقائي.
مميزاته
- نشر آيات قرآنية مع معلومات كاملة عن السورة و الآية و الجزء و الحزب و الصفحة.
- تلاوة صوتية نقية من أكثر من 20 قارئ مشهور.
- نظام إدارة متعدد المستويات (مدير أساسي – مديرين – مستخدمين).
- دعم القنوات و المجموعات بسهولة.
- نشر تلقائي بفاصل زمني قابل للتخصيص.
- إحصائيات دقيقة لعدد القنوات و المجموعات و الرسائل المرسلة.
القراء المتاحون
يضم البوت أصوات قراء مميزين مثل:
- عبد الباسط عبد الصمد (مرتّل و مجوّد).
- مشاري العفاسي.
- ماهر المعيقلي.
- عبد الرحمن السديس.
- سعود الشريم.
- محمود خليل الحصري (مرتّل و مجوّد).
- محمد صديق المنشاوي (مرتّل و مجوّد).
- أحمد بن علي العجمي.
- أبو بكر الشاطري.
- علي الحذيفي.
- محمد أيوب.
- محمد جبريل.
- أيمن سويد.
و غيرهم...
التقنيات المستخدمة
- لغة بايثون الإصدار 3.7 أو أي إصدار أحدث.
- مكتبة pyTelegramBotAPI
- مكتبة requests
- مكتبة schedule
- AlQuran Cloud API لجلب الآيات و التلاوات.
- Telegram Bot API للتفاعل مع تليجرام.
خطوات إنشاء بوت في تيليجرام و الحصول على معلوماته
لتشغيل هذا المشروع تحتاج أولاً أن تنشئ بوت تيليجرام خاص بك و من ثم تنسخ المعلومات الخاص به و تحديداً BOT_TOKEN و ADMIN_ID لأنك ستحتاج إضافتها في كود المشروع.
الخطوة الأولى: إنشاء بوت جديد و الحصول على التوكن (BOT_TOKEN) الخاص به.
- إفتح تطبيق التيليجرام و توجه لمربع البحث ثم ابحث عن
@BotFather(يجب أن يكون لديه علامة ✓ للتحقق الرسمي). - أنقر عليه لتبدأ المحادثة معه.
- أرسل له الأمر
/newbotحتى تبدأ خطوات إنشاء بوت جديد. - سيطلب منك اختيار إسم للبوت، ثم اسم مستخدم (يجب أن ينتهي بكلمة
botو يجب أن يكون فريداً). - بمجرد إنشاء البوت بنجاح، سيزودك BotFather برمز API فريد. هذا هو التوكن الخاص بك.
ملاحظة أمنية: تعامل مع هذا الرمز ككلمة مرور؛ لا تشاركه علناً.
الخطوة الثانية: الحصول على المعرّف الشخصي لهذا البوت (USER_ID) و الذي يكون لك فيه صلاحيات المدير له.
- إبحث في تيليجرام عن بوت مخصص لعرض المعرّف (مثل
@userinfobotأو@getidbot). - أرسل أي رسالة بسيطة له، مثل "مرحباً".
- سيرد عليك فوراً برسالة تتضمن معرّف المستخدم الخاص بك.
طريقة التشغيل
- قم بتحميل المشروع.
2- فك الضغط عنه.
3- إفتح سطر الأوامر (CMD) و توجه لمسار المشروع.
4- لضمان عدم حدوث تعارض بين المكتبات المثبتة و المكتبات التي يحتاجها المشروع، قم بإنشاء و تفعيل بيئة افتراضية باستخدام الأمر التالي.
python -m venv venv
5- قم بتفعيل البيئة الإفتراضية و هنا عليك استخدام الأمر المناسب لنظام التشغيل الذي تستعلمه أنت.
- في حال كنت تستعمل نظام ويندوز إستخدم الأمر التالي.
venv\Scripts\activate
- في حال كنت تستعمل نظام لينكس/ماك إستخدم الأمر التالي.
source venv/bin/activate
6- قم بتثبيت المكتبات التالية بواسطة مدير الحزم pip باستخدام الأمر التالي.
pip install -r requirements.txt
7- إفتح الملف bot.py و قم بإضافة توكن البوت في السطر 11، و قم بإضافة معرّف الأدمن في السطر 15، و قم بإضافة رابط حساب الأدمن في السطر 16.
8- قم بتشغيل المشروع باستخدام الأمر التالي.
python bot.py
9- بعد تنفيذ أوامر المشروع بنجاح، يمكنك غلق المشروع لأنه يفترض أن يكون قد تم إنشاء محتوى البوت بشكل صحيح.
10- الآن، إفتح تطبيق التيليجرام و توجه إلى البوت الخاص بك و ستجد واجهة المستخدم التي تم إنشاؤها في المشروع تظهر فيه.
عرض للمشروع
يمكنك مشاهدة محتوى البوت عبر رابط الفيديو التالي:
