Update

Raw MD
This object represents an incoming update

This object represents an incoming update.

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

Fields

FieldTypeRequiredDescription
update_idIntegerAlwaysThe update's unique identifier. Update identifiers start from a certain positive number and increase sequentially. This identifier 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.
messageMessageOptionalNew incoming message of any kind - text, photo, sticker, etc.
edited_messageMessageOptionalNew version of a message that is known to the bot and was edited. This update may at times be triggered by changes to message fields that are either unavailable or not actively used by your bot.
channel_postMessageOptionalNew incoming channel post of any kind - text, photo, sticker, etc.
edited_channel_postMessageOptionalNew version of a channel post that is known to the bot and was edited. This update may at times be triggered by changes to message fields that are either unavailable or not actively used by your bot.
business_connectionBusinessConnectionOptionalThe bot was connected to or disconnected from a business account, or a user edited an existing connection with the bot
business_messageMessageOptionalNew message from a connected business account
edited_business_messageMessageOptionalNew version of a message from a connected business account
deleted_business_messagesBusinessMessagesDeletedOptionalMessages were deleted from a connected business account
guest_messageMessageOptionalNew guest message. The bot can use the field Message.guest_query_id and the method answerGuestQuery to send a message in response.
message_reactionMessageReactionUpdatedOptionalA reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify "message_reaction" in the list of allowed_updates to receive these updates. The update isn't received for reactions set by bots.
message_reaction_countMessageReactionCountUpdatedOptionalReactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify "message_reaction_count" in the list of allowed_updates to receive these updates. The updates are grouped and can be sent with delay up to a few minutes.
inline_queryInlineQueryOptionalNew incoming inline query
chosen_inline_resultChosenInlineResultOptionalThe result of an inline query that was chosen by a user and sent to their chat partner. Please see our documentation on the feedback collecting for details on how to enable these updates for your bot.
callback_queryCallbackQueryOptionalNew incoming callback query
shipping_queryShippingQueryOptionalNew incoming shipping query. Only for invoices with flexible price.
pre_checkout_queryPreCheckoutQueryOptionalNew incoming pre-checkout query. Contains full information about checkout.
purchased_paid_mediaPaidMediaPurchasedOptionalA user purchased paid media with a non-empty payload sent by the bot in a non-channel chat
pollPollOptionalNew poll state. Bots receive only updates about manually stopped polls and polls, which are sent by the bot.
poll_answerPollAnswerOptionalA user changed their answer in a non-anonymous poll. Bots receive new votes only in polls that were sent by the bot itself.
my_chat_memberChatMemberUpdatedOptionalThe bot's chat member status was updated in a chat. For private chats, this update is received only when the bot is blocked or unblocked by the user.
chat_memberChatMemberUpdatedOptionalA chat member's status was updated in a chat. The bot must be an administrator in the chat and must explicitly specify "chat_member" in the list of allowed_updates to receive these updates.
chat_join_requestChatJoinRequestOptionalA request to join the chat has been sent. The bot must have the can_invite_users administrator right in the chat to receive these updates.
chat_boostChatBoostUpdatedOptionalA chat boost was added or changed. The bot must be an administrator in the chat to receive these updates.
removed_chat_boostChatBoostRemovedOptionalA boost was removed from a chat. The bot must be an administrator in the chat to receive these updates.
managed_botManagedBotUpdatedOptionalA new bot was created to be managed by the bot, or token or owner of a managed bot was changed
subscriptionBotSubscriptionUpdatedOptionalUser payment subscription has changed
stopped_message_generationMessageGenerationStoppedOptionalA user asked the bot to stop the generation of a message
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.