معرفی VideoChatParticipantsInvited در API ربات تلگرام
سلام! امروز می‌خواهیم در مورد یکی از انواع مختلفی که در API ربات تلگرام وجود داره صحبت کنیم. این نوع اسمش VideoChatParticipantsInvited هست و به طور خاص در زمانی استفاده می‌شه که مشارکت‌کنندگان جدیدی به یک گفتگوی ویدیویی دعوت می‌شن. در واقع، وقتی که شما یک چت ویدیویی رو شروع می‌کنید و افراد جدیدی به جمع شما اضافه می‌شن، این نوع از داده ایجاد می‌شه.
چت‌های ویدیویی در تلگرام بسیار جذاب و کاربردی هستند، خصوصاً برای گروه‌های بزرگ یا برای برگزاری جلسات آنلاین. با استفاده از API ربات تلگرام، شما می‌تونید تراکنش‌ها و رویدادهای مختلفی که در این چت‌ها رخ می‌ده رو دنبال کنید. یکی از این رویدادها دعوت از کاربران جدید به چت ویدیویی هست که با VideoChatParticipantsInvited مشخص می‌شه.
اما بیایید نگاهی به چگونگی استفاده از این نوع و داده‌های مربوط به آن بیندازیم. زمانی که کاربری به چت ویدیویی دعوت می‌شه، اطلاعاتی از جمله شناسه کاربری و نام آن در این نوع داده ثبت می‌شه. این داده می‌تونه به طور خودکار به ربات شما ارسال بشه تا شما بتونید واکنش مناسب رو انجام دهید. برای مثال، شما می‌تونید پیامی به گروه ارسال کنید که اعلام کنه چه کسی به چت اضافه شده.
در کل، یادگیری و استفاده از نوع VideoChatParticipantsInvited به شما این امکان رو می‌ده که تجربه کاربری بهتری رو برای اعضای گروه‌های چتی خود فراهم کنید. حالا بگذارید کمی به کد و نحوه پیاده‌سازی این ویژگی در ربات‌های تلگرامی بپردازیم.
const TelegramBot = require('node-telegram-bot-api');
const token = 'YOUR_BOT_TOKEN';
const bot = new TelegramBot(token, { polling: true });
bot.on('video_chat_participants_invited', (msg) => {
const chatId = msg.chat.id;
const invitedUsers = msg.new_chat_participants;
invitedUsers.forEach(user => {
bot.sendMessage(chatId, `کاربری به نام ${user.first_name} به چت ویدیویی اضافه شد!`);
});
});
توضیحات کد
در این قسمت می‌خواهیم خط به خط کد بالا را بررسی کنیم.
const TelegramBot = require('node-telegram-bot-api');این خط کتابخانه ربات تلگرام را در پروژه شما وارد می‌کند تا بتونید از امکانات آن استفاده کنید.
const token = 'YOUR_BOT_TOKEN';اینجا شما توکن ربات خودتون رو وارد می‌کنید که به شما اجازه می‌ده با API تلگرام ارتباط برقرار کنید.
const bot = new TelegramBot(token, { polling: true });در این خط، یک نمونه از ربات ایجاد می‌کنیم و polling را فعال می‌کنیم تا ربات به‌روز‌رسانی‌ها رو دریافت کنه.
bot.on('video_chat_participants_invited', (msg) => {در اینجا ما به رویداد دعوت از کاربران به چت ویدیویی گوش می‌دهیم و وقتی این رویداد رخ می‌دهد، تابعی اجرا می‌شود.
const chatId = msg.chat.id;این خط شناسه چت مربوطه را از پیام دریافتی استخراج می‌کند.
const invitedUsers = msg.new_chat_participants;اینجا ما کاربران جدیدی که به چت دعوت شده‌اند را دریافت می‌کنیم.
invitedUsers.forEach(user => {این خط به ما این امکان را می‌دهد که برای هر کاربر جدیدی که دعوت شده، یک عمل انجام دهیم.
bot.sendMessage(chatId, `کاربری به نام ${user.first_name} به چت ویدیویی اضافه شد!`);در نهایت، پیام مذکور برای چت ارسال می‌شود که نشان می‌دهد چه کسی به چت اضافه شده است.