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
forinline_query
,chosen_inline_result
,callback_query
from inline messages,shipping_query
,pre_checkout_query
,poll
andpoll_answer
.Type: telegram.Chat
-
effective_message
¶ The message included in this update, no matter what kind of update this is. Will be
None
forinline_query
,chosen_inline_result
,callback_query
from inline messages,shipping_query
,pre_checkout_query
,poll
andpoll_answer
.Type: telegram.Message
-
effective_user
¶ The user that sent this update, no matter what kind of update this is. Will be
None
forchannel_post
andpoll
.Type: telegram.User
- update_id (