يعتبر إنشاء روبوت تيليجرام (Telegram Bot) الخاص بك نقطة انطلاق رائعة لتعلم برمجة الروبوتات والتفاعل مع واجهة برمجة تطبيقات تيليجرام (Telegram Bot API). في هذا المقال، سنتعلم كيفية بناء "روبوت صدى" (Echo Bot) بسيط باستخدام لغة بايثون ومكتبة
ما هو الـ Echo Bot ولماذا هو مهم؟
الـ Echo Bot هو أبسط أنواع الروبوتات. عندما ترسل إليه رسالة، يقوم بإرسال نفس الرسالة مرة أخرى. يعتبر هذا الروبوت مثالاً تعليمياً ممتازاً لأنه يوضح المفاهيم الأساسية التالية:
المتطلبات الأساسية
قبل البدء، ستحتاج إلى:
1. بايثون 3: تأكد من تثبيت بايثون 3 على جهازك. يمكنك تنزيله من
2. مكتبة
3. توكن (Token) لروبوت تيليجرام: ستحصل عليه من BotFather.
الخطوة 1: الحصول على توكن الروبوت من BotFather
BotFather هو روبوت رسمي من تيليجرام يسمح لك بإنشاء وإدارة الروبوتات الخاصة بك.
1. افتح تطبيق تيليجرام وابحث عن
2. ابدأ محادثة معه عن طريق إرسال الأمر
3. لإنشاء روبوت جديد، أرسل الأمر
4. سيطلب منك BotFather اسمًا لروبوتك (مثال:
5. ثم سيطلب اسم مستخدم لروبوتك (يجب أن ينتهي بـ
6. بعد ذلك، سيزودك BotFather بـ "توكن API" (API Token). هذا التوكن هو مفتاح الوصول لروبوتك، لذا احتفظ به بأمان ولا تشاركه مع أحد. سيبدو التوكن شيئًا مثل
الخطوة 2: إعداد بيئة العمل وتثبيت المكتبة
1. إنشاء مجلد للمشروع:
2. إنشاء بيئة بايثون افتراضية (موصى به):
3. تفعيل البيئة الافتراضية:
* على أنظمة Unix/macOS:
* على أنظمة Windows:
4. تثبيت مكتبة
الخطوة 3: كتابة كود الروبوت
الآن، قم بإنشاء ملف جديد باسم
تأكد من استبدال
شرح الكود:
*
الخطوة 4: تشغيل الروبوت
بعد حفظ الملف، يمكنك تشغيل الروبوت من الطرفية (تأكد من أن البيئة الافتراضية مفعلة):
سترى بعض رسائل التسجيل في الطرفية. الآن، افتح تيليجرام، وابحث عن اسم المستخدم لروبوتك، وابدأ محادثة معه. أرسل الأمر
الخطوات التالية
لقد قمت الآن بإنشاء روبوت تيليجرام بسيط يعمل. يمكنك التوسع في هذا الأساس عن طريق:
هذا مجرد بداية لعالم واسع من إمكانيات روبوتات تيليجرام!
python-telegram-bot الشهيرة. يقوم هذا الروبوت ببساطة بتكرار أي رسالة نصية ترسلها إليه، وهو مثال ممتاز لفهم الأساسيات.ما هو الـ Echo Bot ولماذا هو مهم؟
الـ Echo Bot هو أبسط أنواع الروبوتات. عندما ترسل إليه رسالة، يقوم بإرسال نفس الرسالة مرة أخرى. يعتبر هذا الروبوت مثالاً تعليمياً ممتازاً لأنه يوضح المفاهيم الأساسية التالية:
- الحصول على تحديثات: كيف يتلقى الروبوت الرسائل والأوامر من المستخدمين.
- التعامل مع الرسائل: كيفية معالجة أنواع مختلفة من الرسائل (نص، أوامر).
- إرسال الردود: كيفية إرسال رسائل نصية مرة أخرى إلى المستخدم.
المتطلبات الأساسية
قبل البدء، ستحتاج إلى:
1. بايثون 3: تأكد من تثبيت بايثون 3 على جهازك. يمكنك تنزيله من
برای دیدن لینک ها باید ثبت نام کنید
.2. مكتبة
python-telegram-bot: هذه المكتبة تسهل التفاعل مع Telegram Bot API.3. توكن (Token) لروبوت تيليجرام: ستحصل عليه من BotFather.
الخطوة 1: الحصول على توكن الروبوت من BotFather
BotFather هو روبوت رسمي من تيليجرام يسمح لك بإنشاء وإدارة الروبوتات الخاصة بك.
1. افتح تطبيق تيليجرام وابحث عن
@BotFather.2. ابدأ محادثة معه عن طريق إرسال الأمر
/start.3. لإنشاء روبوت جديد، أرسل الأمر
/newbot.4. سيطلب منك BotFather اسمًا لروبوتك (مثال:
My Echo Bot).5. ثم سيطلب اسم مستخدم لروبوتك (يجب أن ينتهي بـ
bot، مثال: MyEchoTest_bot).6. بعد ذلك، سيزودك BotFather بـ "توكن API" (API Token). هذا التوكن هو مفتاح الوصول لروبوتك، لذا احتفظ به بأمان ولا تشاركه مع أحد. سيبدو التوكن شيئًا مثل
123456789:ABCDEF-1234567890abcdef1234567890.الخطوة 2: إعداد بيئة العمل وتثبيت المكتبة
1. إنشاء مجلد للمشروع:
کد:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
کد:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
* على أنظمة Unix/macOS:
کد:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
کد:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
python-telegram-bot:
کد:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
الخطوة 3: كتابة كود الروبوت
الآن، قم بإنشاء ملف جديد باسم
echo_bot.py في مجلد مشروعك وأضف الكود التالي:
Python:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
تأكد من استبدال
YOUR_BOT_TOKEN_HERE بالتوكن الفعلي لروبوتك!شرح الكود:
Updater: هذا الكائن هو المسؤول عن جلب التحديثات الجديدة من خوادم تيليجرام.Dispatcher: هذا الكائن يأخذ التحديثات منUpdaterويقوم بتوجيهها إلى المعالجات (Handlers) المناسبة.Handlers: هي وظائف محددة تستجيب لأنواع معينة من الرسائل أو الأحداث.
CommandHandler: يستمع لأوامر معينة (مثل /start). عندما يتلقى الروبوت الأمر /start، فإنه يستدعي الدالة start التي قمنا بتعريفها.*
MessageHandler: يستمع لأنواع معينة من الرسائل. في حالتنا، نستخدم filters.TEXT & ~filters.COMMAND لكي يستمع فقط للرسائل النصية التي ليست أوامر. عندما يتلقى الروبوت رسالة نصية، فإنه يستدعي الدالة echo.update.message.reply_text(): هذه الدالة تستخدم للرد على الرسالة الواردة بنفس النص أو بنص جديد.updater.start_polling(): يبدأ الروبوت في "الاستقصاء" (Polling)، أي أنه يتصل بخوادم تيليجرام بشكل دوري للتحقق من وجود تحديثات جديدة.updater.idle(): يبقي الروبوت يعمل حتى يتم إيقافه يدوياً (مثلاً بالضغط علىCtrl+Cفي الطرفية).
الخطوة 4: تشغيل الروبوت
بعد حفظ الملف، يمكنك تشغيل الروبوت من الطرفية (تأكد من أن البيئة الافتراضية مفعلة):
Bash:
محتوای بلوک کدها در دسترس شما نیست. برای مشاهده بلوک کدها، وارد انجمن شوید یاثبت نام کنید
سترى بعض رسائل التسجيل في الطرفية. الآن، افتح تيليجرام، وابحث عن اسم المستخدم لروبوتك، وابدأ محادثة معه. أرسل الأمر
/start، ثم أرسل أي رسالة نصية. يجب أن يقوم الروبوت بتكرار رسالتك!الخطوات التالية
لقد قمت الآن بإنشاء روبوت تيليجرام بسيط يعمل. يمكنك التوسع في هذا الأساس عن طريق:
- التعامل مع أنواع رسائل أخرى (صور، مستندات، صوت).
- إضافة المزيد من الأوامر المخصصة.
- تخزين بيانات المستخدمين.
- ربط الروبوت بخدمات خارجية أو قواعد بيانات.
هذا مجرد بداية لعالم واسع من إمكانيات روبوتات تيليجرام!