انواع KeyboardButtonPollType در API ربات تلگرام

مقدمه‌ای درباره KeyboardButtonPollType در API ربات تلگرام

در دنیای ربات‌های تلگرام، قابلیت‌ها و امکانات بسیار زیادی وجود دارد که به ما کمک می‌کند تا تجربه کاربران را بهبود ببخشیم. یکی از این قابلیت‌ها، استفاده از دکمه‌های مخصوصی است که می‌توانند تعاملات جذابی ایجاد کنند. یکی از این دکمه‌ها، دکمه‌ای است که به کاربران امکان می‌دهد تا در نظرسنجی‌ها شرکت کنند. نوع این دکمه‌ها، KeyboardButtonPollType نامیده می‌شود.

استفاده از KeyboardButtonPollType به ما این امکان را می‌دهد که پاسخ‌های سریع و موثر از کاربران بگیریم. به‌خصوص در زمینه‌هایی مانند نظرخواهی، رأی‌گیری یا هر حوزه دیگری که نیاز به جمع‌آوری اطلاعات از کاربران داریم، این نوع دکمه‌ها بسیار کارآمد هستند. با استفاده از این دکمه‌ها، خروجی‌های نظرسنجی به شکل بسیار منظم و زیبا نمایش داده می‌شوند.

اما KeyboardButtonPollType دقیقاً چه نوعی از داده‌ها را می‌پذیرد و چه تنظیماتی دارد؟ در حقیقت، این نوع دکمه می‌تواند نوع نظرسنجی (نظرسنجی عادی یا نظرسنجی بدون نتیجه) را مشخص کند که این موضوع می‌تواند به ما کمک کند تا نظرسنجی‌های ویژه‌ای ترتیب دهیم. به عنوان مثال، در یک نظرخواهی درباره یک موضوع خاص، می‌توانیم نوع نظرسنجی را مشخص کنیم که آیا می‌خواهیم نتایج آن زودتر اعلام شود یا خیر.

در ادامه، ما به بررسی ویژگی‌های کلیدی KeyboardButtonPollType خواهیم پرداخت، و کد نمونه‌ای ارائه خواهیم کرد که چگونه می‌توانیم از این قابلیت در ربات تلگرام خود استفاده کنیم. این اطلاعات می‌تواند به شما در طراحی رباتی منحصر به فرد و کارآمد کمک کند.

کد نمونه برای استفاده از KeyboardButtonPollType

const TelegramBot = require('node-telegram-bot-api');

const bot = new TelegramBot(YOUR_TOKEN, { polling: true });

bot.onText(//poll/, (msg) => {
    const chatId = msg.chat.id;
    const options = {
        reply_markup: {
            keyboard: [[{
                text: 'چگونه احساس می‌کنید؟',
                request_poll: {
                    type: 'regular'
                }
            }]]
        }
    };
    bot.sendMessage(chatId, 'سوال خود را بپرسید:', options);
});

توضیح خط به خط کد

const TelegramBot = require('node-telegram-bot-api');
ما ابتدا کتابخانه node-telegram-bot-api را وارد می‌کنیم تا بتوانیم از آن برای ایجاد ربات استفاده کنیم.

const bot = new TelegramBot(YOUR_TOKEN, { polling: true });
سپس یک نمونه از ربات ایجاد کرده و توکن خود را به آن می‌دهیم. با تنظیم polling: true، ربات ما آماده پاسخ‌گویی به پیام‌ها خواهد بود.

bot.onText(/\/poll/, (msg) => {
با استفاده از onText، ما به دستور /poll گوش می‌دهیم و زمانی که کاربر این دستور را ارسال کند، تابعی اجرا خواهد شد.

const chatId = msg.chat.id;
شناسه چت کاربر را دریافت می‌کنیم تا بتوانیم پیام را به او ارسال کنیم.

const options = {...}
در اینجا ما گزینه‌های دکمه را مشخص می‌کنیم، به‌طوری که دکمه‌ای با متن مشخص، نوع نظرسنجی (مثل 'regular') درخواست شود.

bot.sendMessage(chatId, 'سوال خود را بپرسید:', options);
در نهایت، با استفاده از sendMessage، پیام و دکمه نظرسنجی را به کاربر ارسال می‌کنیم.