ReplyKeyboardMarkup
نوع دادهاین شیء یک کیبورد سفارشی با گزینههای پاسخ را نشان میدهد (برای جزئیات و مثالها «مقدمهای بر رباتها» را ببینید). در کانالها و برای پیامهایی که از طرف حساب کسبوکار فرستاده میشوند پشتیبانی نمیشود.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| keyboard | Array of Array of KeyboardButton | آرایهای از ردیفهای دکمه؛ هر ردیف آرایهای از اشیای KeyboardButton است. |
| is_persistent | Boolean | اختیاری. از کلاینتها میخواهد وقتی کیبورد معمولی پنهان است، همیشه کیبورد را نشان دهند. پیشفرض False است؛ در این حالت کیبورد سفارشی را میتوان پنهان کرد و با آیکون کیبورد باز کرد. |
| resize_keyboard | Boolean | اختیاری. از کلاینتها میخواهد اندازهٔ کیبورد را عمودی تغییر دهند تا بهترین تناسب حاصل شود (مثلاً اگر فقط دو ردیف دکمه است کیبورد را کوچکتر کنند). پیشفرض False است؛ در این حالت کیبورد سفارشی همیشه ارتفاعی برابر کیبورد استاندارد اپ دارد. |
| one_time_keyboard | Boolean | اختیاری. از کلاینتها میخواهد بهمحض استفاده از کیبورد، آن را پنهان کنند. کیبورد همچنان در دسترس خواهد بود، اما کلاینتها بهطور خودکار کیبورد معمولی حروف را در گفتگو نشان میدهند؛ کاربر میتواند با دکمهٔ مخصوصی در فیلد ورودی دوباره کیبورد سفارشی را ببیند. پیشفرض False. |
| input_field_placeholder | String | اختیاری. متن راهنمایی (placeholder) که هنگام فعالبودن کیبورد در فیلد ورودی نمایش داده میشود؛ ۱ تا ۶۴ نویسه |
| selective | Boolean | اختیاری. اگر میخواهید کیبورد را فقط به کاربران مشخصی نشان دهید از این پارامتر استفاده کنید. هدفها: ۱) کاربرانی که در متن شیء Message با @ منشن شدهاند؛ ۲) اگر پیام ربات پاسخ به پیامی در همان گفتگو و همان تاپیک فروم باشد، فرستندهٔ پیام اصلی. مثال: کاربری درخواست تغییر زبان ربات را میدهد و ربات با کیبوردی برای انتخاب زبان جدید پاسخ میدهد؛ سایر کاربران گروه کیبورد را نمیبینند. |
| force_reply | Boolean | اختیاری. اگر میخواهید رابط پاسخ به کاربر نشان داده شود، True بدهید؛ انگار کاربر خودش پیام ربات را انتخاب کرده و روی «پاسخ» (Reply) زده است. |