يعد إنشاء روبوت تليجرام تفاعلي خطوة أساسية لأي مشروع أتمتة أو خدمة. في هذا الدليل، سنتعلم كيفية بناء روبوت بسيط باستخدام لغة بايثون ومكتبة
المتطلبات الأساسية
قبل البدء، تأكد من توفر ما يلي:
1. بايثون 3.x: مثبت على جهازك.
2. توكن الروبوت (Bot Token): تحصل عليه من BotFather على تليجرام.
الحصول على توكن الروبوت الخاص بك
لإنشاء روبوت جديد والحصول على التوكن الخاص به، اتبع الخطوات التالية:
1. افتح تطبيق تليجرام وابحث عن
2. ابدأ محادثة معه واكتب الأمر
3. سيطلب منك اسمًا للروبوت (مثال: MyFirstBot).
4. ثم سيطلب اسم مستخدم (يجب أن ينتهي بـ
5. بعد ذلك، سيزودك BotFather بتوكن فريد (على سبيل المثال:
تهيئة بيئة العمل
افتح سطر الأوامر أو الطرفية وقم بتثبيت مكتبة
كتابة كود الروبوت
الآن، لنقم بإنشاء ملف
1. استيراد المكتبات وتعريف التوكن
نبدأ باستيراد الفئات الضرورية من المكتبة وتحديد توكن الروبوت الخاص بنا.
2. تعريف معالجات الأوامر (Command Handlers)
معالجات الأوامر تستجيب للأوامر التي تبدأ بـ
3. تعريف معالج الرسائل النصية (Message Handler)
معالج الرسائل يستجيب لأي رسالة نصية لا تعتبر أمراً.
4. إعداد وبدء الروبوت
هنا نقوم بإنشاء
الكود الكامل (bot.py)
تشغيل الروبوت
1. احفظ الكود أعلاه في ملف باسم
2. تأكد من استبدال
3. افتح سطر الأوامر في نفس المجلد الذي حفظت فيه الملف.
4. قم بتشغيل السكربت:
سترى بعض رسائل السجل في الطرفية. الآن، اذهب إلى تليجرام، وابحث عن الروبوت الخاص بك (باستخدام اسم المستخدم الذي اخترته)، وابدأ محادثة معه.
الخطوات التالية
لقد قمت الآن بإنشاء روبوت تليجرام أساسي. يمكنك التوسع في هذا المشروع عن طريق:
python-telegram-bot الشهيرة، بحيث يمكنه استقبال الأوامر والرسائل النصية والرد عليها.المتطلبات الأساسية
قبل البدء، تأكد من توفر ما يلي:
1. بايثون 3.x: مثبت على جهازك.
2. توكن الروبوت (Bot Token): تحصل عليه من BotFather على تليجرام.
الحصول على توكن الروبوت الخاص بك
لإنشاء روبوت جديد والحصول على التوكن الخاص به، اتبع الخطوات التالية:
1. افتح تطبيق تليجرام وابحث عن
@BotFather.2. ابدأ محادثة معه واكتب الأمر
/newbot.3. سيطلب منك اسمًا للروبوت (مثال: MyFirstBot).
4. ثم سيطلب اسم مستخدم (يجب أن ينتهي بـ
bot، مثال: MyFirstPythonBot).5. بعد ذلك، سيزودك BotFather بتوكن فريد (على سبيل المثال:
123456789:ABCDEF-GHIJKL_MNOPQRSTUVWXYZ123456789). احتفظ بهذا التوكن سراً، فهو مفتاح التحكم في الروبوت الخاص بك.تهيئة بيئة العمل
افتح سطر الأوامر أو الطرفية وقم بتثبيت مكتبة
python-telegram-bot:
Bash:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
كتابة كود الروبوت
الآن، لنقم بإنشاء ملف
bot.py ونبدأ بكتابة الكود.1. استيراد المكتبات وتعريف التوكن
نبدأ باستيراد الفئات الضرورية من المكتبة وتحديد توكن الروبوت الخاص بنا.
Python:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
2. تعريف معالجات الأوامر (Command Handlers)
معالجات الأوامر تستجيب للأوامر التي تبدأ بـ
/ (مثل /start أو /help).
Python:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
3. تعريف معالج الرسائل النصية (Message Handler)
معالج الرسائل يستجيب لأي رسالة نصية لا تعتبر أمراً.
Python:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
4. إعداد وبدء الروبوت
هنا نقوم بإنشاء
Updater و Dispatcher، ونضيف المعالجات، ثم نبدأ الروبوت.
Python:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
الكود الكامل (bot.py)
Python:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
تشغيل الروبوت
1. احفظ الكود أعلاه في ملف باسم
bot.py.2. تأكد من استبدال
YOUR_BOT_TOKEN بالتوكن الحقيقي الخاص بك.3. افتح سطر الأوامر في نفس المجلد الذي حفظت فيه الملف.
4. قم بتشغيل السكربت:
کد:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
سترى بعض رسائل السجل في الطرفية. الآن، اذهب إلى تليجرام، وابحث عن الروبوت الخاص بك (باستخدام اسم المستخدم الذي اخترته)، وابدأ محادثة معه.
- أرسل
/startوسترى رسالة ترحيب. - أرسل
/helpوسترى رسالة المساعدة. - أرسل أي رسالة نصية أخرى، وسيقوم الروبوت بالرد عليها.
الخطوات التالية
لقد قمت الآن بإنشاء روبوت تليجرام أساسي. يمكنك التوسع في هذا المشروع عن طريق:
- إضافة المزيد من الأوامر المخصصة.
- استخدام الأزرار المضمنة (Inline Keyboards) أو لوحات المفاتيح الرد (Reply Keyboards).
- تخزين بيانات المستخدمين في قاعدة بيانات.
- دمج الروبوت مع واجهات برمجة تطبيقات (APIs) خارجية لجلب البيانات (مثل الطقس، الأخبار، إلخ).
- نشر الروبوت على خادم ليعمل 24/7.