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

[Ali]

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

1. الخطوة الأولى: إنشاء الروبوت عبر BotFather

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

1. افتح تطبيق تلجرام وابحث عن المستخدم @BotFather. هذا هو الروبوت الرسمي لإنشاء وإدارة الروبوتات.
2. ابدأ محادثة معه وأرسل الأمر /newbot.
3. سيطلب منك BotFather اختيار اسم لروبوتك (مثال: "My Awesome Bot").
4. ثم سيطلب منك اختيار اسم مستخدم لروبوتك. يجب أن يكون فريدًا وينتهي بـ "bot" (مثال: "MyAwesome_bot").
5. بعد اختيار الأسماء بنجاح، سيزودك BotFather برسالة تحتوي على "رمز API" الخاص بروبوتك. احتفظ بهذا الرمز سريًا ولا تشاركه مع أحد، فهو يسمح بالتحكم الكامل في روبوتك.

مثال على رسالة BotFather:

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

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

نحتاج إلى بايثون ومكتبة python-telegram-bot لتطوير الروبوت.

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

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

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

الآن لنكتب الكود الذي يجعل روبوتنا يستجيب للأوامر والرسائل.

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

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

شرح الكود:

• Updater: هو المسؤول عن جلب التحديثات من تلجرام (مثل الرسائل الجديدة، الأوامر، إلخ).
• Dispatcher: هو الذي يوزع التحديثات إلى المعالجات المناسبة.
• CommandHandler: يتعامل مع الأوامر التي تبدأ بـ / (مثل /start).
• MessageHandler: يتعامل مع أنواع معينة من الرسائل (مثل النصوص، الصور، المستندات).

* filters.text: يحدد أننا نريد التعامل مع الرسائل النصية.
* ~filters.command: يستبعد الرسائل التي هي أوامر.

• start(update, context): هذه الدالة تُستدعى عندما يرسل المستخدم الأمر /start. تقوم بالرد برسالة ترحيب.
• echo(update, context): هذه الدالة تُستدعى عندما يرسل المستخدم أي رسالة نصية ليست أمرًا. تقوم بإعادة إرسال نفس الرسالة.
• error(update, context): دالة بسيطة لتسجيل أي أخطاء تحدث أثناء تشغيل الروبوت.
• updater.start_polling(): تبدأ عملية الاستطلاع (Long Polling)، حيث يقوم الروبوت بالتحقق من وجود تحديثات جديدة بشكل دوري.
• updater.idle(): تحافظ على تشغيل الروبوت حتى يتم إيقافه يدويًا (مثل الضغط على Ctrl+C).

لا تنسَ استبدال YOUR_BOT_TOKEN برمز API الخاص بك!

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

بعد حفظ الملف، افتح سطر الأوامر أو Terminal في نفس المجلد الذي حفظت فيه الملف my_first_bot.py، ثم نفذ الأمر التالي:

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

إذا سار كل شيء على ما يرام، سترى رسائل تسجيل في سطر الأوامر تشير إلى أن الروبوت قد بدأ.

الآن، افتح تطبيق تلجرام، وابحث عن اسم المستخدم الخاص بروبوتك (الذي اخترته في الخطوة 1)، وابدأ محادثة معه:

1. أرسل الأمر /start. يجب أن يرد الروبوت برسالة ترحيب.
2. أرسل أي رسالة نصية أخرى (مثل "مرحباً"). يجب أن يرد الروبوت بنفس الرسالة.

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

نصائح إضافية

• Deployment (النشر): لتشغيل الروبوت على مدار الساعة، ستحتاج إلى نشره على خادم (مثل Heroku, PythonAnywhere, AWS). في بيئات الإنتاج، غالبًا ما يُفضل استخدام Webhooks بدلاً من Long Polling لتقليل استهلاك الموارد.
• توسيع الوظائف: يمكنك إضافة المزيد من CommandHandler و MessageHandler للتعامل مع أوامر ورسائل مختلفة، مثل الصور، المستندات، أو حتى دمج قواعد بيانات.
• الأمان: لا تشارك رمز API الخاص بروبوتك أبدًا.
• الوثائق: مكتبة python-telegram-bot لديها وثائق ممتازة يمكنك الرجوع إليها لتعلم المزيد عن إمكانياتها المتقدمة.

هذه مجرد بداية، عالم تطوير روبوتات تلجرام واسع ومليء بالإمكانيات!