بوت تيليجرام بلغة TypeScript: كتابة مساعد ذكي من الصفر

مقدمة: لماذا TypeScript وليس Python؟

مرحباً أيها المطور! إذا كنت تقرأ هذا على PythonLib، فمن المحتمل أنك مندهش: "لماذا مقال عن TypeScript على موقع مخصص لـ Python؟". الإجابة بسيطة: عالم تكنولوجيا المعلومات لا يعترف بالحدود، والمطور الجيد يعرف كيف يخرج عن إطار لغة واحدة. TypeScript ليست مجرد "إضافة فوق JavaScript"، بل هي أداة قوية لإنشاء تطبيقات موثوقة وقابلة للتوسع ويمكن التنبؤ بها. وبوتات تيليجرام هي البيئة المثالية لتجربتها عملياً.

تخيل: أنت تكتب الكود، وبيئة التطوير المتكاملة (IDE) تبرز الأخطاء مسبقاً، وأنواع البيانات تمنع الانهيار في وقت التشغيل، والإكمال التلقائي يعمل كالساعة السويسرية. هذا ليس سحراً، بل هو TypeScript. في هذا الدليل، سننشئ بوت تيليجرام كاملاً بلغة TypeScript من الصفر: من التسجيل في BotFather إلى النشر. ستتعلم كيفية إعداد المشروع، ومعالجة الأوامر، وإرسال الرسائل، والعمل مع واجهات برمجة التطبيقات الخارجية (API).

هل أنت مستعد؟ إذاً لننطلق!

لماذا تختار TypeScript لبوت تيليجرام

قبل الغوص في الكود، دعنا نفهم لماذا يجب كتابة البوت بلغة TypeScript بدلاً من Python، التي تبدو وكأنها اللغة "الأم" لمثل هذه المهام.

\n
• الكتابة (Typing) صديقك. عندما يحتوي المشروع على 10+ أوامر و20 معالجاً، ستنقذك TypeScript من الأخطاء السخيفة مثل تمرير سلسلة نصية بدلاً من رقم.
\n
• بناء جملة حديث. Async/await، التفكيك (Destructuring)، الوحدات (Modules) - كل هذا يجعل الكود أنظف وأكثر قابلية للقراءة.
\n
• النظام البيئي لـ Node.js. عدد هائل من المكتبات، بما في ذلك Telegraf (أفضل إطار عمل للبوتات).
\n
• الأداء. Node.js هي منصة موجهة بالأحداث، مثالية لبوتات الدردشة ذات الأحمال العالية.
\n

بالمناسبة، بخصوص Telegraf: هو إطار عمل يعطي الأولوية لـ TypeScript، مما يجعل العمل مع Telegram Bot API في غاية السهولة. سنستخدمه بالتحديد.

التحضير: ما يجب تثبيته

للبدء، ستحتاج إلى:

# تأكد من تثبيت Node.js (الإصدار 18+) و npm\nnode -v\nnpm -v\n\n# أنشئ مجلد المشروع\nmkdir telegram-bot-ts\ncd telegram-bot-ts\n\n# قم بتهيئة المشروع\nnpm init -y

الآن، لنقم بتثبيت التبعيات:

npm install telegraf dotenv\nnpm install -D typescript @types/node ts-node nodemon

دعنا نفهم ما قمنا بتثبيته:

\n
• telegraf - الإطار الرئيسي للبوت.
\n
• dotenv - لتخزين التوكن في ملف .env (الأمان قبل كل شيء).
\n
• typescript, @types/node, ts-node - لتجميع وتشغيل TS.
\n
• nodemon - لإعادة التشغيل التلقائي عند إجراء تغييرات.
\n

أنشئ ملف tsconfig.json:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "strict": true,\n    "esModuleInterop": true,\n    "skipLibCheck": true,\n    "forceConsistentCasingInFileNames": true,\n    "outDir": "./dist"\n  },\n  "include": ["src/**/*"],\n  "exclude": ["node_modules"]\n}

وملف .env (لا تنس إضافته إلى .gitignore!):

BOT_TOKEN=توكن_خاص_بك_من_BotFather

تسجيل البوت: التعرف على BotFather

هذه هي المرحلة الأسهل. افتح تيليجرام، ابحث عن @BotFather وأرسل الأمر /newbot. اتبع التعليمات:

\n
1. أدخل اسم البوت (مثلاً، "مساعدي الذكي").
\n
2. أدخل اسم المستخدم (يجب أن ينتهي بـ bot، مثلاً my_smart_helper_bot).
\n
3. انسخ التوكن الذي حصلت عليه وألصقه في ملف .env.
\n

تم! الآن لديك مفتاح واجهة برمجة تطبيقات تيليجرام.

هيكل المشروع والتشغيل الأول

أنشئ مجلد src وداخله ملف index.ts:

// src/index.ts\nimport { Telegraf } from 'telegraf';\nimport { mess