بناء أول روبوت تلجرام: روبوت الصدى باستخدام بايثون

[Ali]

تعد روبوتات تلجرام أداة قوية للتفاعل مع المستخدمين وأتمتة المهام المختلفة. نقطة البداية المثالية لكل مطور روبوت تلجرام هي بناء "روبوت الصدى" (Echo Bot). هذا الروبوت البسيط سيتعلم كيفية الاستماع إلى الرسائل الواردة والرد عليها بنفس المحتوى، مما يمثل أساسًا متينًا لفهم آليات عمل الروبوتات.

في هذا الدليل، سنتعلم خطوة بخطوة كيفية بناء روبوت صدى باستخدام لغة بايثون ومكتبة python-telegram-bot الشهيرة.

1. المتطلبات الأساسية

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

• بايثون 3.6+: مثبت على جهازك. يمكنك تنزيله من
  برای دیدن لینک ها باید ثبت نام کنید
  .
• pip: مدير الحزم الخاص ببايثون، يأتي عادةً مثبتًا مع بايثون.
• حساب تلجرام: لاستخدام BotFather وإنشاء الروبوت.
• معرفة أساسية ببايثون: لفهم الكود المكتوب.

2. الحصول على توكن الروبوت الخاص بك (Bot Token)

كل روبوت تلجرام يحتاج إلى توكن فريد (API Token) للتعريف به والتواصل مع خوادم تلجرام. سنحصل عليه من "BotFather":

1. افتح تطبيق تلجرام وابحث عن المستخدم BotFather. تأكد من أنه الحساب الرسمي (يحتوي على علامة توثيق).
2. ابدأ محادثة معه بالنقر على "بدء" أو إرسال الأمر /start.
3. لإنشاء روبوت جديد، أرسل الأمر /newbot.
4. سيطلب منك BotFather اسمًا للروبوت. اختر اسمًا يعرض للمستخدمين (مثال: روبوت الصدى الخاص بي).
5. بعد ذلك، سيطلب اسم مستخدم (Username) للروبوت. يجب أن ينتهي بـ _bot (مثال: MyEchoBot_by_username_bot). يجب أن يكون اسم المستخدم هذا فريدًا.
6. عند الانتهاء بنجاح، سيزودك BotFather برسالة تحتوي على "توكن API" الخاص بروبوتك. إنه عبارة عن سلسلة طويلة من الأحرف والأرقام (مثال: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11). احتفظ بهذا التوكن بأمان ولا تشاركه مع أحد.

3. إعداد بيئة العمل

1. أنشئ مجلدًا جديدًا لمشروعك (مثال: telegram_echo_bot).
2. افتح موجه الأوامر (Command Prompt أو Terminal) وانتقل إلى هذا المجلد.
3. قم بتثبيت مكتبة python-telegram-bot باستخدام pip:

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

4. كتابة كود روبوت الصدى

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

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

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

5. شرح الكود

• import: نستورد الوحدات الضرورية من مكتبة telegram وtelegram.ext، بالإضافة إلى logging لتتبع الأحداث.
• TOKEN: المتغير الذي يحمل توكن API الخاص بروبوتك.
• logging.basicConfig: يقوم بإعداد نظام التسجيل لعرض رسائل الأخطاء والمعلومات في الطرفية.
• async def start(...): هذه دالة غير متزامنة (async) يتم استدعاؤها عندما يرسل المستخدم الأمر /start. تقوم بالرد برسالة ترحيب.

* update.effective_user: يوفر معلومات عن المستخدم الذي أرسل الرسالة.
* update.message.reply_html(...): ترسل ردًا على الرسالة الأصلية، وتدعم تنسيق HTML.

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

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

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

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

6. تشغيل الروبوت

بعد حفظ ملف echo_bot.py وتعديل التوكن، يمكنك تشغيل الروبوت من موجه الأوامر:

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

سترى رسائل التسجيل في الطرفية تشير إلى بدء تشغيل الروبوت.

7. اختبار الروبوت

1. افتح تطبيق تلجرام وابحث عن اسم المستخدم الخاص بروبوتك (الذي أنشأته باستخدام BotFather).
2. ابدأ محادثة مع الروبوت بالنقر على "بدء" أو إرسال الأمر /start. يجب أن يرد الروبوت برسالة ترحيب.
3. أرسل أي رسالة نصية إلى الروبوت. يجب أن يرد الروبوت بنفس الرسالة التي أرسلتها.

تهانينا! لقد قمت للتو ببناء وتشغيل أول روبوت تلجرام.

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

الآن بعد أن أتقنت الأساسيات، يمكنك البدء في استكشاف المزيد من الميزات:

• معالجة أنواع أخرى من الرسائل (صور، مستندات، مواقع).
• إضافة أزرار مضمنة (Inline Keyboards) أو أزرار مخصصة (Reply Keyboards).
• التفاعل مع قواعد البيانات لتخزين بيانات المستخدمين.
• استخدام الـ Webhooks بدلاً من الـ polling لنشر الروبوت على الخوادم.

عالم روبوتات تلجرام واسع ومثير، وهذا الروبوت الصدى هو مجرد البداية!