KeyboardButton#
- class aiogram.types.keyboard_button.KeyboardButton(*, text: str, request_users: KeyboardButtonRequestUsers | None = None, request_chat: KeyboardButtonRequestChat | None = None, request_contact: bool | None = None, request_location: bool | None = None, request_poll: KeyboardButtonPollType | None = None, web_app: WebAppInfo | None = None, request_user: KeyboardButtonRequestUser | None = None, **extra_data: Any)[source]#
This object represents one button of the reply keyboard. For simple text buttons, String can be used instead of this object to specify the button text. The optional fields web_app, request_users, request_chat, request_contact, request_location, and request_poll are mutually exclusive. Note: request_users and request_chat options will only work in Telegram versions released after 3 February, 2023. Older clients will display unsupported message.
Source: https://core.telegram.org/bots/api#keyboardbutton
- text: str#
Text of the button. If none of the optional fields are used, it will be sent as a message when the button is pressed
- request_users: KeyboardButtonRequestUsers | None#
Optional. If specified, pressing the button will open a list of suitable users. Identifiers of selected users will be sent to the bot in a ‘users_shared’ service message. Available in private chats only.
- request_chat: KeyboardButtonRequestChat | None#
Optional. If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a ‘chat_shared’ service message. Available in private chats only.
- request_contact: bool | None#
Optional. If
True
, the user’s phone number will be sent as a contact when the button is pressed. Available in private chats only.
- model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}#
A dictionary of computed field names and their corresponding ComputedFieldInfo objects.
- model_post_init(_ModelMetaclass__context: Any) → None#
We need to both initialize private attributes and call the user-defined model_post_init method.
- request_location: bool | None#
Optional. If
True
, the user’s current location will be sent when the button is pressed. Available in private chats only.
- request_poll: KeyboardButtonPollType | None#
Optional. If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only.
- web_app: WebAppInfo | None#
Optional. If specified, the described Web App will be launched when the button is pressed. The Web App will be able to send a ‘web_app_data’ service message. Available in private chats only.
- request_user: KeyboardButtonRequestUser | None#
Optional. If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a ‘user_shared’ service message. Available in private chats only.
Deprecated since version API:7.0: https://core.telegram.org/bots/api-changelog#december-29-2023