إنشاء بوت تيليغرام بلغة JavaScript: دليل للمبتدئين

تعلم Python بسهولة دون إرهاق نظري. حل مهام عملية مع التحقق التلقائي واكتب الكود مباشرة في المتصفح.

بوت تيليغرام بلغة JavaScript: من أين تبدأ وكيف لا تتوه

\n\n

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

\n\n

لماذا JavaScript بالتحديد؟ لأنها لغة متعددة الاستخدامات تعمل في كل مكان: على الخوادم، في المتصفح، وحتى على Raspberry Pi. ومع مكتبة Telegraf، يصبح إنشاء بوت تيليغرام متعة حقيقية. هل أنت مستعد؟ هيا بنا!

\n\n

ما الذي سنحتاجه لإنشاء بوت تيليغرام بلغة JS

\n\n

قبل كتابة الكود، دعنا نجهز الأدوات. ستحتاج إلى:

\n\n

Node.js (الإصدار 14 أو أحدث) — بيئة تشغيل JavaScript على الخادم.
محرر نصوص — Visual Studio Code، Sublime Text أو أي محرر آخر.
حساب في تيليغرام — لا بد منه.
الطرفية (Terminal) — سطر الأوامر لتثبيت الحزم.

\n\n

إذا لم يكن Node.js مثبتًا بعد — قم بتنزيله من الموقع الرسمي. عملية التثبيت بسيطة: فقط اضغط على "التالي".

\n\n

تسجيل البوت والحصول على التوكن

\n\n

الخطوة الأولى لإنشاء بوت تيليغرام بلغة JavaScript هي الحصول على API token. وهو مفتاح سري يربط الكود الخاص بك مع تيليغرام.

\n\n

افتح تيليغرام وابحث عن البوت @BotFather.
أرسل الأمر /newbot.
اختر اسمًا للبوت (مثلًا، MyFirstTestBot).
اختر اسم مستخدم فريدًا ينتهي بـ bot (مثلًا، my_first_test_2025_bot).
احفظ التوكن الذي حصلت عليه — سيبدو هكذا تقريبًا: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz.

\n\n

هام: التوكن هو كلمة مرورك. لا تظهره لأي شخص ولا ترفعه على GitHub بشكل مكشوف.

\n\n

تثبيت المكتبات وإعداد المشروع

\n\n

الآن ننتقل إلى الكود. أنشئ مجلدًا للمشروع، افتحه في الطرفية ونفذ:

\n\n

npm init -y

\n\n

هذا الأمر سينشئ ملف package.json. الآن لنثبت المكتبة الرئيسية — Telegraf:

\n\n

npm install telegraf

\n\n

Telegraf هي مكتبة قوية وبسيطة للعمل مع Telegram Bot API بلغة JavaScript. تدعم الأوامر، لوحات المفاتيح، الوضع المضمن (inline mode) وأكثر من ذلك بكثير.

\n\n

لتسهيل الأمور، قم أيضًا بتثبيت dotenv — سيساعدك في تخزين التوكن في ملف منفصل:

\n\n

npm install dotenv

\n\n

أنشئ ملف .env في جذر المشروع واكتب فيه التوكن الخاص بك:

\n\n

BOT_TOKEN=توكنك_هنا

\n\n

لا تنس إضافة .env إلى ملف .gitignore إذا كنت تخطط لنشر الكود.

\n\n

كتابة أول بوت تيليغرام بلغة JavaScript

\n\n

أنشئ ملف bot.js وافتحه في المحرر. لنبدأ بأبسط شيء — بوت يرد على الأمر /start.

\n\n

require('dotenv').config();\nconst { Telegraf } = require('telegraf');\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\n\nbot.start((ctx) => {\n    ctx.reply('مرحبًا! أنا أول بوت لك بلغة JavaScript!');\n});\n\nbot.launch();\nconsole.log('تم تشغيل البوت!');

\n\n

قم بتشغيل البوت بالأمر:

\n\n

node bot.js

\n\n

افتح بوتك في تيليغرام واضغط على Start. إذا تم كل شيء بشكل صحيح، سيرد عليك البوت بتحية. تهانينا — لقد أنشأت للتو بوت تيليغرام يعمل بلغة JavaScript!