CallbackQuery

class pyrogram.types.CallbackQuery

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.

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

  • from_user (:obj:`~pyrogram.types.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 (:obj:`~pyrogram.types.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.