KeyboardButton
نوع دادهاین شیء یک دکمه از کیبورد پاسخ را نشان می‌دهد. برای مشخص‌کردن نوع دکمه حداکثر یکی از فیلدهایی که text، icon_custom_emoji_id و style نیستند باید استفاده شود. برای دکمه‌های متنی ساده می‌توان به‌جای این شیء، یک String برای متن دکمه داد.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| text | String | متن دکمه. اگر هیچ‌یک از فیلدهای غیر از text، icon_custom_emoji_id و style استفاده نشود، با زدن دکمه این متن به‌عنوان پیام فرستاده می‌شود. |
| icon_custom_emoji_id | String | اختیاری. شناسهٔ یکتای ایموجی سفارشی که پیش از متن دکمه نمایش داده می‌شود. فقط ربات‌هایی که نام‌کاربری اضافه در Fragment خریده‌اند، یا در پیام‌هایی که ربات مستقیماً به گفتگوهای خصوصی، گروه و ابرگروه می‌فرستد و مالک ربات اشتراک تلگرام پریمیوم دارد، می‌توانند از آن استفاده کنند. |
| style | String | اختیاری. سبک دکمه. باید یکی از «danger» (قرمز)، «success» (سبز) یا «primary» (آبی) باشد. اگر ذکر نشود، سبک پیش‌فرض اپ استفاده می‌شود. |
| request_users | KeyboardButtonRequestUsers | اختیاری. اگر مشخص شود، با زدن دکمه فهرستی از کاربران مناسب باز می‌شود. شناسهٔ کاربران انتخاب‌شده در یک پیام سرویسی «users_shared» برای ربات فرستاده می‌شود. فقط در گفتگوهای خصوصی در دسترس است. |
| request_chat | KeyboardButtonRequestChat | اختیاری. اگر مشخص شود، با زدن دکمه فهرستی از گفتگوهای مناسب باز می‌شود. با ضربه روی یک گفتگو، شناسهٔ آن در یک پیام سرویسی «chat_shared» برای ربات فرستاده می‌شود. فقط در گفتگوهای خصوصی در دسترس است. |
| request_managed_bot | KeyboardButtonRequestManagedBot | اختیاری. اگر مشخص شود، با زدن دکمه از کاربر خواسته می‌شود رباتی بسازد و به اشتراک بگذارد که توسط ربات فعلی مدیریت شود. برای ربات‌هایی در دسترس است که مدیریت ربات‌های دیگر را در مینی‌اپ @BotFather فعال کرده‌اند. فقط در گفتگوهای خصوصی در دسترس است. |
| request_contact | Boolean | اختیاری. اگر True باشد، با زدن دکمه شمارهٔ تلفن کاربر به‌عنوان مخاطب فرستاده می‌شود. فقط در گفتگوهای خصوصی در دسترس است. |
| request_location | Boolean | اختیاری. اگر True باشد، با زدن دکمه موقعیت فعلی کاربر فرستاده می‌شود. فقط در گفتگوهای خصوصی در دسترس است. |
| request_poll | KeyboardButtonPollType | اختیاری. اگر مشخص شود، با زدن دکمه از کاربر خواسته می‌شود نظرسنجی بسازد و برای ربات بفرستد. فقط در گفتگوهای خصوصی در دسترس است. |
| web_app | WebAppInfo | اختیاری. اگر مشخص شود، با زدن دکمه Web App توصیف‌شده اجرا می‌شود. Web App می‌تواند پیام سرویسی «web_app_data» بفرستد. فقط در گفتگوهای خصوصی در دسترس است. |