telegram.Update

class telegram.Update(update_id, message=None, edited_message=None, channel_post=None, edited_channel_post=None, inline_query=None, chosen_inline_result=None, callback_query=None, shipping_query=None, pre_checkout_query=None, poll=None, poll_answer=None, **kwargs)

Bases: telegram.base.TelegramObject

This object represents an incoming update.

Note

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

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
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.
  • 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 polls, which are sent or stopped 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.
classmethod de_json(data, bot)
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