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

[Ali]

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

1. إنشاء الروبوت باستخدام BotFather

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

1. افتح تطبيق تيليجرام وابحث عن @BotFather.
2. ابدأ محادثة معه باستخدام الأمر /start.
3. أرسل الأمر /newbot.
4. سيطلب منك BotFather اسم الروبوت (الاسم الذي سيظهر للمستخدمين، مثل "روبوت المساعدة"). اكتب الاسم وأرسله.
5. بعد ذلك، سيطلب منك اسم مستخدم للروبوت (يجب أن ينتهي بـ "bot"، مثل "MyHelpfulBot"). اختر اسم مستخدم فريداً وأرسله.
6. إذا كان اسم المستخدم متاحاً، سيهنئك BotFather ويعطيك "HTTP API Token" الخاص بروبوتك. هذا التوكن هو المفتاح لتوصيل الكود الخاص بك بروبوت تيليجرام. احتفظ بهذا التوكن سراً ولا تشاركه مع أحد.

2. إعداد بيئة التطوير (بايثون)

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

1. تثبيت بايثون: تأكد أن لديك بايثون مثبتاً على جهازك (الإصدار 3.6 أو أحدث). يمكنك تنزيله من

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

.
2. تثبيت مكتبة python-telegram-bot: افتح سطر الأوامر (Command Prompt أو Terminal) ونفذ الأمر التالي:

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

3. كتابة أول كود للروبوت

الآن، لنكتب كود بايثون بسيطاً يستجيب لأمر /start ويعكس أي رسالة نصية يرسلها المستخدم.

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

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

شرح الكود:

• TOKEN: هذا هو المكان الذي تضع فيه التوكن الخاص بروبوتك.
• Updater: هو الكائن المسؤول عن تلقي التحديثات من تيليجرام.
• Dispatcher: هو الكائن الذي يوجه التحديثات إلى المعالجات الصحيحة.
• start(update, context): هذه الدالة تُستدعى عندما يرسل المستخدم الأمر /start. update.message.reply_text() ترسل رسالة إلى المستخدم.
• echo(update, context): هذه الدالة تُستدعى عندما يرسل المستخدم أي رسالة نصية ليست أمراً. تقوم بإعادة إرسال نفس النص.
• CommandHandler("start", start): يسجل start كدالة لمعالجة الأمر /start.
• MessageHandler(Filters.text & ~Filters.command, echo): يسجل echo كدالة لمعالجة أي رسالة نصية لا تبدأ بعلامة / (أي ليست أمراً).
• updater.start_polling(): يبدأ الروبوت في البحث عن تحديثات جديدة من تيليجرام بشكل مستمر.
• updater.idle(): يبقي الروبوت قيد التشغيل حتى يتم مقاطعته يدوياً.

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

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

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

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

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