بناء أول بوت تليجرام لك باستخدام Python

[Ali]

بوتات تليجرام (Telegram Bots) هي حسابات خاصة لا يديرها البشر، بل برامج حاسوبية صغيرة يمكنها أداء مجموعة واسعة من المهام، بدءًا من إرسال الإشعارات وتلقي المعلومات ووصولاً إلى إنشاء ألعاب تفاعلية وخدمات دعم العملاء. في هذا الدليل، سنتعلم كيفية بناء بوت تليجرام بسيط باستخدام لغة البرمجة Python ومكتبة python-telegram-bot.

المتطلبات الأساسية:
قبل البدء، تأكد من توفر الآتي:
1. Python: يجب أن تكون Python 3 مثبتة على جهازك. يمكنك تنزيلها من الموقع الرسمي python.org.
2. pip: مدير حزم Python، والذي يأتي عادةً مثبتًا مع Python.
3. مكتبة python-telegram-bot: يمكنك تثبيتها باستخدام الأمر التالي في سطر الأوامر (Terminal/CMD):

محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید

(نستخدم --pre للحصول على أحدث الإصدارات التجريبية التي تدعم واجهة برمجة تطبيقات Telegram Bot API 6.0+)

الخطوة 1: الحصول على توكن البوت (Bot Token)
لإنشاء بوت تليجرام، ستحتاج إلى "توكن" (Token) خاص به. هذا التوكن هو مفتاح فريد لبوتك ويسمح لك بالتحكم فيه.
1. افتح تطبيق تليجرام وابحث عن @BotFather.
2. ابدأ محادثة مع BotFather واكتب /newbot.
3. سيطلب منك BotFather اسمًا لبوتك (مثال: MyFirstBot).
4. ثم سيطلب اسم مستخدم فريدًا لبوتك ينتهي بـ bot (مثال: MyFirstAwesomeBot).
5. بعد ذلك، سيزودك BotFather بتوكن API الخاص بالبوت. احتفظ بهذا التوكن بأمان ولا تشاركه مع أحد. سيكون شيئًا كهذا: 1234567890:AAH_randomstringofcharacters-randomcharacters

الخطوة 2: كتابة الكود البرمجي للبوت
الآن، لنكتب الكود البرمجي الذي سيجعل بوتك يستجيب لأول أمر. سنقوم بإنشاء بوت بسيط يرد بـ "مرحباً!" عندما يكتب المستخدم الأمر /start.

أنشئ ملفًا جديدًا باسم my_bot.py (أو أي اسم تفضله) والصق الكود التالي فيه:

محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید

شرح الكود:

• import logging: لتسجيل الأحداث والرسائل من البوت، مما يساعد في تتبع المشاكل.
• from telegram import Update: يمثل هذا الكائن تحديثًا واردًا من تليجرام (مثل رسالة جديدة).
• from telegram.ext import ApplicationBuilder, ContextTypes, CommandHandler: هذه هي المكونات الأساسية من مكتبة python-telegram-bot.

* ApplicationBuilder: لإنشاء وتهيئة تطبيق البوت.
* ContextTypes: لتحديد أنواع السياقات الافتراضية.
* CommandHandler: لمعالجة الأوامر التي تبدأ بـ / (مثل /start).

• async def start(...): هذه دالة غير متزامنة (async) يتم استدعاؤها عندما يرسل المستخدم الأمر /start.

* update: يحتوي على معلومات حول التحديث الوارد (الرسالة، المرسل، إلخ).
* context: يحتوي على معلومات وسياق إضافي للبوت.
* await update.message.reply_text('مرحباً! أنا بوتك الأول.'): هذا هو الجزء الذي يجعل البوت يرد. يستخدم reply_text لإرسال رسالة نصية ردًا على رسالة المستخدم.

• def main(): هذه هي الدالة الرئيسية التي تقوم بتهيئة البوت وتشغيله.

* application = ApplicationBuilder().token('YOUR_BOT_TOKEN').build(): يقوم بإنشاء مثيل لتطبيق البوت الخاص بك ويقوم بتمرير التوكن الخاص به. تأكد من استبدال 'YOUR_BOT_TOKEN' بالتوكن الفعلي الخاص بك.
* application.add_handler(CommandHandler("start", start)): يخبر البوت أنه عندما يتلقى الأمر /start، يجب أن يستدعي الدالة start.
* application.run_polling(): يبدأ البوت في الاستماع للتحديثات الواردة من تليجرام. polling يعني أنه يقوم بفحص خوادم تليجرام بشكل دوري بحثًا عن رسائل جديدة.

• if __name__ == '__main__': main(): يضمن أن الدالة main يتم استدعاؤها فقط عند تشغيل الملف مباشرة.

الخطوة 3: تشغيل البوت
احفظ الملف my_bot.py، ثم افتح سطر الأوامر (Terminal/CMD) في نفس المجلد الذي حفظت فيه الملف، وقم بتشغيل الكود باستخدام الأمر التالي:

محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید

إذا سار كل شيء على ما يرام، سترى رسائل تسجيل في سطر الأوامر تشير إلى أن البوت قد بدأ.

الآن، افتح تطبيق تليجرام، وابحث عن اسم المستخدم الخاص ببوتك (الذي أنشأته باستخدام BotFather)، وابدأ محادثة معه. أرسل الأمر /start، ويجب أن يرد بوتك بالرسالة "مرحباً! أنا بوتك الأول.".

تهانينا! لقد قمت ببناء وتشغيل أول بوت تليجرام لك. هذه مجرد البداية، فمكتبة python-telegram-bot توفر العديد من الميزات القوية الأخرى مثل الأزرار المضمنة (Inline Keyboards)، وتخزين بيانات المستخدم، والتعامل مع أنواع مختلفة من الرسائل (صور، مستندات،