identity: name: message_edited author: langgenius label: en_US: Message Edited zh_Hans: 消息已编辑 ja_JP: メッセージ編集 description: en_US: Triggers when a previously sent message is edited. zh_Hans: 当已发送的消息被编辑时触发。 ja_JP: 送信済みメッセージが編集されたときにトリガーします。 parameters: [] output_schema: type: object additionalProperties: false required: - update_id - message properties: update_id: type: integer description: Unique identifier for the Telegram update. message: type: object description: Telegram Message object as defined in the Bot API. additionalProperties: true properties: message_id: type: integer description: Unique message identifier inside this chat. message_thread_id: type: integer description: Identifier of the message thread to which the message belongs. from: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_chat: type: object description: Telegram Chat object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. is_forum: type: boolean description: True if the supergroup chat is a forum. photo: type: object description: Chat photo information. properties: small_file_id: type: string description: File identifier of the small (160x160) chat photo version. small_file_unique_id: type: string description: Unique file identifier of the small chat photo version. big_file_id: type: string description: File identifier of the big (640x640) chat photo version. big_file_unique_id: type: string description: Unique file identifier of the big chat photo version. additionalProperties: false active_usernames: type: array items: type: string description: List of all active chat usernames. emoji_status_custom_emoji_id: type: string description: Custom emoji identifier of the chat emoji status. bio: type: string description: Bio of the other party in a private chat. has_private_forwards: type: boolean description: True if privacy settings allow private forwards. has_restricted_voice_and_video_messages: type: boolean description: True if voice and video messages are restricted. join_to_send_messages: type: boolean description: True if all users must join before they can send messages. join_by_request: type: boolean description: True if only users invited by administrators can join. description: type: string description: Chat description for supergroups and channels. invite_link: type: string description: Primary invite link for the chat. pinned_message: type: object description: Pinned message in the sender chat. additionalProperties: false properties: message_id: type: integer description: Unique message identifier inside the chat. message_thread_id: type: integer description: Identifier of the thread the message belongs to, for forum topics. date: type: integer description: Date the message was sent in Unix time. chat: type: object description: Chat the message belongs to. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. from: type: object description: Sender of the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_chat: type: object description: Channel on behalf of which the message was sent. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. text: type: string description: Text of the message. entities: type: array description: Special entities that appear in message text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. permissions: type: object description: Default chat member permissions. properties: can_send_messages: type: boolean description: True if the user may send text messages. can_send_audios: type: boolean description: True if the user may send audio messages. can_send_documents: type: boolean description: True if the user may send document messages. can_send_photos: type: boolean description: True if the user may send photos. can_send_videos: type: boolean description: True if the user may send videos. can_send_video_notes: type: boolean description: True if the user may send video notes. can_send_voice_notes: type: boolean description: True if the user may send voice notes. can_send_polls: type: boolean description: True if the user may send polls. can_send_other_messages: type: boolean description: True if the user may send animations, games, stickers, and use inline bots. can_add_web_page_previews: type: boolean description: True if the user may add web page previews to messages. can_change_info: type: boolean description: True if the user may change the chat title, photo, and other settings. can_invite_users: type: boolean description: True if the user may invite new users to the chat. can_pin_messages: type: boolean description: True if the user may pin messages. can_manage_topics: type: boolean description: True if the user may manage forum topics. can_manage_video_chats: type: boolean description: True if the user may manage video chats. can_post_stories: type: boolean description: True if the user may post stories. can_edit_stories: type: boolean description: True if the user may edit stories. can_delete_stories: type: boolean description: True if the user may delete stories. additionalProperties: false slow_mode_delay: type: integer description: Allowed delay between consecutive messages for non-administrators. message_auto_delete_time: type: integer description: Time after which messages are automatically deleted. has_protected_content: type: boolean description: True if content protection is enabled. sticker_set_name: type: string description: Name of the group sticker set. can_set_sticker_set: type: boolean description: True if the bot can change the group sticker set. linked_chat_id: type: integer description: Identifier of the linked channel for supergroups. location: type: object description: Location to which the supergroup is connected. properties: location: type: object description: Location coordinates of the chat. additionalProperties: false required: - latitude - longitude properties: latitude: type: number description: Latitude as defined by the sender. longitude: type: number description: Longitude as defined by the sender. horizontal_accuracy: type: number description: Radius of uncertainty for the location, in meters; 0-1500. live_period: type: integer description: Time in seconds while the location can be updated. heading: type: integer description: Direction in which the user is moving, in degrees 1-360. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts about approaching another chat member, in meters. address: type: string description: Address of the location; 1-64 characters, as defined by the sender. additionalProperties: false required: - location - address has_hidden_members: type: boolean description: True if members are hidden in the chat. has_aggressive_anti_spam_enabled: type: boolean description: True if aggressive anti-spam is enabled. has_hidden_participants: type: boolean description: True if only admins can see other participants. has_visible_history: type: boolean description: True if new members can see message history. boost_level: type: integer description: Current boost level of the chat. emoji_status_expiration_date: type: integer description: Expiration date of the emoji status in Unix time. custom_emoji_sticker_set_name: type: string description: Name of the custom emoji sticker set used in the chat. business_intro: type: object description: Business intro information for the chat. properties: title: type: string description: Localized title displayed in the business intro. message: type: string description: Introductory message shown to customers. sticker: type: object description: Sticker used in the business intro. additionalProperties: false properties: file_id: type: string description: Identifier for this sticker file. file_unique_id: type: string description: Unique identifier for this sticker file. emoji: type: string description: Emoji associated with the sticker. type: type: string description: Sticker type, e.g. regular or custom_emoji. width: type: integer description: Sticker width in pixels. height: type: integer description: Sticker height in pixels. is_animated: type: boolean description: True if the sticker is animated. is_video: type: boolean description: True if the sticker is a video sticker. additionalProperties: false business_location: type: object description: Business location information for the chat. properties: address: type: string description: Business address used for profile disclosure. location: type: object description: Location coordinates of the chat. additionalProperties: false required: - latitude - longitude properties: latitude: type: number description: Latitude as defined by the sender. longitude: type: number description: Longitude as defined by the sender. horizontal_accuracy: type: number description: Radius of uncertainty for the location, in meters; 0-1500. live_period: type: integer description: Time in seconds while the location can be updated. heading: type: integer description: Direction in which the user is moving, in degrees 1-360. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts about approaching another chat member, in meters. additionalProperties: false business_opening_hours: type: object description: Business opening hours for the chat. properties: time_zone_name: type: string description: Time zone in IANA format that the business hours relate to. opening_hours: type: array description: Opening hour intervals within the week. items: type: object additionalProperties: false properties: opening_minute: type: integer description: Minute of the day when the business opens (0-1439). closing_minute: type: integer description: Minute of the day when the business closes (0-1439). opening_day: type: integer description: Day of week when the interval starts, 1 (Monday) to 7 (Sunday). closing_day: type: integer description: Day of week when the interval ends, 1 (Monday) to 7 (Sunday). additionalProperties: false personal_chat: type: object description: Personal chat information if applicable. properties: chat_id: type: integer description: Identifier for the personal chat with the business. user: type: object description: User that is part of this personal chat. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. additionalProperties: false sender_boost_count: type: integer description: Number of boosts applied by the sender at the time of sending. sender_business_bot: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. date: type: integer description: Date the message was sent in Unix time. business_connection_id: type: string description: Unique identifier of the business connection through which the message was received. chat: type: object description: Telegram Chat object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. is_forum: type: boolean description: True if the supergroup chat is a forum. photo: type: object description: Chat photo information. properties: small_file_id: type: string description: File identifier of the small (160x160) chat photo version. small_file_unique_id: type: string description: Unique file identifier of the small chat photo version. big_file_id: type: string description: File identifier of the big (640x640) chat photo version. big_file_unique_id: type: string description: Unique file identifier of the big chat photo version. additionalProperties: false active_usernames: type: array items: type: string description: List of all active chat usernames. emoji_status_custom_emoji_id: type: string description: Custom emoji identifier of the chat emoji status. bio: type: string description: Bio of the other party in a private chat. has_private_forwards: type: boolean description: True if privacy settings allow private forwards. has_restricted_voice_and_video_messages: type: boolean description: True if voice and video messages are restricted. join_to_send_messages: type: boolean description: True if all users must join before they can send messages. join_by_request: type: boolean description: True if only users invited by administrators can join. description: type: string description: Chat description for supergroups and channels. invite_link: type: string description: Primary invite link for the chat. pinned_message: type: object description: Pinned message in the chat. additionalProperties: false properties: message_id: type: integer description: Unique message identifier inside the chat. message_thread_id: type: integer description: Identifier of the thread the message belongs to, for forum topics. date: type: integer description: Date the message was sent in Unix time. chat: type: object description: Chat the message belongs to. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. from: type: object description: Sender of the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_chat: type: object description: Channel on behalf of which the message was sent. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. text: type: string description: Text of the message. entities: type: array description: Special entities that appear in message text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. permissions: type: object description: Default chat member permissions. properties: can_send_messages: type: boolean description: True if the user may send text messages. can_send_audios: type: boolean description: True if the user may send audio messages. can_send_documents: type: boolean description: True if the user may send document messages. can_send_photos: type: boolean description: True if the user may send photos. can_send_videos: type: boolean description: True if the user may send videos. can_send_video_notes: type: boolean description: True if the user may send video notes. can_send_voice_notes: type: boolean description: True if the user may send voice notes. can_send_polls: type: boolean description: True if the user may send polls. can_send_other_messages: type: boolean description: True if the user may send animations, games, stickers, and use inline bots. can_add_web_page_previews: type: boolean description: True if the user may add web page previews to messages. can_change_info: type: boolean description: True if the user may change the chat title, photo, and other settings. can_invite_users: type: boolean description: True if the user may invite new users to the chat. can_pin_messages: type: boolean description: True if the user may pin messages. can_manage_topics: type: boolean description: True if the user may manage forum topics. can_manage_video_chats: type: boolean description: True if the user may manage video chats. can_post_stories: type: boolean description: True if the user may post stories. can_edit_stories: type: boolean description: True if the user may edit stories. can_delete_stories: type: boolean description: True if the user may delete stories. additionalProperties: false slow_mode_delay: type: integer description: Allowed delay between consecutive messages for non-administrators. message_auto_delete_time: type: integer description: Time after which messages are automatically deleted. has_protected_content: type: boolean description: True if content protection is enabled. sticker_set_name: type: string description: Name of the group sticker set. can_set_sticker_set: type: boolean description: True if the bot can change the group sticker set. linked_chat_id: type: integer description: Identifier of the linked channel for supergroups. location: type: object description: Location to which the supergroup is connected. properties: location: type: object description: Location coordinates of the chat. additionalProperties: false required: - latitude - longitude properties: latitude: type: number description: Latitude as defined by the sender. longitude: type: number description: Longitude as defined by the sender. horizontal_accuracy: type: number description: Radius of uncertainty for the location, in meters; 0-1500. live_period: type: integer description: Time in seconds while the location can be updated. heading: type: integer description: Direction in which the user is moving, in degrees 1-360. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts about approaching another chat member, in meters. address: type: string description: Address of the location; 1-64 characters, as defined by the sender. additionalProperties: false required: - location - address has_hidden_members: type: boolean description: True if members are hidden in the chat. has_aggressive_anti_spam_enabled: type: boolean description: True if aggressive anti-spam is enabled. has_hidden_participants: type: boolean description: True if only admins can see other participants. has_visible_history: type: boolean description: True if new members can see message history. boost_level: type: integer description: Current boost level of the chat. emoji_status_expiration_date: type: integer description: Expiration date of the emoji status in Unix time. custom_emoji_sticker_set_name: type: string description: Name of the custom emoji sticker set used in the chat. business_intro: type: object description: Business intro information for the chat. properties: title: type: string description: Localized title displayed in the business intro. message: type: string description: Introductory message shown to customers. sticker: type: object description: Sticker used in the business intro. additionalProperties: false properties: file_id: type: string description: Identifier for this sticker file. file_unique_id: type: string description: Unique identifier for this sticker file. emoji: type: string description: Emoji associated with the sticker. type: type: string description: Sticker type, e.g. regular or custom_emoji. width: type: integer description: Sticker width in pixels. height: type: integer description: Sticker height in pixels. is_animated: type: boolean description: True if the sticker is animated. is_video: type: boolean description: True if the sticker is a video sticker. additionalProperties: false business_location: type: object description: Business location information for the chat. properties: address: type: string description: Business address used for profile disclosure. location: type: object description: Location coordinates of the chat. additionalProperties: false required: - latitude - longitude properties: latitude: type: number description: Latitude as defined by the sender. longitude: type: number description: Longitude as defined by the sender. horizontal_accuracy: type: number description: Radius of uncertainty for the location, in meters; 0-1500. live_period: type: integer description: Time in seconds while the location can be updated. heading: type: integer description: Direction in which the user is moving, in degrees 1-360. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts about approaching another chat member, in meters. additionalProperties: false business_opening_hours: type: object description: Business opening hours for the chat. properties: time_zone_name: type: string description: Time zone in IANA format that the business hours relate to. opening_hours: type: array description: Opening hour intervals within the week. items: type: object additionalProperties: false properties: opening_minute: type: integer description: Minute of the day when the business opens (0-1439). closing_minute: type: integer description: Minute of the day when the business closes (0-1439). opening_day: type: integer description: Day of week when the interval starts, 1 (Monday) to 7 (Sunday). closing_day: type: integer description: Day of week when the interval ends, 1 (Monday) to 7 (Sunday). additionalProperties: false personal_chat: type: object description: Personal chat information if applicable. properties: chat_id: type: integer description: Identifier for the personal chat with the business. user: type: object description: User that is part of this personal chat. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. additionalProperties: false forward_origin: type: object description: Origin details for forwarded messages. additionalProperties: false properties: type: type: string description: 'Type of the origin: user, hidden_user, chat, channel, message_link, or story.' date: type: integer description: Date the original message was sent in Unix time. sender_user: type: object description: User that originally sent the forwarded message. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_user_name: type: string description: Name of the anonymous user that sent the forwarded message. chat: type: object description: Chat that originally posted the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. message_id: type: integer description: Identifier of the original channel message. author_signature: type: string description: Signature of the original channel message author. has_protected_content: type: boolean description: True if the original message had protected content. story: type: object description: Story that was forwarded. additionalProperties: false properties: chat: type: object description: Chat that posted the story. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. id: type: integer description: Identifier of the story inside the chat. message_link: type: string description: Link to the original message when available. is_topic_message: type: boolean description: True if the message is a forum topic message. is_automatic_forward: type: boolean description: True if the message is automatically forwarded. reply_to_message: type: object description: Message that this message is replying to. additionalProperties: false properties: message_id: type: integer description: Unique message identifier inside the chat. message_thread_id: type: integer description: Identifier of the thread the message belongs to, for forum topics. date: type: integer description: Date the message was sent in Unix time. chat: type: object description: Chat the message belongs to. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. from: type: object description: Sender of the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_chat: type: object description: Channel on behalf of which the message was sent. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. text: type: string description: Text of the message. entities: type: array description: Special entities that appear in message text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. external_reply: type: object description: Information about the externally replied-to message. additionalProperties: false properties: origin: type: object description: Details about the original message origin. additionalProperties: false properties: type: type: string description: Origin type such as user, chat, channel, or message_link. date: type: integer description: Date the original message was sent in Unix time. sender_user: type: object description: Original message sender. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_user_name: type: string description: Name of the anonymous sender for hidden users. chat: type: object description: Chat that originally posted the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. message_id: type: integer description: Identifier of the original channel message. author_signature: type: string description: Signature of the channel message author. story: type: object description: Story that was forwarded or replied to. additionalProperties: false properties: chat: type: object description: Chat that posted the story. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. id: type: integer description: Identifier of the story inside the chat. url: type: string description: Link to the original message when available. chat: type: object description: Chat containing the replied-to message. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. message_id: type: integer description: Identifier of the replied-to message. link_preview_options: type: object description: Options used for link previews in messages. additionalProperties: false properties: is_disabled: type: boolean description: True if the link preview is disabled. url: type: string description: URL used for the preview if it differs from message text. prefer_small_media: type: boolean description: True if media with smaller dimensions should be shown first. prefer_large_media: type: boolean description: True if media with larger dimensions should be shown first. show_above_text: type: boolean description: True if the preview should be shown above the text of the message. location: type: object description: Geographical position information. additionalProperties: true properties: longitude: type: number description: Longitude as defined by sender. latitude: type: number description: Latitude as defined by sender. horizontal_accuracy: type: number description: The radius of uncertainty for the location. live_period: type: integer description: Time during which the location can be updated. heading: type: integer description: Direction in which user is moving. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts. photo: type: array description: Available sizes of the attached photo. items: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. animation: type: object description: Animation file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique file identifier. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original animation filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. audio: type: object description: Audio file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. duration: type: integer description: Duration in seconds. performer: type: string description: Performer of the audio. title: type: string description: Track name. file_name: type: string description: Original filename. mime_type: type: string description: MIME type. file_size: type: integer description: File size in bytes. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. document: &id001 type: object description: General file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. sticker: type: object description: Sticker included in the message. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. type: type: string description: Sticker type, e.g. regular or custom_emoji. width: type: integer description: Sticker width in pixels. height: type: integer description: Sticker height in pixels. is_animated: type: boolean description: True if the sticker is animated. is_video: type: boolean description: True if the sticker is a video sticker. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. emoji: type: string description: Emoji associated with the sticker. set_name: type: string description: Name of the sticker set the sticker belongs to. premium_animation: type: object description: Animation file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique file identifier. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original animation filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. mask_position: type: object description: For mask stickers, the position where the mask should be placed. additionalProperties: false properties: point: type: string description: Part of the face relative to which the mask is placed. x_shift: type: number description: Shift by the X axis measured in mask widths. y_shift: type: number description: Shift by the Y axis measured in mask heights. scale: type: number description: Mask scaling coefficient. custom_emoji_id: type: string description: Identifier of the custom emoji to which the sticker corresponds. needs_repainting: type: boolean description: True if the sticker must be repainted to match the background. file_size: type: integer description: File size in bytes. keywords: type: array description: List of search keywords for the sticker. items: type: string video: type: object description: Video file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. video_note: type: object description: Video note information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. length: type: integer description: Diameter of the video message in pixels. duration: type: integer description: Duration in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_size: type: integer description: File size in bytes. voice: type: object description: Voice note information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. duration: type: integer description: Duration in seconds. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. has_media_spoiler: type: boolean description: True if the original message media was marked as spoilers. quote: type: object description: Quoted part of a message that was replied to. additionalProperties: false properties: text: type: string description: Quoted text. entities: type: array description: Special entities that appear in the quote. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. position: type: integer description: Position of the quote in the original message text. is_manual: type: boolean description: True if the quote was added manually. translation: type: object description: Translated variant of the quote. additionalProperties: false properties: text: type: string description: Translated quote text. entities: type: array description: Entities found in the translated quote. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. reply_to_story: type: object description: Story that this message is replying to. additionalProperties: false properties: chat: type: object description: Chat that posted the story. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. id: type: integer description: Identifier of the story inside the chat. via_bot: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. edit_date: type: integer description: Date the message was last edited in Unix time. has_protected_content: type: boolean description: True if the message is protected from forwarding and saving. is_from_offline: type: boolean description: True if the message was sent via the bot's offline queue. media_group_id: type: string description: Media group identifier. author_signature: type: string description: Signature of the post author for channel messages. text: type: string description: Text of the message. entities: type: array description: Special entities in the message text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. link_preview_options: type: object description: Options used for link previews in messages. additionalProperties: false properties: is_disabled: type: boolean description: True if the link preview is disabled. url: type: string description: URL used for the preview if it differs from message text. prefer_small_media: type: boolean description: True if media with smaller dimensions should be shown first. prefer_large_media: type: boolean description: True if media with larger dimensions should be shown first. show_above_text: type: boolean description: True if the preview should be shown above the text of the message. effect_id: type: string description: Unique identifier of the message effect. animation: type: object description: Animation file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique file identifier. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original animation filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. audio: type: object description: Audio file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. duration: type: integer description: Duration in seconds. performer: type: string description: Performer of the audio. title: type: string description: Track name. file_name: type: string description: Original filename. mime_type: type: string description: MIME type. file_size: type: integer description: File size in bytes. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. document: type: object description: General file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. paid_media: type: object description: Information about paid media attached to the message. additionalProperties: false properties: star_count: type: integer description: Number of Telegram Stars required to unlock the media. paid_media: type: array description: Collection of paid media objects included with the message. items: type: object description: Single paid media item. additionalProperties: false properties: type: type: string description: Type of the paid media, such as photo or video. photo: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. video: type: object description: Video file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. description: type: string description: Optional caption describing the paid media package. photo: type: array description: Available sizes of the photo. items: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. sticker: type: object description: Sticker included in the message. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. type: type: string description: Sticker type, e.g. regular or custom_emoji. width: type: integer description: Sticker width in pixels. height: type: integer description: Sticker height in pixels. is_animated: type: boolean description: True if the sticker is animated. is_video: type: boolean description: True if the sticker is a video sticker. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. emoji: type: string description: Emoji associated with the sticker. set_name: type: string description: Name of the sticker set the sticker belongs to. premium_animation: type: object description: Animation file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique file identifier. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original animation filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. mask_position: type: object description: For mask stickers, the position where the mask should be placed. additionalProperties: false properties: point: type: string description: Part of the face relative to which the mask is placed. x_shift: type: number description: Shift by the X axis measured in mask widths. y_shift: type: number description: Shift by the Y axis measured in mask heights. scale: type: number description: Mask scaling coefficient. custom_emoji_id: type: string description: Identifier of the custom emoji to which the sticker corresponds. needs_repainting: type: boolean description: True if the sticker must be repainted to match the background. file_size: type: integer description: File size in bytes. keywords: type: array description: List of search keywords for the sticker. items: type: string story: type: object description: Story attached to the message. additionalProperties: false properties: chat: type: object description: Chat that posted the story. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. id: type: integer description: Identifier of the story inside the chat. video: type: object description: Video file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. video_note: type: object description: Video note information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. length: type: integer description: Diameter of the video message in pixels. duration: type: integer description: Duration in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_size: type: integer description: File size in bytes. voice: type: object description: Voice note information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. duration: type: integer description: Duration in seconds. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. caption: type: string description: Caption for the animation, audio, document, photo, or video. caption_entities: type: array description: Special entities in the caption. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. show_caption_above_media: type: boolean description: True if the caption should be shown above the media. has_media_spoiler: type: boolean description: True if the message has a spoiler animation. contact: type: object description: Contact information shared with the bot. additionalProperties: true properties: phone_number: type: string description: Contact phone number. first_name: type: string description: Contact first name. last_name: type: string description: Contact last name. user_id: type: integer description: Telegram user identifier if available. vcard: type: string description: Additional data about the contact in vCard format. dice: type: object description: Animated emoji with random value. additionalProperties: true properties: emoji: type: string description: Emoji on which the dice throw animation is based. value: type: integer description: Value of the dice. game: type: object description: Telegram game shared in the message. additionalProperties: false properties: title: type: string description: Title of the game. description: type: string description: Game description. photo: type: array description: Available sizes of the game photo. items: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. text: type: string description: Brief description of the game or high score text. text_entities: type: array description: Special entities that appear in the game description text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. animation: type: object description: Animation file information. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique file identifier. width: type: integer description: Video width. height: type: integer description: Video height. duration: type: integer description: Duration of the video in seconds. thumbnail: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. file_name: type: string description: Original animation filename. mime_type: type: string description: MIME type of the file. file_size: type: integer description: File size in bytes. poll: type: object description: Poll information. additionalProperties: true properties: id: type: string description: Unique poll identifier. question: type: string description: Poll question. options: type: array description: List of poll options. items: type: object description: Information about one answer option in a poll. additionalProperties: false properties: text: type: string description: Option text, 1-100 characters. text_entities: type: array description: Special entities that appear in the option text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. voter_count: type: integer description: Number of users that voted for this option. total_voter_count: type: integer description: Total number of users that voted in the poll. is_closed: type: boolean description: True if the poll is closed. is_anonymous: type: boolean description: True if the poll is anonymous. type: type: string description: Poll type, currently "regular" or "quiz". allows_multiple_answers: type: boolean description: True if the poll allows multiple answers. correct_option_id: type: integer description: 0-based identifier of the correct option for quiz-style polls. explanation: type: string description: Text that is shown when a user chooses an incorrect answer or taps the lamp icon. open_period: type: integer description: Amount of time in seconds the poll will be active after creation. close_date: type: integer description: Point in time when the poll will be automatically closed. venue: type: object description: Venue information. additionalProperties: true properties: location: type: object description: Geographical position information. additionalProperties: true properties: longitude: type: number description: Longitude as defined by sender. latitude: type: number description: Latitude as defined by sender. horizontal_accuracy: type: number description: The radius of uncertainty for the location. live_period: type: integer description: Time during which the location can be updated. heading: type: integer description: Direction in which user is moving. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts. title: type: string description: Name of the venue. address: type: string description: Address of the venue. foursquare_id: type: string description: Foursquare identifier of the venue. foursquare_type: type: string description: Type of the venue in Foursquare. google_place_id: type: string description: Google Places identifier of the venue. google_place_type: type: string description: Type of the venue in Google Places. location: type: object description: Geographical position information. additionalProperties: true properties: longitude: type: number description: Longitude as defined by sender. latitude: type: number description: Latitude as defined by sender. horizontal_accuracy: type: number description: The radius of uncertainty for the location. live_period: type: integer description: Time during which the location can be updated. heading: type: integer description: Direction in which user is moving. proximity_alert_radius: type: integer description: Maximum distance for proximity alerts. new_chat_members: type: array description: New members that were added to the group. items: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. left_chat_member: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. new_chat_title: type: string description: New chat title if it was changed. new_chat_photo: type: array description: New chat photo. items: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. delete_chat_photo: type: boolean description: True if the chat photo was deleted. group_chat_created: type: boolean description: True if the group has been created. supergroup_chat_created: type: boolean description: True if the supergroup has been created. channel_chat_created: type: boolean description: True if the channel has been created. message_auto_delete_timer_changed: type: object description: Service message about message auto-delete timer changed. properties: message_auto_delete_time: type: integer description: New auto-delete time for messages in the chat, in seconds. additionalProperties: false migrate_to_chat_id: type: integer description: Identifier of the supergroup the chat migrated to. migrate_from_chat_id: type: integer description: Identifier of the chat the supergroup migrated from. pinned_message: type: object description: Pinned message in the chat. additionalProperties: false properties: message_id: type: integer description: Unique message identifier inside the chat. message_thread_id: type: integer description: Identifier of the thread the message belongs to, for forum topics. date: type: integer description: Date the message was sent in Unix time. chat: type: object description: Chat the message belongs to. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. from: type: object description: Sender of the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_chat: type: object description: Channel on behalf of which the message was sent. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. text: type: string description: Text of the message. entities: type: array description: Special entities that appear in message text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. invoice: type: object description: Invoice issued by the bot. additionalProperties: false properties: title: type: string description: Product name. description: type: string description: Product description. start_parameter: type: string description: Unique bot deep-linking parameter for this invoice. currency: type: string description: Three-letter ISO 4217 currency code. total_amount: type: integer description: Total price in the smallest units of the currency. successful_payment: type: object description: Information about a successful payment. additionalProperties: false properties: currency: type: string description: Three-letter ISO 4217 currency code. total_amount: type: integer description: Total price in the smallest units of the currency. invoice_payload: type: string description: Bot specified invoice payload. shipping_option_id: type: string description: Identifier of the shipping option chosen by the user. order_info: type: object description: Order info provided by the user. additionalProperties: false properties: name: type: string description: User name. phone_number: type: string description: User phone number. email: type: string description: User email address. shipping_address: type: object description: Shipping address for the order. additionalProperties: false properties: country_code: type: string description: ISO 3166-1 alpha-2 country code. state: type: string description: State or region. city: type: string description: City. street_line1: type: string description: First line for the address. street_line2: type: string description: Second line for the address. post_code: type: string description: Postcode of the address. telegram_payment_charge_id: type: string description: Telegram payment identifier. provider_payment_charge_id: type: string description: Provider payment identifier. subscription_period: type: integer description: Subscription period in seconds for recurring payments. refunded_payment: type: object description: Information about a refunded payment. additionalProperties: false properties: currency: type: string description: Three-letter ISO 4217 currency code. total_amount: type: integer description: Total refunded amount in the smallest currency units. invoice_payload: type: string description: Bot specified invoice payload. telegram_payment_charge_id: type: string description: Telegram payment identifier. provider_payment_charge_id: type: string description: Provider payment identifier. users_shared: type: object description: Information about users shared with the bot. additionalProperties: false properties: request_id: type: integer description: Identifier of the request that triggered the share. users: type: array description: List of shared users. items: type: object description: User shared with the bot. additionalProperties: false properties: user_id: type: integer description: Identifier of the shared user. first_name: type: string description: First name of the shared user. last_name: type: string description: Last name of the shared user. username: type: string description: Username of the shared user. photo: type: array description: Available sizes of the user photo. items: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. chat_shared: type: object description: Information about a chat shared with the bot. additionalProperties: false properties: request_id: type: integer description: Identifier of the request that triggered the share. chat_id: type: integer description: Identifier of the shared chat. title: type: string description: Title of the shared chat. username: type: string description: Username of the shared chat, if available. photo: type: array description: Available sizes of the chat photo. items: type: object description: Size of a photo or a file / sticker thumbnail. additionalProperties: true properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. width: type: integer description: Photo width. height: type: integer description: Photo height. file_size: type: integer description: File size in bytes. connected_website: type: string description: The domain name of the website on which the user has logged in. write_access_allowed: type: object description: Service message about the bot being granted write access. additionalProperties: false properties: from_request: type: boolean description: True if granted after the user pressed an allow write access button. from_attachment_menu: type: boolean description: True if the bot was added to the attachment menu. web_app_name: type: string description: Name of the Web App that was launched to grant access. passport_data: type: object description: Telegram Passport data provided by the user. additionalProperties: false properties: data: type: array description: Encrypted Telegram Passport elements. items: type: object description: Single encrypted passport element. additionalProperties: false properties: type: type: string description: Type of the element. data: type: string description: Base64-encoded encrypted data. phone_number: type: string description: User phone number. email: type: string description: User email address. files: type: array description: Encrypted files with the document scans. items: type: object description: Encrypted passport file. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. file_size: type: integer description: File size in bytes. front_side: type: object description: Document front side. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. file_size: type: integer description: File size in bytes. reverse_side: type: object description: Document reverse side. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. file_size: type: integer description: File size in bytes. selfie: type: object description: Selfie with the document. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. file_size: type: integer description: File size in bytes. translation: type: array description: Translated document files. items: type: object description: Translated document file. additionalProperties: false properties: file_id: type: string description: Identifier for this file. file_unique_id: type: string description: Unique identifier for this file. file_size: type: integer description: File size in bytes. hash: type: string description: Base64-encoded element hash for verification. credentials: type: object description: Encrypted credentials required to decrypt Telegram Passport data. additionalProperties: false properties: data: type: string description: Base64-encoded encrypted JSON-serialized data. hash: type: string description: Base64-encoded data hash for verification. secret: type: string description: Base64-encoded secret used for data decryption. proximity_alert_triggered: type: object description: Service message for proximity alert triggers. additionalProperties: false properties: traveler: type: object description: User that triggered the alert. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. watcher: type: object description: User set to receive the alert. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. distance: type: integer description: Distance between the users in meters. boost_added: type: object description: Service message about a boost added to the chat. additionalProperties: false properties: boost_count: type: integer description: Number of boosts added by the user. chat_background_set: type: object description: Chat background configuration. additionalProperties: false properties: type: type: string description: Type of background, such as fill or wallpaper. dark_theme_dimming: type: integer description: Dark theme dimming level applied to the background (0-100). document: *id001 forum_topic_created: type: object description: Service message about a forum topic created. properties: name: type: string description: Name of the topic. icon_color: type: integer description: Color of the topic icon in RGB format. icon_custom_emoji_id: type: string description: Identifier of the custom emoji shown as the topic icon. additionalProperties: false forum_topic_edited: type: object description: Service message about a forum topic edited. properties: name: type: string description: New name of the topic. icon_custom_emoji_id: type: string description: Identifier of the new custom emoji shown as the topic icon. additionalProperties: false forum_topic_closed: type: object description: Service message about a forum topic closed. properties: {} additionalProperties: false forum_topic_reopened: type: object description: Service message about a forum topic reopened. properties: {} additionalProperties: false general_forum_topic_hidden: type: object description: Service message about the general forum topic hidden. properties: {} additionalProperties: false general_forum_topic_unhidden: type: object description: Service message about the general forum topic unhidden. properties: {} additionalProperties: false giveaway_created: type: object description: Service message about a giveaway that was created. additionalProperties: false properties: start_date: type: integer description: Giveaway start date in Unix time. end_date: type: integer description: Giveaway end date in Unix time. winner_count: type: integer description: Number of winners that will be selected. prize_star_count: type: integer description: Number of Telegram Stars granted to each winner, if applicable. prize_description: type: string description: Description of the prize. giveaway: type: object description: Active giveaway details. additionalProperties: false properties: prize_star_count: type: integer description: Number of Telegram Stars awarded to each winner, if any. prize_description: type: string description: Custom prize description shown to participants. country_codes: type: array description: ISO 3166-1 alpha-2 country codes allowed to participate. items: type: string start_date: type: integer description: Giveaway start date as Unix time. end_date: type: integer description: Giveaway end date as Unix time. winner_count: type: integer description: Number of winners that will be selected. premium_subscription_month_count: type: integer description: Number of Telegram Premium months granted as a prize. giveaway_winners: type: object description: Information about giveaway winners. additionalProperties: false properties: giveaway_message: type: object description: Original giveaway message. additionalProperties: false properties: message_id: type: integer description: Unique message identifier inside the chat. message_thread_id: type: integer description: Identifier of the thread the message belongs to, for forum topics. date: type: integer description: Date the message was sent in Unix time. chat: type: object description: Chat the message belongs to. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. from: type: object description: Sender of the message. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. sender_chat: type: object description: Channel on behalf of which the message was sent. additionalProperties: true properties: id: type: integer description: Unique identifier for this chat. type: type: string description: Type of chat, such as private, group, supergroup, or channel. title: type: string description: Chat title for supergroups, channels, and group chats. username: type: string description: Username of the chat if available. first_name: type: string description: First name of the other party in a private chat. last_name: type: string description: Last name of the other party in a private chat. text: type: string description: Text of the message. entities: type: array description: Special entities that appear in message text. items: type: object description: Special entity in a text message. additionalProperties: true properties: type: type: string description: Type of the entity. offset: type: integer description: Offset in UTF-16 code units to the start of the entity. length: type: integer description: Length of the entity in UTF-16 code units. url: type: string description: URL for "text_link" entity. user: type: object description: Telegram User object as defined in the Bot API. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. language: type: string description: Programming language of the entity text for "pre". custom_emoji_id: type: string description: Identifier of a custom emoji. winners: type: array description: Users who won the giveaway. items: type: object description: Winner information. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. additional_chat_count: type: integer description: Number of additional chats the user had to join to participate. prize_star_count: type: integer description: Number of Telegram Stars awarded to each winner, if applicable. premium_subscription_month_count: type: integer description: Telegram Premium subscription duration granted, in months. unclaimed_prize_count: type: integer description: Number of prizes that were not claimed by winners. giveaway_completed: type: object description: Summary of a completed giveaway. additionalProperties: false properties: winner_count: type: integer description: Number of winners selected. unclaimed_prize_count: type: integer description: Number of prizes that remained unclaimed. prize_star_count: type: integer description: Telegram Star prize for each winner, if applicable. premium_subscription_month_count: type: integer description: Premium subscription duration for each winner, in months. video_chat_scheduled: type: object description: Information about a scheduled video chat. additionalProperties: false properties: start_date: type: integer description: Point in time (Unix) when the video chat is supposed to start. video_chat_started: type: object description: Service message about a started video chat. additionalProperties: false properties: date: type: integer description: Start date of the video chat in Unix time. video_chat_ended: type: object description: Service message about an ended video chat. additionalProperties: false properties: duration: type: integer description: Video chat duration in seconds. video_chat_participants_invited: type: object description: Service message about invited video chat participants. additionalProperties: false properties: users: type: array description: Users that were invited to the video chat. items: type: object description: Invited user information. additionalProperties: true properties: id: type: integer description: Unique identifier for this user or bot. is_bot: type: boolean description: True if this user is a bot. first_name: type: string description: User first name. last_name: type: string description: User last name. username: type: string description: Username of the user, if any. language_code: type: string description: IETF language tag of the user's language. is_premium: type: boolean description: True if the user is a Telegram Premium subscriber. added_to_attachment_menu: type: boolean description: True if the user added the bot to the attachment menu. can_join_groups: type: boolean description: True if the bot can join groups. can_read_all_group_messages: type: boolean description: True if privacy mode is disabled for the bot. supports_inline_queries: type: boolean description: True if the bot can be invited to inline mode. can_connect_to_business: type: boolean description: True if the bot can connect to Telegram Business accounts. has_main_web_app: type: boolean description: True if the bot has a main Web App. web_app_data: type: object description: Data sent from a Web App. additionalProperties: false properties: data: type: string description: The data sent from the Web App. button_text: type: string description: Text of the web_app keyboard button pressed by the user. reply_markup: type: object description: Inline keyboard attached to the message. additionalProperties: false properties: inline_keyboard: type: array description: Rows of inline keyboard buttons. items: type: array description: Single row of inline keyboard buttons. items: type: object description: Inline keyboard button definition. additionalProperties: false properties: text: type: string description: Label text on the button. url: type: string description: HTTP URL opened when the button is pressed. callback_data: type: string description: Data sent in a callback query to the bot when button pressed. web_app: type: object description: Description of the Web App launched when the button is pressed. additionalProperties: false properties: url: type: string description: HTTPS URL of the Web App to open. login_url: type: object description: Login URL for authorization. additionalProperties: false properties: url: type: string description: HTTP URL used for user authorization. forward_text: type: string description: New text of the button in forwarded messages. bot_username: type: string description: Username of a bot for user authorization. request_write_access: type: boolean description: True if the bot may send messages to the user. switch_inline_query: type: string description: Inline query inserted in the input field when the button is pressed. switch_inline_query_current_chat: type: string description: Inline query inserted in the current chat when the button is pressed. switch_inline_query_chosen_chat: type: object description: Inline query switching to a chosen chat. additionalProperties: false properties: query: type: string description: Default inline query to use. allow_user_chats: type: boolean description: True to allow selection of private chats. allow_bot_chats: type: boolean description: True to allow selection of bot chats. allow_group_chats: type: boolean description: True to allow selection of group chats. allow_channel_chats: type: boolean description: True to allow selection of channel chats. callback_game: type: object description: Description of a game launched when the user presses the button. additionalProperties: false properties: {} pay: type: boolean description: True if a Pay button that displays the invoice is pressed. extra: python: source: events/messages/message_edited.py