class hydrogram.types.CallbackQuery[source]

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.

  • id (str) – Unique identifier for this query.

  • from_user (User) – Sender.

  • chat_instance (str, optional) – Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.

  • message (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 (str) – Identifier of the message sent via the bot in inline mode, that originated the query.

  • data (str | bytes, optional) – Data associated with the callback button. Be aware that a bad client can send arbitrary data in this field.

  • game_short_name (str, optional) – Short name of a Game to be returned, serves as the unique identifier for the game.

  • matches (List of regex Matches, *optional*) – A list containing all Match Objects that match the data of this callback query. Only applicable when using Filters.regex.