telegram.Update

class telegram.Update(update_id: int, message: telegram.message.Message = None, edited_message: telegram.message.Message = None, channel_post: telegram.message.Message = None, edited_channel_post: telegram.message.Message = None, inline_query: telegram.inline.inlinequery.InlineQuery = None, chosen_inline_result: telegram.choseninlineresult.ChosenInlineResult = None, callback_query: telegram.callbackquery.CallbackQuery = None, shipping_query: telegram.payment.shippingquery.ShippingQuery = None, pre_checkout_query: telegram.payment.precheckoutquery.PreCheckoutQuery = None, poll: telegram.poll.Poll = None, poll_answer: telegram.poll.PollAnswer = None, **_kwargs)

Bases: telegram.base.TelegramObject

This object represents an incoming update.

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their update_id is equal.

Note

At most one of the optional parameters can be present in any given update.

Parameters:
  • update_id (int) – The update’s unique identifier. Update identifiers start from a certain positive number and increase sequentially. This ID becomes especially handy if you’re using Webhooks, since it allows you to ignore repeated updates or to restore the correct update sequence, should they get out of order. If there are no new updates for at least a week, then identifier of the next update will be chosen randomly instead of sequentially.
  • message (telegram.Message, optional) – New incoming message of any kind - text, photo, sticker, etc.
  • edited_message (telegram.Message, optional) – New version of a message that is known to the bot and was edited.
  • channel_post (telegram.Message, optional) – New incoming channel post of any kind - text, photo, sticker, etc.
  • edited_channel_post (telegram.Message, optional) – New version of a channel post that is known to the bot and was edited.
  • inline_query (telegram.InlineQuery, optional) – New incoming inline query.
  • chosen_inline_result (telegram.ChosenInlineResult, optional) – The result of an inline query that was chosen by a user and sent to their chat partner.
  • callback_query (telegram.CallbackQuery, optional) – New incoming callback query.
  • shipping_query (telegram.ShippingQuery, optional) – New incoming shipping query. Only for invoices with flexible price.
  • pre_checkout_query (telegram.PreCheckoutQuery, optional) – New incoming pre-checkout query. Contains full information about checkout.
  • poll (telegram.Poll, optional) – New poll state. Bots receive only updates about stopped polls and polls, which are sent by the bot.
  • poll_answer (telegram.PollAnswer, optional) – A user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself.
  • **kwargs (dict) – Arbitrary keyword arguments.
update_id

The update’s unique identifier.

Type:int
message

Optional. New incoming message.

Type:telegram.Message
edited_message

Optional. New version of a message.

Type:telegram.Message
channel_post

Optional. New incoming channel post.

Type:telegram.Message
edited_channel_post

Optional. New version of a channel post.

Type:telegram.Message
inline_query

Optional. New incoming inline query.

Type:telegram.InlineQuery
chosen_inline_result

Optional. The result of an inline query that was chosen by a user.

Type:telegram.ChosenInlineResult
callback_query

Optional. New incoming callback query.

Type:telegram.CallbackQuery
shipping_query

Optional. New incoming shipping query.

Type:telegram.ShippingQuery
pre_checkout_query

Optional. New incoming pre-checkout query.

Type:telegram.PreCheckoutQuery
poll

Optional. New poll state. Bots receive only updates about stopped polls and polls, which are sent by the bot.

Type:telegram.Poll
poll_answer

Optional. A user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself.

Type:telegram.PollAnswer
classmethod de_json(data: Optional[Dict[str, Any]], bot: Bot) → Optional[Update]
effective_chat

The chat that this update was sent in, no matter what kind of update this is. Will be None for inline_query, chosen_inline_result, callback_query from inline messages, shipping_query, pre_checkout_query, poll and poll_answer.

Type:telegram.Chat
effective_message

The message included in this update, no matter what kind of update this is. Will be None for inline_query, chosen_inline_result, callback_query from inline messages, shipping_query, pre_checkout_query, poll and poll_answer.

Type:telegram.Message
effective_user

The user that sent this update, no matter what kind of update this is. Will be None for channel_post and poll.

Type:telegram.User