InlineKeyboardButton
نوع دادهاین شیء یک دکمه از کیبورد اینلاین را نشان می‌دهد. برای مشخص‌کردن نوع دکمه دقیقاً یکی از فیلدهایی که text، icon_custom_emoji_id و style نیستند باید استفاده شود.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| text | String | متن برچسب دکمه |
| icon_custom_emoji_id | String | اختیاری. شناسهٔ یکتای ایموجی سفارشی که پیش از متن دکمه نمایش داده می‌شود. فقط ربات‌هایی که نام‌کاربری اضافه در Fragment خریده‌اند، یا در پیام‌هایی که ربات مستقیماً به گفتگوهای خصوصی، گروه و ابرگروه می‌فرستد و مالک ربات اشتراک تلگرام پریمیوم دارد، می‌توانند از آن استفاده کنند. |
| style | String | اختیاری. سبک دکمه. باید یکی از «danger» (قرمز)، «success» (سبز) یا «primary» (آبی) باشد. اگر ذکر نشود، سبک پیش‌فرض اپ استفاده می‌شود. |
| url | String | اختیاری. آدرس HTTP یا tg:// که با زدن دکمه باز می‌شود. اگر تنظیمات حریم خصوصی کاربر اجازه دهد، لینک‌های tg://user?id=<user_id> را می‌توان برای منشن‌کردن کاربر با شناسه (بدون نام‌کاربری) استفاده کرد. |
| callback_data | String | اختیاری. داده‌ای که با زدن دکمه در یک callback query برای ربات فرستاده می‌شود؛ ۱ تا ۶۴ بایت |
| web_app | WebAppInfo | اختیاری. توضیح Web Appای که با زدن دکمه توسط کاربر اجرا می‌شود. Web App می‌تواند با متد answerWebAppQuery از طرف کاربر پیام دلخواه بفرستد. فقط در گفتگوهای خصوصی بین کاربر و ربات در دسترس است. برای پیام‌هایی که از طرف حساب کسب‌وکار فرستاده می‌شوند پشتیبانی نمی‌شود. |
| login_url | LoginUrl | اختیاری. آدرس HTTPS که برای احراز هویت خودکار کاربر استفاده می‌شود. می‌تواند جایگزین ویجت ورود تلگرام (Telegram Login Widget) باشد. برای پیام‌های موقت پشتیبانی نمی‌شود. |
| switch_inline_query | String | اختیاری. اگر مشخص شود، با زدن دکمه از کاربر خواسته می‌شود یکی از گفتگوهایش را انتخاب کند؛ آن گفتگو باز می‌شود و نام‌کاربری ربات و درخواست اینلاین مشخص‌شده در فیلد ورودی درج می‌شود. می‌تواند خالی باشد که در این حالت فقط نام‌کاربری ربات درج می‌شود. برای پیام‌های گفتگوهای پیام مستقیم کانال و پیام‌هایی که از طرف حساب کسب‌وکار فرستاده می‌شوند پشتیبانی نمی‌شود. |
| switch_inline_query_current_chat | String | اختیاری. اگر مشخص شود، با زدن دکمه نام‌کاربری ربات و درخواست اینلاین مشخص‌شده در فیلد ورودی گفتگوی فعلی درج می‌شود. می‌تواند خالی باشد که در این حالت فقط نام‌کاربری ربات درج می‌شود. این راهی سریع است تا کاربر ربات شما را در همان گفتگو در حالت اینلاین باز کند؛ برای انتخاب یک مورد از میان چند گزینه مناسب است. در کانال‌ها، گفتگوهای پیام مستقیم کانال و پیام‌هایی که از طرف حساب کسب‌وکار فرستاده می‌شوند پشتیبانی نمی‌شود. |
| switch_inline_query_chosen_chat | SwitchInlineQueryChosenChat | اختیاری. اگر مشخص شود، با زدن دکمه از کاربر خواسته می‌شود یکی از گفتگوهایش را از نوع مشخص‌شده انتخاب کند؛ آن گفتگو باز می‌شود و نام‌کاربری ربات و درخواست اینلاین مشخص‌شده در فیلد ورودی درج می‌شود. برای پیام‌های گفتگوهای پیام مستقیم کانال و پیام‌هایی که از طرف حساب کسب‌وکار فرستاده می‌شوند پشتیبانی نمی‌شود. |
| copy_text | CopyTextButton | اختیاری. توضیح دکمه‌ای که متن مشخص‌شده را در کلیپ‌بورد کپی می‌کند. |
| callback_game | CallbackGame | اختیاری. توضیح بازی‌ای که با زدن دکمه توسط کاربر اجرا می‌شود. نکته: این نوع دکمه باید همیشه اولین دکمهٔ ردیف اول باشد. |
| pay | Boolean | اختیاری. برای ارسال دکمهٔ پرداخت (Pay)، True بدهید. زیررشته‌های «⭐» و «XTR» در متن دکمه با آیکون ستارهٔ تلگرام جایگزین می‌شوند. نکته: این نوع دکمه باید همیشه اولین دکمهٔ ردیف اول باشد و فقط در پیام‌های صورتحساب قابل استفاده است. |
| disabled | DisabledButton | اختیاری. اگر تنظیم شود، دکمه غیرفعال است و کاری انجام نمی‌دهد. |