در این مقاله آموزشی، قرار است با نحوه ساخت ربات تلگرام پرداخته و آن را با Node.js برنامه نویسی کنیم. در پایان این مقاله آموزشی، شما با نحوه برنامه نویسی ربات تلگرام با Node.js به صورت کاملاً عملی آشنا خواهید شد. این ربات می‌تواند به دستورات کاربران پاسخ دهد و ارتباط برقرار کند.

گام 1: راه اندازی یک پروژه Node.js جدید 📁

برای پیش بردن گام اول لازم است مراحل زیر را به ترتیب انجام دهید:

1. یک دایرکتوری جدید برای پروژه خود ایجاد کنید. می‌توانید از هر نامی که مد نظر دارید استفاده کنید (بهتر است نامی مرتبط با پروژه داشته باشد).

2. یک ترمینال (Terminal یا cmd) باز کنید و به دایرکتوری پروژه ای که ایجاد کردید، بروید.

C:\Users\MKV>cd /path/to/your/project


3. دستور npm init را وارد کنید تا یک پروژه Node.js جدید را پیکربندی کنید. از شما خواسته می‌شود که اطلاعاتی درباره پروژه خود ارائه دهید، مانند نام، نسخه و نقطه ورود. شما می‌توانید به سادگی با فشار دادن Enter، مقادیر پیش فرض برای بیشتر دستورات را بپذیرید.

4. هنگامی که پیکربندی انجام شد، شما یک فایل به نام package.json در دایرکتوری پروژه خود خواهید داشت که حاوی تنظیمات و پیش‌نیاز های پروژه می‌باشد.

گام 2: ایجاد ربات در تلگرام و دریافت توکن 🛠

پس از انجام مراحل گام اول، در گام دوم نوبت یه ایجاد ربات در تلگرام و دریافت توکن می‌رسد که لازم مراحل زیر را پیش ببرید:

1. وارد تلگرام شوید و BotFather را جستجو کنید.

2. بر روی دکمه شروع (/Start)  کلیک کنید و طبق دستور العمل، یک ربات جدید بسازید.

3 – هنگامی که ربات شما ایجاد شد، BotFather به شما یک توکن API می‌دهد. این توکن به عنوان مکانیسم احراز هویت برای ربات شما عمل می‌کند. مطمئن شوید که آن را امن نگه می‌دارید زیرا هرکس به آن توکن دسترسی پیدا کند می‌تواند اختیار ربات را در دست بگیرد.

گام 3: بیایید کد بزنیم! 💻

در این بخش برای برنامه نویسی ربات تلگرام آماده می‌شویم:

1. یک فایل جاوا اسکریپت جدید در دایرکتوری پروژه خود ایجاد کنید. اسم این فایل می‌تواند bot.js باشد.

2. فایل bot.js را در یک کد ادیتور (برای مثال vs code) باز کنید.

3. با وارد کردن کتابخانه node-telegram-bot-api در بالای فایل، کد نویسی را شروع کنید:

//وارد کردن کتابخانه
const TelegramBot = require('node-telegram-bot-api');

4. ربات را با استفاده از توکن دریافتی و قابلیت polling به حالت شنود در بیاورید. این ویژگی به ربات شما این امکان می‌دهد تا برای پیام های جدید گوش به زنگ (حالت listen) باشد:

const token = 'YOUR_TELEGRAM_BOT_TOKEN'; // با توکن خودتون جایگزین کنید
const bot = new TelegramBot(token, { polling: true });

5. یک رویداد گوش به زنگ (Event Listener) را به کد اضافه کنید. به این ترتیب هر زمان که یک کاربر پیامی به ربات شما ارسال می‌کند، می‌توان به آن پاسخ داد:

bot.on('message', (msg) => {
const chatId = msg.chat.id;
const messageText = msg.text;
// دستوراتی که مد نظر داریم تا به عنوان پاسخ ارسال شود
});

6. هرآنچه که می‌خواهید بعد از دریافت پیام اتفاق بی‌افتد را برنامه نویسی کنید. برای مثال، اگر یک کاربر دستور را ارسال می‌کند (در این صورت ms.text برابر تهی خواهد بود)، می‌توانید با یک پیام خوش آمدگویی پاسخ دهید:

bot.on('message', (msg) => {
const chatId = msg.chat.id;
const messageText = msg.text;
if (messageText === '') {
bot.sendMessage(chatId, 'Welcome to the bot!');
}
});

با دنبال کردن مراحل قبلی، فایل bot.js شما به این شکل خواهد بود:

گام 4: اجرای ربات 🤖

خسته نباشید، به گام نهایی اجرای ربات رسیدم، در این گام با اجرای 4 مرحله زیر برای اجرای ربات آماده خواهید شد:

1. یک ترمینال (Terminal) یا کامند-لاین (cmd) باز کنید و به دایرکتوری پروژه خود بروید.

C:\Users\MKV>cd /path/to/your/project/

2. دستور node bot.js را اجرا کنید تا ربات شما اجرا شود. شما باید یک پیام ببینید که نشان می‌دهد ربات در حال اجرا و منتظر پیام های ورودی است. (در حال حاضر، بدون فراهم بودن اینترنت آزاد، روی سیستم شخصی قادر به ادامه کار نبودم).

3. به تلگرام بروید و ربات خود را با نام کاربری که برایش در مراحل اول انتخاب کردید پیدا کنید.

4. یک پیام به ربات خود ارسال کنید و پاسخ آن را مشاهده کنید. اگر شما دستوری را ارسال کرده باشید، ربات باید یک پیام خوش آمدگویی برای شما ارسال کند.

دست خوش! 🥳

تبریک می‌گویم! شما با موفقیت یک ربات تلگرامی ساده با استفاده از Node.js برنامه نویسی کردید. از این به بعد، می‌توانید با تمرین و آموزشاتی که در لیموناد وجود دارند، ربات های پیشرفته تری بسازید.