class aiogram.types.callback_query.CallbackQuery(*, id: str, from_user: User, chat_instance: str, message: Optional[Message] = None, inline_message_id: Optional[str] = None, data: Optional[str] = None, game_short_name: Optional[str] = None, **extra_data: Any)[source]#

This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present. Exactly one of the fields data or game_short_name will be present.

NOTE: After the user presses a callback button, Telegram clients will display a progress bar until you call aiogram.methods.answer_callback_query.AnswerCallbackQuery. It is, therefore, necessary to react by calling aiogram.methods.answer_callback_query.AnswerCallbackQuery even if no notification to the user is needed (e.g., without specifying any of the optional parameters).


id: str#

Unique identifier for this query

from_user: User#


chat_instance: str#

Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in

message: Optional[Message]#

Optional. Message with the callback button that originated the query. Note that message content and message date will not be available if the message is too old

inline_message_id: Optional[str]#

Optional. Identifier of the message sent via the bot in inline mode, that originated the query.

data: Optional[str]#

Optional. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.

game_short_name: Optional[str]#

Optional. Short name of a Game to be returned, serves as the unique identifier for the game

answer(text: Optional[str] = None, show_alert: Optional[bool] = None, url: Optional[str] = None, cache_time: Optional[int] = None) AnswerCallbackQuery[source]#

Answer to callback query

  • text

  • show_alert

  • url

  • cache_time