إنشاء روبوت تليجرام بسيط (Echo Bot) باستخدام بايثون

[Ali]

يعد إنشاء روبوت تليجرام نقطة انطلاق ممتازة لأي شخص مهتم بتطوير تطبيقات تفاعلية. في هذا الدليل، سنتعلم كيفية بناء "Echo Bot" بسيط باستخدام لغة بايثون ومكتبة python-telegram-bot. يقوم هذا الروبوت ببساطة بإعادة إرسال أي رسالة نصية يتلقاها، مما يجعله مثالاً مثالياً لفهم أساسيات التعامل مع الروبوتات.

المتطلبات الأساسية:

قبل البدء، تأكد من توفر ما يلي:

1. بايثون 3: مثبت على جهازك. يمكنك تنزيله من

برای دیدن لینک ها باید ثبت نام کنید

.
2. مدير الحزم pip: يأتي عادةً مع تثبيت بايثون.
3. حساب تليجرام: لإنشاء الروبوت واختباره.

الخطوة 1: الحصول على توكن الروبوت الخاص بك من BotFather

BotFather هو روبوت تليجرام رسمي يسمح لك بإنشاء روبوتات جديدة وإدارة الروبوتات الموجودة.

1. افتح تطبيق تليجرام وابحث عن @BotFather.
2. ابدأ محادثة معه وأرسل الأمر /newbot.
3. سيطلب منك BotFather اسمًا لروبوتك (مثال: MyEchoBot).
4. ثم سيطلب منك اسم مستخدم لروبوتك، والذي يجب أن ينتهي بـ "bot" (مثال: my_echo_bot).
5. بعد ذلك، سيزودك BotFather بـ "توكن API" (API Token). هذا التوكن هو مفتاحك للتحكم في الروبوت. احتفظ به سريًا! سيبدو شيء مثل: 1234567890:ABC-DEF1234ghIkl-NOPq_RstUVwXyz

الخطوة 2: إعداد بيئة العمل وتثبيت المكتبة

نوصي دائمًا باستخدام بيئة افتراضية (virtual environment) لمشاريع بايثون لتجنب تضارب الحزم.

1. إنشاء مجلد للمشروع:

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

2. إنشاء بيئة افتراضية وتنشيطها:

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

3. تثبيت مكتبة python-telegram-bot:

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

الخطوة 3: كتابة كود الروبوت

الآن حان وقت كتابة الكود. قم بإنشاء ملف جديد باسم echo_bot.py في مجلد مشروعك وأضف الكود التالي:

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

تذكر استبدال YOUR_BOT_TOKEN_HERE بالتوكن الفعلي الذي حصلت عليه من BotFather.

شرح الكود:

• telegram و telegram.ext: هذه هي الوحدات الرئيسية من مكتبة python-telegram-bot.
• TOKEN: المتغير الذي يحمل توكن API الخاص بروبوتك.
• start(update, context): هذه دالة async (غير متزامنة) يتم استدعاؤها عندما يرسل المستخدم الأمر /start. ترسل رسالة ترحيب.
• echo(update, context): هذه دالة async يتم استدعاؤها عندما يرسل المستخدم رسالة نصية (غير أمر). تعيد إرسال نص الرسالة.
• error_handler(update, context): دالة بسيطة لتسجيل أي أخطاء تحدث أثناء معالجة التحديثات.
• main(): هذه هي الدالة الرئيسية التي تقوم بإعداد وتشغيل الروبوت:

* Application.builder().token(TOKEN).build(): ينشئ كائن Application، وهو نقطة الدخول الرئيسية لتطبيق الروبوت.
* application.add_handler(...): يضيف "معالجات" (handlers) مختلفة.
* CommandHandler("start", start): يربط الأمر /start بالدالة start.
* MessageHandler(filters.TEXT & ~filters.COMMAND, echo): يربط جميع الرسائل النصية (التي ليست أوامر) بالدالة echo.
* application.run_polling(...): يبدأ الروبوت في "استقطاب" (polling) تحديثات جديدة من خوادم تليجرام. هذا يعني أنه سيتحقق باستمرار من الرسائل الجديدة والأوامر المرسلة إلى الروبوت الخاص بك.

الخطوة 4: تشغيل الروبوت واختباره

1. تأكد من تنشيط بيئتك الافتراضية.
2. قم بتشغيل السكريبت:

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

سترى رسالة "الروبوت قيد التشغيل..." في نافذة الطرفية.

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

الخاتمة:

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