إنشاء أول روبوت تيليجرام لك: دليل المبتدئين

[Ali]

تعد روبوتات تيليجرام أدوات قوية ومتعددة الاستخدامات، تمكنك من أتمتة المهام، تقديم المعلومات، أو حتى بناء ألعاب وتطبيقات تفاعلية مباشرة داخل تطبيق تيليجرام. سواء كنت مطوراً متمرساً أو بدأت للتو في عالم البرمجة، فإن إنشاء روبوت تيليجرام يمكن أن يكون تجربة ممتعة ومجزية.

في هذا الدليل، سنتعلم كيفية إنشاء روبوت تيليجرام بسيط جداً باستخدام لغة بايثون، والذي سيرد على رسالة البدء ويكرر أي نص ترسله إليه.

الخطوة 1: إنشاء الروبوت الخاص بك باستخدام BotFather

قبل أن نكتب أي كود، نحتاج إلى تسجيل الروبوت الخاص بنا والحصول على "رمز API" (HTTP API Token) الخاص به. يتم ذلك عبر روبوت خاص في تيليجرام يُدعى BotFather.

1. ابحث عن BotFather: افتح تطبيق تيليجرام وابحث عن @BotFather. تأكد من أنه الروبوت الرسمي (يحتوي على علامة التحقق الزرقاء).
2. بدء محادثة: ابدأ محادثة معه واكتب الأمر /start.
3. إنشاء روبوت جديد: اكتب الأمر /newbot.
4. اختيار اسم: سيطلب منك BotFather اختيار اسم لروبوتك. هذا هو الاسم الذي سيراه المستخدمون (مثال: MyFirstAwesomeBot).
5. اختيار اسم مستخدم: بعد ذلك، سيطلب منك اختيار اسم مستخدم لروبوتك. يجب أن يكون فريداً وينتهي بكلمة bot (مثال: myfirstawesome_bot).
6. الحصول على رمز API: بعد اختيار اسم المستخدم بنجاح، سيزودك BotFather برسالة تحتوي على "رمز API" الخاص بروبوتك. هذا الرمز هو مفتاح الوصول لروبوتك، لذا احتفظ به في مكان آمن ولا تشاركه مع أحد. سيبدو الرمز شيئاً مثل 123456789:ABCDEF1234567890abcdef1234567890.

الخطوة 2: تهيئة بيئة التطوير (بايثون)

سنستخدم لغة بايثون ومكتبة python-telegram-bot لإنشاء الروبوت.

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

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

ملاحظة: --pre ضروري لتثبيت أحدث الإصدارات التجريبية التي تدعم الميزات الجديدة.

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

الآن، لنكتب الكود الذي يجعل روبوتنا يعمل. أنشئ ملفاً جديداً باسم my_first_bot.py (أو أي اسم تفضله) والصق فيه الكود التالي:

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

شرح الكود:

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

* update.message.reply_text(): تستخدم لإرسال رسالة نصية كـرد للمستخدم.

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

* update.message.text: يحتوي على نص الرسالة التي أرسلها المستخدم.

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

* Updater: هو المسؤول عن جلب التحديثات الجديدة (الرسائل، الأوامر، إلخ) من خوادم تيليجرام.
* Dispatcher: هو الذي يوزع هذه التحديثات على "المعالجات" (Handlers) المناسبة.
* CommandHandler("start", start): ينشئ معالجاً يستمع للأمر /start، وعند تلقيه، يقوم بتشغيل الدالة start.
* MessageHandler(Filters.text & ~Filters.command, echo): ينشئ معالجاً يستمع لأي رسالة نصية (Filters.text) ولكن يستثني الأوامر (~Filters.command). عندما يتلقى رسالة من هذا النوع، يشغل الدالة echo.
* updater.start_polling(): يبدأ الروبوت في الاستماع للتحديثات الجديدة من تيليجرام.
* updater.idle(): يحافظ على تشغيل الروبوت في الخلفية حتى يتم إيقافه يدوياً.

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

بعد حفظ الكود وتعديل TOKEN برمز API الخاص بك، افتح سطر الأوامر في نفس المجلد الذي حفظت فيه الملف my_first_bot.py وقم بتشغيله:

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

سترى رسالة "الروبوت يعمل..." في سطر الأوامر. الآن، افتح تيليجرام، ابحث عن اسم المستخدم الخاص بروبوتك، وابدأ محادثة معه!

• أرسل /start وسترى الروبوت يرد برسالة الترحيب.
• أرسل أي نص آخر، وسيقوم الروبوت بتكرار ما كتبته.

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

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

• إضافة المزيد من الأوامر المخصصة.
• التعامل مع أنواع مختلفة من الرسائل (صور، مستندات، مواقع).
• استخدام لوحات المفاتيح المخصصة (ReplyKeyboards) أو لوحات المفاتيح المضمنة (InlineKeyboards) لجعل التفاعل أكثر ثراءً.
• دمج الروبوت مع واجهات برمجة تطبيقات (APIs) خارجية لجلب البيانات أو إرسال الإشعارات.
• نشر الروبوت على خادم (مثل Heroku أو PythonAnywhere) ليعمل على مدار الساعة.

استكشف وثائق مكتبة python-telegram-bot لتعلم المزيد حول إمكانياتها الواسعة.