RichMessageButton
نوع دادهاین شیء یک دکمه در RichMessage را نشان می‌دهد. برای مشخص‌کردن نوع دکمه دقیقاً یکی از فیلدهایی که text و style نیستند باید استفاده شود.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| text | RichText | متن دکمه. فقط می‌تواند شامل متن ساده و موجودیت‌های RichTextCustomEmoji و RichTextDateTime باشد. |
| style | String | اختیاری. سبک دکمه. باید یکی از «danger»، «success»، «primary» یا «link» باشد (در حالت «link» دکمه مانند لینک معمولی و بدون حاشیه نمایش داده می‌شود). اپ‌ها ممکن است بر اساس سبک، رنگ‌های مخصوص تم را برای پس‌زمینه و متن دکمه استفاده کنند. سبک «link» فقط برای دکمه‌های callback مجاز است. |
| 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 | اختیاری. دکمه‌ای که متن مشخص‌شده را در کلیپ‌بورد کپی می‌کند. |
| disabled | DisabledButton | اختیاری. اگر تنظیم شود، دکمه غیرفعال است و کاری انجام نمی‌دهد. |