بناء روبوت تليجرام بسيط: روبوت الصدى باستخدام Python-telegram-bot

[Ali]

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

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

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

1. لغة بايثون (Python): إصدار 3.6 أو أحدث مثبت على جهازك.
2. مكتبة python-telegram-bot: سنقوم بتثبيتها في الخطوة التالية.
3. توكن (Token) لروبوت تليجرام: ستحصل عليه من BotFather.

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

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

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

الخطوة 2: تثبيت مكتبة python-telegram-bot

افتح موجه الأوامر (Command Prompt أو Terminal) وقم بتنفيذ الأمر التالي:

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

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

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

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

شرح الكود:

• TOKEN = "YOUR_BOT_TOKEN": استبدل YOUR_BOT_TOKEN بالتوكن الفعلي الذي حصلت عليه من BotFather.
• start(update, context): هذه الدالة تُنفذ عندما يرسل المستخدم الأمر /start للروبوت. تقوم بإرسال رسالة ترحيب إلى المستخدم.

* update.effective_user.first_name: للحصول على اسم المستخدم الأول.
* update.message.reply_text(...): لإرسال رد نصي إلى المستخدم.

• echo(update, context): هذه الدالة تُنفذ عندما يتلقى الروبوت أي رسالة نصية ليست أمراً.

* update.message.text: يحتوي على نص الرسالة التي أرسلها المستخدم.
* await update.message.reply_text(update.message.text): يقوم الروبوت بإعادة إرسال نفس النص الذي استلمه.

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

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

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

1. احفظ الملف echo_bot.py (أو الاسم الذي اخترته).
2. افتح موجه الأوامر (Command Prompt أو Terminal) وانتقل إلى المجلد الذي حفظت فيه الملف.
3. قم بتشغيل السكريبت باستخدام الأمر التالي:

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

سترى رسائل في الطرفية تشير إلى أن الروبوت قد بدأ بنجاح.

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

لإيقاف الروبوت، اضغط على Ctrl+C في الطرفية التي يعمل فيها السكريبت.

الخطوات التالية:

لقد قمت الآن بإنشاء وتشغيل أول روبوت تليجرام لك! يمكنك البناء على هذا الأساس لإضافة المزيد من الميزات، مثل:

• معالجة أنواع مختلفة من الرسائل (صور، مستندات، مواقع).
• إضافة أوامر مخصصة.
• التعامل مع لوحات المفاتيح المضمنة ولوحات المفاتيح المخصصة.
• التفاعل مع واجهات برمجة التطبيقات (APIs) الخارجية لجلب البيانات.

استكشف توثيق مكتبة python-telegram-bot الرسمي لمزيد من الأمثلة والوظائف المتقدمة.