@skroz/telegram-bot 1.0.29 → 1.1.1

package/src/TelegramTypes.ts

@@ -0,0 +1,1161 @@
+import { FileUpload } from './FileUpload';
+
+/* eslint-disable @typescript-eslint/no-empty-interface */
+/* eslint-disable @typescript-eslint/naming-convention */
+
+export type TG_ParseMode = 'Markdown' | 'MarkdownV2' | 'HTML';
+
+export type TG_MessageEntityType =
+  | 'mention'
+  | 'hashtag'
+  | 'cashtag'
+  | 'bot_command'
+  | 'url'
+  | 'email'
+  | 'phone_number'
+  | 'bold'
+  | 'italic'
+  | 'underline'
+  | 'strikethrough'
+  | 'spoiler'
+  | 'blockquote'
+  | 'code'
+  | 'pre'
+  | 'text_link'
+  | 'text_mention'
+  | 'custom_emoji';
+
+export type TG_ChatType = 'private' | 'group' | 'supergroup' | 'channel';
+
+export type TG_InputMediaType =
+  | 'photo'
+  | 'video'
+  | 'animation'
+  | 'audio'
+  | 'document';
+
+export type TG_PollType = 'regular' | 'quiz';
+
+export type TG_DiceEmoji = '🎲' | '🎯' | '🏀' | '⚽' | '🎳' | '🎰';
+
+export type TG_EncryptedPassportElementType =
+  | 'personal_details'
+  | 'passport'
+  | 'driver_license'
+  | 'identity_card'
+  | 'internal_passport'
+  | 'address'
+  | 'utility_bill'
+  | 'bank_statement'
+  | 'rental_agreement'
+  | 'passport_registration'
+  | 'temporary_registration'
+  | 'phone_number'
+  | 'email';
+
+interface TG_Response {
+  ok: boolean; // Успешность выполнения запроса
+  error_code?: number; // Код ошибки (если запрос завершился неудачей)
+  description?: string; // Описание ошибки (если запрос завершился неудачей)
+}
+
+export interface TG_User {
+  id: number; // Уникальный идентификатор пользователя
+  is_bot: boolean; // Признак того, является ли пользователь ботом
+  first_name: string; // Имя пользователя
+  last_name?: string; // Фамилия пользователя (опционально)
+  username?: string; // Имя пользователя (логин) без "@"
+  language_code?: string; // Код языка (например, "en" или "ru") пользователя
+}
+
+export interface TG_ChatLocation {
+  location: Location; // Геолокация
+  address: string; // Адрес
+}
+
+export interface TG_ChatPhoto {
+  small_file_id: string; // Уникальный идентификатор файла маленькой версии фото профиля
+  small_file_unique_id: string; // Уникальный идентификатор файла маленькой версии фото профиля (для сжатия без потерь)
+  big_file_id: string; // Уникальный идентификатор файла большой версии фото профиля
+  big_file_unique_id: string; // Уникальный идентификатор файла большой версии фото профиля (для сжатия без потерь)
+}
+
+export interface TG_File {
+  file_id: string; // Уникальный идентификатор файла
+  file_unique_id?: string; // Уникальный идентификатор файла вне зависимости от версии бота (опционально)
+  file_size?: number; // Размер файла (опционально)
+  file_path?: string; // Путь к файлу на серверах Telegram (опционально)
+}
+
+export interface TG_ChatPermissions {
+  can_send_messages?: boolean; // Пользователь может отправлять сообщения
+  can_send_media_messages?: boolean; // Пользователь может отправлять сообщения с медиа-контентом (фото, видео, аудио, документы и т. д.)
+  can_send_polls?: boolean; // Пользователь может отправлять опросы
+  can_send_other_messages?: boolean; // Пользователь может отправлять другие типы сообщений (например, игровые, encypted и т. д.)
+  can_add_web_page_previews?: boolean; // Пользователь может добавлять предварительные просмотры веб-страниц в сообщения
+  can_change_info?: boolean; // Пользователь может менять информацию о группе/канале
+  can_invite_users?: boolean; // Пользователь может приглашать новых участников в группу/канал
+  can_pin_messages?: boolean; // Пользователь может закреплять сообщения
+}
+
+/* Подробности ответа для команды getChat - информация о каналах и юзерах */
+export interface TG_Chat {
+  id: number; // Уникальный идентификатор чата
+  type: TG_ChatType; // Тип чата (например, "private", "group", "supergroup", "channel")
+  title?: string; // Название чата (для групп, супергрупп и каналов)
+  username?: string; // Имя пользователя (только для частных чатов)
+  first_name?: string; // Имя пользователя (только для частных чатов)
+  last_name?: string; // Фамилия пользователя (только для частных чатов)
+  photo?: TG_ChatPhoto;
+  description?: string; // Описание чата (только для супергрупп и каналов)
+  invite_link?: string; // Ссылка приглашения в чат (только для супергрупп и каналов)
+  pinned_message?: TG_Message; // Закрепленное сообщение (если есть)
+  permissions?: TG_ChatPermissions; // Права пользователей в чате (только для супергрупп и каналов)
+  slow_mode_delay?: number; // Задержка медленного режима (только для супергрупп)
+  sticker_set_name?: string; // Название набора стикеров (если есть)
+  can_set_sticker_set?: boolean; // Возможность установки набора стикеров (только для супергрупп)
+  linked_chat_id?: number; // ID связанного чата для канала (если есть)
+  location?: TG_ChatLocation; // Геолокация (только для чатов, созданных на основе геолокации)
+}
+
+export interface TG_Location {
+  latitude: number; // Широта, заданная отправителем
+  longitude: number; // Долгота, заданная отправителем
+  horizontal_accuracy?: number; // Радиус неопределённости для местоположения (в метрах, от 0 до 1500)
+  live_period?: number; // Время, в течение которого местоположение может обновляться (в секундах)
+  heading?: number; // Направление движения пользователя (в градусах, от 1 до 360)
+  proximity_alert_radius?: number; // Максимальная дистанция для оповещений о приближении другого члена чата (в метрах)
+}
+
+export interface TG_MessageEntity {
+  type: TG_MessageEntityType; // Тип сущности сообщения
+  offset: number; // Смещение начала сущности в тексте сообщения
+  length: number; // Длина сущности
+  url?: string; // URL связанной сущности (если есть)
+  user?: TG_User; // Пользователь, связанный с сущностью (если есть)
+}
+
+export interface TG_PhotoSize {
+  file_id: string; // Уникальный идентификатор файла фотографии
+  width: number; // Ширина фотографии
+  height: number; // Высота фотографии
+  file_size?: number; // Размер файла фотографии (опционально)
+}
+
+export interface TG_Animation {
+  file_id: string; // Уникальный идентификатор файла анимации
+  width: number; // Ширина анимации
+  height: number; // Высота анимации
+  duration: number; // Продолжительность анимации в секундах
+  thumb?: TG_PhotoSize; // Превью анимации (если доступно)
+  file_name?: string; // Имя файла (если доступно)
+  mime_type?: string; // MIME-тип файла (если доступно)
+  file_size?: number; // Размер файла в байтах (если доступно)
+}
+
+export interface TG_Game {
+  title: string; // Название игры
+  description: string; // Описание игры
+  photo: TG_PhotoSize[]; // Фотографии игры
+  text?: string; // Текст игры
+  text_entities?: TG_MessageEntity[]; // Сущности текста игры
+  animation?: TG_Animation; // Анимация, связанная с игрой
+}
+
+export interface TG_Audio {
+  file_id: string; // Уникальный идентификатор файла аудио
+  duration: number; // Продолжительность аудио в секундах
+  performer?: string; // Исполнитель аудио (опционально)
+  title?: string; // Название аудио (опционально)
+  mime_type?: string; // MIME-тип файла (опционально)
+  file_size?: number; // Размер файла в байтах (опционально)
+}
+
+export interface TG_Document {
+  file_id: string; // Уникальный идентификатор файла документа
+  thumb?: TG_PhotoSize; // Превью документа (если доступно)
+  file_name?: string; // Имя файла (если доступно)
+  mime_type?: string; // MIME-тип файла (если доступно)
+  file_size?: number; // Размер файла в байтах (если доступно)
+}
+
+export interface TG_Sticker {
+  file_id: string; // Уникальный идентификатор файла стикера
+  width: number; // Ширина стикера
+  height: number; // Высота стикера
+  thumb?: TG_PhotoSize; // Превью стикера (если доступно)
+  emoji?: string; // Эмодзи, связанные со стикером (если доступно)
+  file_size?: number; // Размер файла в байтах (если доступно)
+}
+
+export interface TG_Video {
+  file_id: string; // Уникальный идентификатор файла видео
+  width: number; // Ширина видео
+  height: number; // Высота видео
+  duration: number; // Продолжительность видео в секундах
+  thumb?: TG_PhotoSize; // Превью видео (если доступно)
+  mime_type?: string; // MIME-тип файла (если доступно)
+  file_size?: number; // Размер файла в байтах (если доступно)
+}
+
+export interface TG_Voice {
+  file_id: string; // Уникальный идентификатор файла голосового сообщения
+  duration: number; // Продолжительность голосового сообщения в секундах
+  mime_type?: string; // MIME-тип файла (если доступно)
+  file_size?: number; // Размер файла в байтах (если доступно)
+}
+
+export interface TG_VideoNote {
+  file_id: string; // Уникальный идентификатор файла видеозаметки
+  length: number; // Длительность видеозаметки в секундах
+  duration: number; // Продолжительность видеозаметки в секундах
+  thumb?: TG_PhotoSize; // Превью видеозаметки (если доступно)
+  file_size?: number; // Размер файла в байтах (если доступно)
+}
+
+export interface TG_Contact {
+  phone_number: string; // Номер телефона контакта
+  first_name: string; // Имя контакта
+  last_name?: string; // Фамилия контакта (опционально)
+  user_id?: number; // Уникальный идентификатор пользователя контакта (опционально)
+  vcard?: string; // vCard контакта (опционально)
+}
+
+export interface TG_Venue {
+  location: TG_Location; // Местоположение места проведения
+  title: string; // Название места проведения
+  address: string; // Адрес места проведения
+  foursquare_id?: string; // Уникальный идентификатор места проведения в Foursquare (опционально)
+  foursquare_type?: string; // Тип места проведения в Foursquare (опционально)
+}
+
+export interface TG_PollOption {
+  text: string; // Текст варианта ответа на опрос
+  voter_count: number; // Количество пользователей, выбравших этот вариант ответа
+}
+
+export interface TG_Poll {
+  id: string; // Уникальный идентификатор опроса
+  question: string; // Вопрос опроса
+  options: TG_PollOption[]; // Варианты ответов на опрос
+  is_closed: boolean; // Флаг, указывающий, закрыт ли опрос
+  is_anonymous: boolean; // Флаг, указывающий, анонимный ли опрос
+  type?: TG_PollType; // Тип опроса (опционально)
+  allows_multiple_answers?: boolean; // Разрешено ли выбирать несколько вариантов ответов (опционально)
+  correct_option_id?: number; // Идентификатор правильного варианта ответа (опционально)
+  explanation?: string; // Пояснение к правильному варианту ответа (опционально)
+  explanation_entities?: TG_MessageEntity[]; // Сущности текста пояснения (опционально)
+  open_period?: number; // Время (в секундах), в течение которого опрос будет активен (опционально)
+  close_date?: number; // Таймстэмп закрытия опроса (опционально)
+}
+
+export interface TG_PollAnswer {
+  poll_id: string; // Уникальный идентификатор опроса
+  user: TG_User; // Пользователь, который ответил на опрос
+  option_ids: number[]; // Идентификаторы выбранных пользователем вариантов ответа
+}
+
+export interface TG_Dice {
+  emoji: TG_DiceEmoji; // Эмодзи, связанное с кубиком
+  value: number; // Значение кубика (1-6 для "🎲", 1-5 для "🎯")
+}
+
+export interface TG_Invoice {
+  title: string; // Название товара
+  description: string; // Описание товара
+  start_parameter: string; // Уникальный параметр начала платежа
+  currency: string; // Валюта счета (например, "USD", "RUB", "EUR", и т. д.)
+  total_amount: number; // Общая сумма платежа в копейках
+}
+
+// Тип MessageOriginUser
+export interface TG_MessageOriginUser {
+  type: 'user'; // Тип источника сообщения, всегда "user"
+  date: number; // Дата отправки сообщения изначально в формате Unix time
+  sender_user: TG_User; // Пользователь, который отправил сообщение изначально
+}
+
+// Тип MessageOriginHiddenUser
+export interface TG_MessageOriginHiddenUser {
+  type: 'hidden_user'; // Тип источника сообщения, всегда "hidden_user"
+  date: number; // Дата отправки сообщения изначально в формате Unix time
+  sender_user_name: string; // Имя пользователя, который отправил сообщение изначально
+}
+
+// Тип MessageOriginChat
+export interface TG_MessageOriginChat {
+  type: 'chat'; // Тип источника сообщения, всегда "chat"
+  date: number; // Дата отправки сообщения изначально в формате Unix time
+  sender_chat: TG_Chat; // Чат, который отправил сообщение изначально
+  author_signature?: string; // Для сообщений, отправленных изначально анонимным администратором чата, подпись оригинального автора сообщения
+}
+
+// Тип MessageOriginChannel
+export interface TG_MessageOriginChannel {
+  type: 'channel'; // Тип источника сообщения, всегда "channel"
+  date: number; // Дата отправки сообщения изначально в формате Unix time
+  chat: TG_Chat; // Чат канала, в который изначально было отправлено сообщение
+  message_id: number; // Уникальный идентификатор сообщения внутри чата
+  author_signature?: string; // Подпись оригинального автора сообщения
+}
+
+export interface TG_Story {
+  chat: TG_Chat; // Чат, который опубликовал историю
+  id: number; // Уникальный идентификатор истории в чате
+}
+
+export interface TG_Giveaway {
+  chats: TG_Chat[]; // Список чатов, которым пользователь должен присоединиться для участия в розыгрыше
+  winners_selection_date: number; // Момент времени (в формате Unix timestamp), когда будут выбраны победители розыгрыша
+  winner_count: number; // Количество пользователей, которые должны быть выбраны победителями розыгрыша
+  only_new_members?: boolean; // true, если только пользователи, которые присоединились к чатам после начала розыгрыша, могут быть признаны победителями
+  has_public_winners?: boolean; // true, если список победителей розыгрыша будет виден всем
+  prize_description?: string; // Описание дополнительного приза розыгрыша
+  country_codes?: string[]; // Список двухбуквенных кодов стран ISO 3166-1 alpha-2, указывающих страны, из которых должны происходить участники розыгрыша
+  premium_subscription_month_count?: number; // Количество месяцев, на которое будет активна подписка Telegram Premium, выигранная в розыгрыше
+}
+
+export interface TG_GiveawayWinners {
+  chat: TG_Chat; // Чат, который создал розыгрыш
+  giveaway_message_id: number; // Идентификатор сообщения с розыгрышем в чате
+  winners_selection_date: number; // Момент времени (в формате Unix timestamp), когда были выбраны победители розыгрыша
+  winner_count: number; // Общее количество победителей в розыгрыше
+  winners: TG_User[]; // Список до 100 победителей розыгрыша
+  additional_chat_count?: number; // Количество других чатов, в которые пользователь должен был присоединиться, чтобы быть признанным участником розыгрыша
+  premium_subscription_month_count?: number; // Количество месяцев, на которое будет активна подписка Telegram Premium, выигранная в розыгрыше
+  unclaimed_prize_count?: number; // Количество нераспределенных призов
+  only_new_members?: boolean; // true, если только пользователи, присоединившиеся к чатам после начала розыгрыша, были признаны победителями
+  was_refunded?: boolean; // true, если розыгрыш был отменен из-за возврата платежа за него
+  prize_description?: string; // Описание дополнительного приза розыгрыша
+}
+
+export interface TG_GiveawayCompleted {
+  winner_count: number; // Количество победителей в розыгрыше
+  unclaimed_prize_count?: number; // Количество нераспределенных призов
+  giveaway_message?: TG_Message; // Сообщение с розыгрышем, который завершился, если его не удалили
+}
+
+export interface TG_ExternalReplyInfo {
+  origin: TG_MessageOrigin; // Происхождение ответного сообщения
+  chat?: TG_Chat; // Чат, к которому относится исходное сообщение. Доступно только если чат является супергруппой или каналом.
+  message_id?: number; // Уникальный идентификатор сообщения внутри исходного чата. Доступно только если исходный чат является супергруппой или каналом.
+  link_preview_options?: TG_LinkPreviewOptions; // Опции, используемые для предварительного просмотра ссылки для исходного сообщения, если оно является текстовым сообщением
+  animation?: TG_Animation; // Анимация в ответе на сообщение, информация об анимации
+  audio?: TG_Audio; // Аудиофайл в ответе на сообщение, информация о файле
+  document?: Document; // Общий файл в ответе на сообщение, информация о файле
+  photo?: TG_PhotoSize[]; // Фотография в ответе на сообщение, доступные размеры фотографии
+  sticker?: TG_Sticker; // Стикер в ответе на сообщение, информация о стикере
+  story?: TG_Story; // Пересылаемая история в ответе на сообщение
+  video?: TG_Video; // Видео в ответе на сообщение, информация о видео
+  video_note?: TG_VideoNote; // Видеосообщение в ответе на сообщение, информация о видеосообщении
+  voice?: TG_Voice; // Голосовое сообщение в ответе на сообщение, информация о файле
+  has_media_spoiler?: boolean; // True, если медиаконтент сообщения скрыт анимацией спойлера
+  contact?: TG_Contact; // Общая контактная информация в ответе на сообщение, информация о контакте
+  dice?: TG_Dice; // Кубик в ответе на сообщение с случайным значением
+  game?: TG_Game; // Игра в ответе на сообщение, информация об игре
+  giveaway?: TG_Giveaway; // Запланированный розыгрыш в ответе на сообщение, информация о розыгрыше
+  giveaway_winners?: TG_GiveawayWinners; // Розыгрыш с публичными победителями завершен
+  invoice?: TG_Invoice; // Счет на оплату в ответе на сообщение, информация о счете
+  location?: TG_Location; // Общее местоположение в ответе на сообщение, информация о местоположении
+  poll?: TG_Poll; // Опрос в ответе на сообщение, информация о опросе
+  venue?: TG_Venue; // Место в ответе на сообщение, информация о месте
+}
+
+export interface TG_TextQuote {
+  text: string; // Текст цитируемой части сообщения, на которое отвечает данный сообщение
+  entities?: TG_MessageEntity[]; // Специальные сущности, которые присутствуют в цитате. В настоящее время в цитатах сохраняются только жирный, курсив, подчеркивание, зачеркивание, спойлер и пользовательские смайлы.
+  position: number; // Приблизительная позиция цитаты в исходном сообщении в кодовых единицах UTF-16, указанных отправителем
+  is_manual?: boolean; // true, если цитата была выбрана вручную отправителем сообщения. В противном случае цитата была добавлена автоматически сервером.
+}
+
+// Общий тип для всех источников сообщений
+type TG_MessageOrigin =
+  | TG_MessageOriginUser
+  | TG_MessageOriginHiddenUser
+  | TG_MessageOriginChat
+  | TG_MessageOriginChannel;
+
+// Этот тип описывает сообщение, которое было удалено или иным образом недоступно боту.
+export interface TG_InaccessibleMessage {
+  chat: TG_Chat; // Чат, к которому принадлежало сообщение
+  message_id: number; // Уникальный идентификатор сообщения внутри чата
+  date: 0; // Всегда 0. Поле можно использовать для различения обычных и недоступных сообщений.
+}
+
+// Этот тип описывает сообщение, к которому бот может не иметь доступа.
+// Это может быть один из следующих вариантов:
+type TG_MaybeInaccessibleMessage = TG_Message | TG_InaccessibleMessage;
+
+// Этот объект содержит основную информацию о успешной оплате.
+export interface TG_SuccessfulPayment {
+  currency: string; // Трехбуквенный код валюты ISO 4217
+  total_amount: number; // Общая сумма в наименьших единицах валюты (целое число, не float/double). Например, для цены 1,45 доллара США передается amount = 145. Смотрите параметр exp в currencies.json, он показывает количество цифр после десятичной точки для каждой валюты (2 для большинства валют).
+  invoice_payload: string; // Полезная нагрузка счета, указанная ботом
+  shipping_option_id?: string; // Идентификатор выбранного пользователем варианта доставки (необязательно)
+  order_info?: TG_OrderInfo; // Информация о заказе, предоставленная пользователем (необязательно)
+  telegram_payment_charge_id: string; // Идентификатор оплаты Telegram
+  provider_payment_charge_id: string; // Идентификатор оплаты провайдера
+}
+
+// Этот объект содержит информацию о пользователе, который был передан боту с помощью кнопки KeyboardButtonRequestUser.
+export interface TG_SharedUser {
+  user_id: number; // Идентификатор переданного пользователя
+  first_name?: string; // Имя пользователя, если его запрашивал бот (необязательно)
+  last_name?: string; // Фамилия пользователя, если его запрашивал бот (необязательно)
+  username?: string; // Имя пользователя, если его запрашивал бот (необязательно)
+  photo?: TG_PhotoSize[]; // Доступные размеры фотографии чата, если фотография была запрошена ботом (необязательно)
+}
+
+// Этот объект содержит информацию о пользователях, чьи идентификаторы были переданы боту с помощью кнопки KeyboardButtonRequestUsers.
+export interface TG_UsersShared {
+  request_id: number; // Идентификатор запроса
+  users: TG_SharedUser[]; // Информация о пользователях, переданных боту
+}
+
+// Этот объект содержит информацию о чате, который был передан боту с помощью кнопки KeyboardButtonRequestChat.
+export interface TG_ChatShared {
+  request_id: number; // Идентификатор запроса
+  chat_id: number; // Идентификатор переданного чата
+  title?: string; // Название чата, если название было запрошено ботом (необязательно)
+  username?: string; // Имя пользователя чата, если оно было запрошено ботом и доступно (необязательно)
+  photo?: TG_PhotoSize[]; // Доступные размеры фотографии чата, если фотография была запрошена ботом (необязательно)
+}
+
+// Этот объект представляет собой сервисное сообщение о пользователе, разрешившем боту отправлять сообщения после добавления его в меню вложений, запуска веб-приложения по ссылке или принятия явного запроса от веб-приложения, отправленного методом requestWriteAccess.
+export interface TG_WriteAccessAllowed {
+  from_request?: boolean; // true, если доступ был предоставлен после того, как пользователь принял явный запрос от веб-приложения, отправленного методом requestWriteAccess (необязательно)
+  web_app_name?: string; // Название веб-приложения, если доступ был предоставлен при запуске веб-приложения по ссылке (необязательно)
+  from_attachment_menu?: boolean; // true, если доступ был предоставлен, когда бот был добавлен в меню вложений или боковое меню (необязательно)
+}
+
+// Описывает данные Telegram Passport, которые были переданы пользователем боту.
+export interface TG_PassportData {
+  data: TG_EncryptedPassportElement[]; // Массив с информацией о документах и других элементах Telegram Passport, которые были переданы боту
+  credentials: TG_EncryptedCredentials; // Зашифрованные учетные данные, необходимые для расшифровки данных
+}
+
+// Представляет файл, загруженный в Telegram Passport. В настоящее время все файлы Telegram Passport в формате JPEG после расшифровки и не превышают 10 МБ.
+export interface TG_PassportFile {
+  file_id: string; // Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла
+  file_unique_id: string; // Уникальный идентификатор этого файла, который должен оставаться постоянным во времени и для разных ботов. Не может быть использован для загрузки или повторного использования файла.
+  file_size: number; // Размер файла в байтах
+  file_date: number; // Время в формате Unix, когда файл был загружен
+}
+
+// Описывает документы или другие элементы Telegram Passport, переданные пользователем боту.
+export interface TG_EncryptedPassportElement {
+  type: TG_EncryptedPassportElementType; // Тип элемента. Один из “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration”, “phone_number”, “email”.
+  data?: string; // Закодированные в Base64 зашифрованные данные элемента Telegram Passport, предоставленные пользователем; доступны только для типов “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” и “address”.
+  phone_number?: string; // Верифицированный номер телефона пользователя; доступен только для типа “phone_number”
+  email?: string; // Верифицированный адрес электронной почты пользователя; доступен только для типа “email”
+  files?: TG_PassportFile[]; // Массив зашифрованных файлов с документами, предоставленными пользователем; доступен только для типов “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” и “temporary_registration”.
+  front_side?: TG_PassportFile; // Зашифрованный файл с передней стороной документа, предоставленного пользователем; доступен только для типов “passport”, “driver_license”, “identity_card” и “internal_passport”.
+  reverse_side?: TG_PassportFile; // Зашифрованный файл с обратной стороной документа, предоставленного пользователем; доступен только для типов “driver_license” и “identity_card”.
+  selfie?: TG_PassportFile; // Зашифрованный файл с селфи пользователя, держащего документ, предоставленный пользователем; доступен при запросе для типов “passport”, “driver_license”, “identity_card” и “internal_passport”.
+  translation?: TG_PassportFile[]; // Массив зашифрованных файлов с переведенными версиями документов, предоставленных пользователем; доступен при запросе для типов “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” и “temporary_registration”.
+  hash: string; // Хэш элемента для использования в PassportElementErrorUnspecified
+}
+
+// Этот объект представляет содержимое служебного сообщения, отправленного всякий раз, когда пользователь в чате вызывает срабатывание оповещения о близости, установленного другим пользователем.
+export interface TG_ProximityAlertTriggered {
+  traveler: TG_User; // Пользователь, вызвавший оповещение
+  watcher: TG_User; // Пользователь, установивший оповещение
+  distance: number; // Расстояние между пользователями
+}
+
+// Этот объект представляет служебное сообщение об изменении настроек автоматического удаления сообщений.
+export interface TG_MessageAutoDeleteTimerChanged {
+  message_auto_delete_time: number; // Новое время автоматического удаления сообщений в чате; в секундах
+}
+
+// Этот объект представляет служебное сообщение о том, что пользователь усилил чат.
+export interface TG_ChatBoostAdded {
+  boost_count: number; // Количество усилений, добавленных пользователем
+}
+
+// Этот объект представляет служебное сообщение о создании новой темы форума в чате.
+export interface TG_ForumTopicCreated {
+  name: string; // Название темы
+  icon_color: number; // Цвет иконки темы в формате RGB
+  icon_custom_emoji_id?: string; // Уникальный идентификатор пользовательского смайлика, показываемого как иконка темы
+}
+
+// Этот объект представляет служебное сообщение о закрытии форумной темы в чате. В настоящее время не содержит информации.
+export interface TG_ForumTopicClosed {}
+
+// Этот объект представляет служебное сообщение об отредактированной форумной теме.
+export interface TG_ForumTopicEdited {
+  name?: string; // Новое название темы, если оно было отредактировано
+  icon_custom_emoji_id?: string; // Новый идентификатор пользовательского смайлика, показываемого как иконка темы, если он был отредактирован; пустая строка, если иконка была удалена
+}
+
+// Этот объект представляет служебное сообщение о повторном открытии форумной темы в чате. В настоящее время не содержит информации.
+export interface TG_ForumTopicReopened {}
+
+// Этот объект представляет служебное сообщение о скрытии форумной темы "Общее" в чате. В настоящее время не содержит информации.
+export interface TG_GeneralForumTopicHidden {}
+
+// Этот объект представляет служебное сообщение об открытии форумной темы "Общее" в чате. В настоящее время не содержит информации.
+export interface TG_GeneralForumTopicUnhidden {}
+
+// Описывает зашифрованные учетные данные, необходимые для дешифровки и аутентификации EncryptedPassportElement. См. Документацию Telegram Passport для полного описания процессов дешифровки и аутентификации данных.
+export interface TG_EncryptedCredentials {
+  data: string; // Зашифрованные в Base64 JSON-сериализованные данные с уникальной полезной нагрузкой пользователя, хэшами данных и секретами, необходимыми для дешифровки и аутентификации EncryptedPassportElement
+  hash: string; // Хэш данных в кодировке Base64 для аутентификации данных
+  secret: string; // Секрет в кодировке Base64, зашифрованный с использованием открытого ключа RSA бота, необходимый для дешифровки данных
+}
+
+// Этот объект представляет служебное сообщение о создании запланированного розыгрыша призов. В настоящее время не содержит информации.
+export interface TG_GiveawayCreated {}
+
+// Этот объект представляет служебное сообщение о запланированном видеочате в чате.
+export interface TG_VideoChatScheduled {
+  start_date: number; // Момент времени (в формате Unix timestamp), когда видеочат должен быть запущен администратором чата
+}
+
+// Этот объект представляет служебное сообщение о начале видеочата в чате. В настоящее время не содержит информации.
+export interface TG_VideoChatStarted {}
+
+// Этот объект представляет служебное сообщение о завершении видеочата в чате.
+export interface TG_VideoChatEnded {
+  duration: number; // Длительность видеочата в секундах
+}
+
+// Этот объект представляет служебное сообщение о новых участниках, приглашенных на видеочат.
+export interface TG_VideoChatParticipantsInvited {
+  users: TG_User[]; // Новые участники, которые были приглашены на видеочат
+}
+
+// Этот объект описывает данные, отправленные из веб-приложения боту.
+export interface TG_WebAppData {
+  data: string; // Данные. Обратите внимание, что плохой клиент может отправлять произвольные данные в этом поле.
+  button_text?: string; // Текст кнопки веб-приложения, из которой было открыто веб-приложение. Обратите внимание, что плохой клиент может отправлять произвольные данные в этом поле.
+}
+
+export interface TG_Message {
+  message_id: number; // Уникальный идентификатор сообщения внутри этого чата
+  message_thread_id?: number; // Уникальный идентификатор темы сообщения, к которой принадлежит сообщение; только для супергрупп
+  from?: TG_User; // Отправитель сообщения; пусто для сообщений, отправленных в каналы
+  sender_chat?: TG_Chat; // Отправитель сообщения, отправленный от имени чата. Например, сам канал для сообщений из канала, сама супергруппа для сообщений от анонимных администраторов группы, связанный канал для сообщений, автоматически пересылаемых в группу обсуждения
+  sender_boost_count?: number; // Если отправитель сообщения усилил чат, количество усилений, добавленных пользователем
+  sender_business_bot?: TG_User; // Бот, который фактически отправил сообщение от имени бизнес-аккаунта. Доступно только для исходящих сообщений, отправленных от имени связанного бизнес-аккаунта.
+  date: number; // Дата отправки сообщения в формате Unix time. Всегда положительное число, представляющее действительную дату.
+  business_connection_id?: string; // Уникальный идентификатор бизнес-соединения, из которого было получено сообщение. Если он не пуст, сообщение принадлежит чату соответствующего бизнес-аккаунта, который независим от любого потенциального чата бота, который может иметь тот же идентификатор.
+  chat: TG_Chat; // Чат, к которому принадлежит сообщение
+  forward_origin?: TG_MessageOrigin; // Информация об оригинальном сообщении для пересланных сообщений
+  is_topic_message?: boolean; // true, если сообщение отправлено в тему форума
+  is_automatic_forward?: boolean; // true, если сообщение - это сообщение канала, которое было автоматически переслано в связанную группу обсуждения
+  reply_to_message?: TG_Message; // Для ответов в том же чате и теме сообщения - исходное сообщение
+  external_reply?: TG_ExternalReplyInfo; // Информация о сообщении, на которое отвечается, которая может прийти из другого чата или темы форума
+  quote?: TG_TextQuote; // Для ответов, которые цитируют часть исходного сообщения, процитированная часть сообщения
+  reply_to_story?: TG_Story; // Для ответов на историю, исходная история
+  via_bot?: TG_User; // Бот, через который было отправлено сообщение
+  edit_date?: number; // Дата последнего редактирования сообщения в формате Unix time
+  has_protected_content?: boolean; // true, если сообщение не может быть переслано
+  is_from_offline?: boolean; // true, если сообщение было отправлено неявным действием, например, как отсутствующее или приветственное бизнес-сообщение или как запланированное сообщение
+  media_group_id?: string; // Уникальный идентификатор группы медиа-сообщений, к которой принадлежит это сообщение
+  author_signature?: string; // Подпись автора сообщения для сообщений в каналах или пользовательский заголовок анонимного администратора группы
+  text?: string; // Для текстовых сообщений - фактический текст сообщения в кодировке UTF-8
+  entities?: TG_MessageEntity[]; // Для текстовых сообщений - специальные сущности, такие как имена пользователей, URL, команды ботов и т. д., которые появляются в тексте
+  link_preview_options?: TG_LinkPreviewOptions; // Опции, используемые для генерации предпросмотра ссылок для сообщения, если оно является текстовым сообщением и опции предпросмотра ссылок были изменены
+  animation?: TG_Animation; // Сообщение - это анимация, информация о анимации. Для совместимости, когда это поле установлено, также будет установлено поле документа
+  audio?: TG_Audio; // Сообщение - это аудиофайл, информация о файле
+  document?: TG_Document; // Сообщение - это общий файл, информация о файле
+  photo?: TG_PhotoSize[]; // Сообщение - это фотография, доступные размеры фотографии
+  sticker?: TG_Sticker; // Сообщение - это стикер, информация о стикере
+  story?: TG_Story; // Сообщение - это пересланная история
+  video?: TG_Video; // Сообщение - это видео, информация о видео
+  video_note?: TG_VideoNote; // Сообщение - это видео-заметка, информация о видео-сообщении
+  voice?: TG_Voice; // Сообщение - это голосовое сообщение, информация о файле
+  caption?: string; // Подпись к анимации, аудио, документу, фото, видео или голосу
+  caption_entities?: TG_MessageEntity[]; // Для сообщений с подписью - специальные сущности, такие как имена пользователей, URL, команды ботов и т. д., которые появляются в подписи
+  has_media_spoiler?: boolean; // true, если медиа-сообщение покрыто анимацией-спойлером
+  contact?: TG_Contact; // Сообщение - это общий контакт, информация о контакте
+  dice?: TG_Dice; // Сообщение - это кубик с случайным значением
+  game?: TG_Game; // Сообщение - это игра, информация о игре
+  poll?: TG_Poll; // Сообщение - это опрос, информация о опросе
+  venue?: TG_Venue; // Сообщение - это место, информация о месте
+  location?: TG_Location; // Сообщение - это общее местоположение, информация о местоположении
+  new_chat_members?: TG_User[]; // Новые участники, добавленные в группу или супергруппу, и информация о них (бот сам может быть одним из этих участников)
+  left_chat_member?: TG_User; // Участник был удален из группы, информация о нем (этот участник может быть самим ботом)
+  new_chat_title?: string; // Заголовок чата был изменен на это значение
+  new_chat_photo?: TG_PhotoSize[]; // Фото чата было изменено на это значение
+  delete_chat_photo?: boolean; // Сервисное сообщение: фото чата было удалено
+  group_chat_created?: boolean; // Сервисное сообщение: группа создана
+  supergroup_chat_created?: boolean; // Сервисное сообщение: супергруппа создана
+  channel_chat_created?: boolean; // Сервисное сообщение: канал создан
+  message_auto_delete_timer_changed?: TG_MessageAutoDeleteTimerChanged; // Сервисное сообщение: настройки автоудаления сообщений изменились в чате
+  migrate_to_chat_id?: number; // Группа была перенесена в супергруппу с указанным идентификатором
+  migrate_from_chat_id?: number; // Супергруппа была перенесена из группы с указанным идентификатором
+  pinned_message?: TG_MaybeInaccessibleMessage; // Указанное сообщение закреплено. Обратите внимание, что объект Message в этом поле не будет содержать дополнительных полей reply_to_message, даже если само является ответом.
+  invoice?: TG_Invoice; // Сообщение - это счет на оплату, информация о счете
+  successful_payment?: TG_SuccessfulPayment; // Сообщение - это сервисное сообщение об успешной оплате, информация об оплате
+  users_shared?: TG_UsersShared; // Сервисное сообщение: пользователи были переданы боту
+  chat_shared?: TG_ChatShared; // Сервисное сообщение: чат был передан боту
+  connected_website?: string; // Доменное имя веб-сайта, на котором пользователь вошел в систему. Подробнее о входе в систему Telegram
+  write_access_allowed?: TG_WriteAccessAllowed; // Сервисное сообщение: пользователь разрешил боту отправлять сообщения после добавления его в приложение или боковое меню, запуская веб-приложение по ссылке или принимая явный запрос из веб-приложения, отправленный методом requestWriteAccess
+  passport_data?: TG_PassportData; // Данные Telegram Passport
+  proximity_alert_triggered?: TG_ProximityAlertTriggered; // Сервисное сообщение. Пользователь в чате вызвал предупреждение о приближении другого пользователя, пока делился местоположением в реальном времени.
+  boost_added?: TG_ChatBoostAdded; // Сервисное сообщение: пользователь усилил чат
+  forum_topic_created?: TG_ForumTopicCreated; // Сервисное сообщение: создана тема форума
+  forum_topic_edited?: TG_ForumTopicEdited; // Сервисное сообщение: тема форума изменена
+  forum_topic_closed?: TG_ForumTopicClosed; // Сервисное сообщение: тема форума закрыта
+  forum_topic_reopened?: TG_ForumTopicReopened; // Сервисное сообщение: тема форума снова открыта
+  general_forum_topic_hidden?: TG_GeneralForumTopicHidden; // Сервисное сообщение: тема форума "Общее" скрыта
+  general_forum_topic_unhidden?: TG_GeneralForumTopicUnhidden; // Сервисное сообщение: тема форума "Общее" снова открыта
+  giveaway_created?: TG_GiveawayCreated; // Сервисное сообщение: создана запланированная розыгрыш
+  giveaway?: TG_Giveaway; // Сообщение - это сообщение запланированного розыгрыша
+  giveaway_winners?: TG_GiveawayWinners; // Завершен розыгрыш с публичными победителями
+  giveaway_completed?: TG_GiveawayCompleted; // Сервисное сообщение: розыгрыш без публичных победителей завершен
+  video_chat_scheduled?: TG_VideoChatScheduled; // Сервисное сообщение: запланирован видеочат
+  video_chat_started?: TG_VideoChatStarted; // Сервисное сообщение: видеочат начат
+  video_chat_ended?: TG_VideoChatEnded; // Сервисное сообщение: видеочат завершен
+  video_chat_participants_invited?: TG_VideoChatParticipantsInvited; // Сервисное сообщение: новые участники приглашены на видеочат
+  web_app_data?: TG_WebAppData; // Сервисное сообщение: данные, отправленные веб-приложением
+  reply_markup?: TG_InlineKeyboardMarkup; // Встроенная клавиатура, прикрепленная к сообщению. Кнопки login_url представлены как обычные url-кнопки.
+}
+
+export interface TG_InlineQuery {
+  id: string; // Уникальный идентификатор встроенного запроса
+  from: TG_User; // Отправитель запроса
+  query: string; // Текст запроса
+  offset: string; // Смещение результатов
+  location?: TG_Location; // Местоположение отправителя (опционально)
+}
+
+export interface TG_ChosenInlineResult {
+  result_id: string; // Уникальный идентификатор выбранного результата
+  from: TG_User; // Пользователь, который выбрал результат
+  query: string; // Текст запроса
+  inline_message_id?: string; // Идентификатор встроенного сообщения (опционально)
+  location?: TG_Location; // Местоположение отправителя (опционально)
+  inline_message_text?: string; // Текст встроенного сообщения (опционально)
+}
+
+export interface TG_CallbackQuery {
+  id: string; // Уникальный идентификатор callback-запроса
+  from: TG_User; // Отправитель запроса
+  message?: TG_Message; // Сообщение, связанное с callback-запросом
+  inline_message_id?: string; // Идентификатор встроенного сообщения (если запрос отправлен из встроенного сообщения)
+  chat_instance: string; // Уникальный идентификатор чата, к которому относится callback-запрос
+  data?: string; // Данные, связанные с callback-запросом (если есть)
+  game_short_name?: string; // Краткое название игры, связанной с callback-запросом (если есть)
+}
+
+export interface TG_ShippingAddress {
+  country_code: string; // Код страны (ISO 3166-1 alpha-2)
+  state: string; // Полное название региона/штата
+  city: string; // Город
+  street_line1: string; // Первая строка адреса
+  street_line2: string; // Вторая строка адреса
+  post_code: string; // Почтовый индекс
+}
+
+export interface TG_ShippingQuery {
+  id: string; // Уникальный идентификатор запроса на доставку
+  from: TG_User; // Отправитель запроса
+  invoice_payload: string; // Полезная нагрузка счета
+  shipping_address: TG_ShippingAddress; // Адрес доставки
+}
+
+export interface TG_OrderInfo {
+  name?: string; // Имя пользователя
+  phone_number?: string; // Номер телефона пользователя
+  email?: string; // Адрес электронной почты пользователя
+  shipping_address?: TG_ShippingAddress; // Адрес доставки заказа
+}
+
+export interface TG_PreCheckoutQuery {
+  id: string; // Уникальный идентификатор предварительного запроса на оформление заказа
+  from: TG_User; // Отправитель запроса
+  currency: string; // Валюта заказа (например, "USD", "RUB", "EUR", и т. д.)
+  total_amount: number; // Общая сумма заказа в минимальных единицах валюты
+  invoice_payload: string; // Полезная нагрузка счета
+  shipping_option_id?: string; // Идентификатор выбранного варианта доставки (если есть)
+  order_info?: TG_OrderInfo; // Информация о заказе (если есть)
+}
+
+export interface TG_Update {
+  update_id: number; // Уникальный идентификатор обновления
+  message?: TG_Message; // Сообщение, связанное с обновлением
+  edited_message?: TG_Message; // Отредактированное сообщение, связанное с обновлением
+  channel_post?: TG_Message; // Сообщение канала, связанное с обновлением
+  edited_channel_post?: TG_Message; // Отредактированное сообщение канала, связанное с обновлением
+  inline_query?: TG_InlineQuery; // Встроенный запрос, связанный с обновлением
+  chosen_inline_result?: TG_ChosenInlineResult; // Выбранный результат встроенного запроса, связанный с обновлением
+  callback_query?: TG_CallbackQuery; // Callback-запрос, связанный с обновлением
+  shipping_query?: TG_ShippingQuery; // Запрос на доставку, связанный с обновлением
+  pre_checkout_query?: TG_PreCheckoutQuery; // Предварительный запрос на оформление заказа, связанный с обновлением
+  poll?: TG_Poll; // Опрос, связанный с обновлением
+  poll_answer?: TG_PollAnswer; // Ответ на опрос, связанный с обновлением
+}
+
+/* Ответ для команды getChat - информация о каналах и юзерах */
+export interface TG_ChatResponse extends TG_Response {
+  // ok: boolean; // Успешность выполнения запроса
+  result?: TG_Chat; // Информация о чате (если запрос успешен)
+  // error_code?: number; // Код ошибки (если запрос завершился неудачей)
+  // description?: string; // Описание ошибки (если запрос завершился неудачей)
+}
+
+/* Команда для телеграм бота, которая отображается в меню */
+export interface TG_BotCommand {
+  command: string; // Команда бота
+  description: string | null; // Описание команды
+}
+
+/* ответ от телеграма при установке команд */
+export interface TG_SetMyCommandsResponse extends TG_Response {
+  // ok: boolean; // Успешность выполнения запроса
+  result?: boolean; // Результат установки команд (true, если успешно)
+  // error_code?: number; // Код ошибки (если запрос завершился неудачей)
+  // description?: string; // Описание ошибки (если запрос завершился неудачей)
+}
+
+export interface TG_GetMeResponse extends TG_Response {
+  // ok: boolean; // Успешность выполнения запроса
+  result?: TG_User; // Информация о пользователе (если запрос успешен)
+  // error_code?: number; // Код ошибки (если запрос завершился неудачей)
+  // description?: string; // Описание ошибки (если запрос завершился неудачей)
+}
+
+export interface TG_SendMessageResponse extends TG_Response {
+  // ok: boolean;
+  result?: TG_Message; // Сообщение в случае успешной отправки
+  // error_code?: number; // Код ошибки в случае неудачи
+  // description?: string; // Описание ошибки в случае неудачи
+}
+/*
+export interface TG_EditMessageTextResponse {
+  ok: boolean;
+  result?: any;
+  description?: string;
+} */
+
+export interface TG_GetUpdatesResponse extends TG_Response {
+  // ok: boolean; // Флаг, указывающий на успешность выполнения команды
+  result?: TG_Update[]; // Массив обновлений в случае успешного ответа
+  // error_code?: number; // Код ошибки в случае неудачи
+  // description?: string; // Описание ошибки в случае неудачи
+}
+
+export interface TG_GetFileResponse extends TG_Response {
+  // ok: boolean;
+  result?: TG_File;
+  // error_code?: number;
+  // description?: string;
+}
+
+export interface TG_InputMediaAudio {
+  type: 'audio'; // Тип результата, должен быть audio
+  media: string; // Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram, или HTTP URL для получения файла Telegram из Интернета, или передайте "attach://<file_attach_name>", чтобы загрузить новый файл с использованием multipart/form-data под именем <file_attach_name>. Больше информации о передаче файлов
+  thumbnail?: FileUpload | string; // Обложка отправленного файла; может быть проигнорирована, если генерация обложки для файла поддерживается на стороне сервера. Обложка должна быть в формате JPEG и размером менее 200 кб. Ширина и высота обложки не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart/form-data. Обложки нельзя использовать повторно и могут быть загружены только как новый файл, поэтому вы можете передать "attach://<file_attach_name>", если обложка была загружена с использованием multipart/form-data под именем <file_attach_name>
+  caption?: string; // Подпись к аудио для отправки, 0-1024 символа после обработки сущностей
+  parse_mode?: TG_ParseMode; // Режим разбора сущностей в подписи аудио. См. варианты форматирования для более подробной информации.
+  caption_entities?: TG_MessageEntity[]; // Список специальных сущностей, которые появляются в подписи, которые можно указать вместо parse_mode
+  duration?: number; // Длительность аудио в секундах
+  performer?: string; // Исполнитель аудио
+  title?: string; // Название аудио
+}
+
+export interface TG_InputMediaDocument {
+  type: 'document'; // Тип результата, должен быть document
+  media: string; // Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram, или HTTP URL для получения файла Telegram из Интернета, или передайте "attach://<file_attach_name>", чтобы загрузить новый файл с использованием multipart/form-data под именем <file_attach_name>. Больше информации о передаче файлов
+  thumbnail?: FileUpload | string; // Обложка отправленного файла; может быть проигнорирована, если генерация обложки для файла поддерживается на стороне сервера. Обложка должна быть в формате JPEG и размером менее 200 кб. Ширина и высота обложки не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart/form-data. Обложки нельзя использовать повторно и могут быть загружены только как новый файл, поэтому вы можете передать "attach://<file_attach_name>", если обложка была загружена с использованием multipart/form-data под именем <file_attach_name>
+  caption?: string; // Подпись к документу для отправки, 0-1024 символа после обработки сущностей
+  parse_mode?: TG_ParseMode; // Режим разбора сущностей в подписи документа. См. варианты форматирования для более подробной информации.
+  caption_entities?: TG_MessageEntity[]; // Список специальных сущностей, которые появляются в подписи, которые можно указать вместо parse_mode
+  disable_content_type_detection?: boolean; // Отключает автоматическое определение типа контента на стороне сервера для файлов, загруженных с использованием multipart/form-data. Всегда True, если документ отправляется как часть альбома.
+}
+
+export interface TG_InputMediaPhoto {
+  type: 'photo'; // Тип результата, должен быть photo
+  media: string; // Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram, или HTTP URL для получения файла Telegram из Интернета, или передайте "attach://<file_attach_name>", чтобы загрузить новый файл с использованием multipart/form-data под именем <file_attach_name>. Больше информации о передаче файлов
+  caption?: string; // Подпись к фото для отправки, 0-1024 символа после обработки сущностей
+  parse_mode?: TG_ParseMode; // Режим разбора сущностей в подписи фото. См. варианты форматирования для более подробной информации.
+  caption_entities?: TG_MessageEntity[]; // Список специальных сущностей, которые появляются в подписи, которые можно указать вместо parse_mode
+  has_spoiler?: boolean; // Передайте True, если фото должно быть закрыто анимацией-спойлером
+}
+
+export interface TG_InputMediaVideo {
+  type: 'video'; // Тип результата, должен быть video
+  media: string; // Файл для отправки. Передайте file_id для отправки файла, существующего на серверах Telegram, или HTTP URL для получения файла Telegram из Интернета, или передайте "attach://<file_attach_name>", чтобы загрузить новый файл с использованием multipart/form-data под именем <file_attach_name>. Больше информации о передаче файлов
+  thumbnail?: FileUpload | string; // Обложка отправленного файла; может быть проигнорирована, если генерация обложки для файла поддерживается на стороне сервера. Обложка должна быть в формате JPEG и размером менее 200 кб. Ширина и высота обложки не должны превышать 320. Игнорируется, если файл не загружен с использованием multipart/form-data. Обложки нельзя использовать повторно и могут быть загружены только как новый файл, поэтому вы можете передать "attach://<file_attach_name>", если обложка была загружена с использованием multipart/form-data под именем <file_attach_name>
+  caption?: string; // Подпись к видео для отправки, 0-1024 символа после обработки сущностей
+  parse_mode?: TG_ParseMode; // Режим разбора сущностей в подписи видео. См. варианты форматирования для более подробной информации.
+  caption_entities?: TG_MessageEntity[]; // Список специальных сущностей, которые появляются в подписи, которые можно указать вместо parse_mode
+  width?: number; // Ширина видео
+  height?: number; // Высота видео
+  duration?: number; // Длительность видео в секундах
+  supports_streaming?: boolean; // Передайте True, если загруженное видео подходит для потоковой передачи
+  has_spoiler?: boolean; // Передайте True, если видео должно быть закрыто анимацией-спойлером
+}
+
+export interface TG_ReplyParameters {
+  message_id: number; // Идентификатор сообщения, на которое будет дан ответ, в текущем чате
+  chat_id?: number | string; // Идентификатор чата или имя пользователя канала, если сообщение, на которое ответ, находится в другом чате (опционально)
+  allow_sending_without_reply?: boolean; // Передать true, если сообщение должно быть отправлено, даже если указанное сообщение для ответа не найдено (опционально)
+  quote?: string; // Цитируемая часть сообщения, на которое будет ответ (опционально)
+  quote_parse_mode?: TG_ParseMode; // Режим разбора сущностей в цитате (опционально)
+  quote_entities?: TG_MessageEntity[]; // Список специальных сущностей, присутствующих в цитате (опционально)
+  quote_position?: number; // Позиция цитаты в исходном сообщении в кодовых единицах UTF-16 (опционально)
+}
+
+export interface TG_SendMediaGroupInput {
+  business_connection_id?: string;
+  chat_id: number | string;
+  message_thread_id?: number;
+  media: (
+    | TG_InputMediaAudio
+    | TG_InputMediaDocument
+    | TG_InputMediaPhoto
+    | TG_InputMediaVideo
+  )[];
+  disable_notification?: boolean;
+  protect_content?: boolean;
+  reply_parameters?: TG_ReplyParameters;
+}
+
+export type TG_Action =
+  | 'typing'
+  | 'upload_photo'
+  | 'record_video'
+  | 'upload_video'
+  | 'record_voice'
+  | 'upload_voice'
+  | 'upload_document'
+  | 'choose_sticker'
+  | 'find_location'
+  | 'record_video_note'
+  | 'upload_video_note';
+
+export interface TG_SendActionInput {
+  business_connection_id?: string;
+  chat_id: number | string;
+  message_thread_id?: number;
+  action: TG_Action;
+}
+
+export interface TG_SendMediaGroupResponse extends TG_Response {
+  // ok: boolean; // Флаг успешного выполнения запроса
+  result?: TG_Message[]; // Массив объектов сообщений, представляющих отправленные медиа (доступно только в случае успешного выполнения)
+  // error_code?: number; // Код ошибки (доступно только в случае неуспешного выполнения)
+  // description?: string; // Описание ошибки (доступно только в случае неуспешного выполнения)
+}
+
+export interface TG_LinkPreviewOptions {
+  is_disabled?: boolean; // True, если превью ссылки отключено
+  url?: string; // URL для использования в превью ссылки. Если пусто, то будет использован первый найденный URL в тексте сообщения
+  prefer_small_media?: boolean; // True, если медиа-контент в превью ссылки должен быть уменьшен
+  prefer_large_media?: boolean; // True, если медиа-контент в превью ссылки должен быть увеличен
+  show_above_text?: boolean; // True, если превью ссылки должно отображаться над текстом сообщения
+}
+
+export interface TG_WebAppInfo {
+  url: string; // HTTPS URL веб-приложения для открытия с дополнительными данными
+}
+
+export interface TG_LoginUrl {
+  url: string; // HTTPS URL, который будет открыт с данными авторизации пользователя в строке запроса при нажатии кнопки
+  forward_text?: string; // Новый текст кнопки в пересланных сообщениях (опционально)
+  bot_username?: string; // Имя бота, используемое для авторизации пользователя (опционально)
+  request_write_access?: boolean; // Передайте true, чтобы запросить разрешение на отправку сообщений пользователю (опционально)
+}
+
+export interface TG_SwitchInlineQueryChosenChat {
+  query?: string; // По умолчанию встроенный запрос для вставки в поле ввода (опционально)
+  allow_user_chats?: boolean; // true, если можно выбирать частные чаты с пользователями (опционально)
+  allow_bot_chats?: boolean; // true, если можно выбирать частные чаты с ботами (опционально)
+  allow_group_chats?: boolean; // true, если можно выбирать чаты групп и супергрупп (опционально)
+  allow_channel_chats?: boolean; // true, если можно выбирать чаты каналов (опционально)
+}
+
+export interface TG_InlineKeyboardButton {
+  text: string; // Текст метки на кнопке
+  url?: string; // HTTP или tg:// URL, который будет открыт при нажатии кнопки
+  callback_data?: string; // Данные, которые будут отправлены в запросе обратного вызова боту при нажатии кнопки
+  web_app?: TG_WebAppInfo; // Описание веб-приложения, которое будет запущено при нажатии кнопки пользователем
+  login_url?: TG_LoginUrl; // HTTPS URL, используемый для автоматической авторизации пользователя
+  switch_inline_query?: string; // Если установлено, при нажатии кнопки пользователю будет предложено выбрать один из их чатов
+  switch_inline_query_current_chat?: string; // Если установлено, при нажатии кнопки в текущем чате будет вставлено имя пользователя бота и указанный встроенный запрос
+  switch_inline_query_chosen_chat?: TG_SwitchInlineQueryChosenChat; // Если установлено, при нажатии кнопки пользователю будет предложено выбрать один из их чатов указанного типа
+  // callback_game?: CallbackGame; // Описание игры, которая будет запущена при нажатии кнопки // A placeholder, currently holds no information. Use BotFather to set up your game.
+  pay?: boolean; // Указывает, отправить ли кнопку оплаты
+}
+
+export interface TG_InlineKeyboardMarkup {
+  inline_keyboard: TG_InlineKeyboardButton[][]; // Массив строк кнопок, каждая представлена массивом объектов InlineKeyboardButton
+}
+
+export interface TG_KeyboardButtonRequestUsers {
+  request_id: number; // Знаковый 32-битный идентификатор запроса, который будет получен обратно в объекте UsersShared. Должен быть уникальным в пределах сообщения
+  user_is_bot?: boolean; // Укажите True, чтобы запросить ботов, передайте False, чтобы запросить обычных пользователей. Если не указано, дополнительных ограничений не применяется.
+  user_is_premium?: boolean; // Укажите True, чтобы запросить премиум-пользователей, передайте False, чтобы запросить не-премиум-пользователей. Если не указано, дополнительных ограничений не применяется.
+  max_quantity?: number; // Максимальное количество пользователей для выбора; 1-10. По умолчанию 1.
+  request_name?: boolean; // Укажите True, чтобы запросить имя и фамилию пользователей
+  request_username?: boolean; // Укажите True, чтобы запросить имя пользователя пользователей
+  request_photo?: boolean; // Укажите True, чтобы запросить фотографию пользователей
+}
+
+export interface TG_ChatAdministratorRights {
+  is_anonymous: boolean; // True, если присутствие пользователя в чате скрыто
+  can_manage_chat: boolean; // True, если администратор может получить доступ к журналу событий чата, получить список участников, видеть скрытых участников супергруппы и канала, отправлять жалобы на спам и игнорировать режим замедления. Подразумевается любым другим привилегиям администратора.
+  can_delete_messages: boolean; // True, если администратор может удалять сообщения других пользователей
+  can_manage_video_chats: boolean; // True, если администратор может управлять видеочатами
+  can_restrict_members: boolean; // True, если администратор может ограничивать, банить или разбанивать участников чата, или получать статистику супергруппы
+  can_promote_members: boolean; // True, если администратор может добавлять новых администраторов с частью их собственных привилегий или понижать администраторов, которых они назначили, непосредственно или косвенно (назначенных администраторами, которых назначил пользователь)
+  can_change_info: boolean; // True, если пользователь может изменять название чата, фотографию и другие настройки
+  can_invite_users: boolean; // True, если пользователь может приглашать новых участников в чат
+  can_post_stories: boolean; // True, если администратор может размещать истории в чате
+  can_edit_stories: boolean; // True, если администратор может редактировать истории, размещенные другими пользователями
+  can_delete_stories: boolean; // True, если администратор может удалять истории, размещенные другими пользователями
+  can_post_messages?: boolean; // True, если администратор может размещать сообщения в канале или получать статистику канала; только для каналов
+  can_edit_messages?: boolean; // True, если администратор может редактировать сообщения других пользователей и может прикреплять сообщения; только для каналов
+  can_pin_messages?: boolean; // True, если пользователь может закреплять сообщения; только для групп и супергрупп
+  can_manage_topics?: boolean; // True, если пользователь может создавать, переименовывать, закрывать и открывать темы форума; только для супергрупп
+}
+
+export interface TG_KeyboardButtonRequestChat {
+  request_id: number; // Знаковый 32-битный идентификатор запроса, который будет получен обратно в объекте ChatShared. Должен быть уникальным в пределах сообщения
+  chat_is_channel: boolean; // Передайте True, чтобы запросить чат канала, передайте False, чтобы запросить групповой чат или супергрупповой чат.
+  chat_is_forum?: boolean; // Передайте True, чтобы запросить форум супергруппы, передайте False, чтобы запросить чат, не являющийся форумом. Если не указано, дополнительных ограничений не применяется.
+  chat_has_username?: boolean; // Передайте True, чтобы запросить супергруппу или канал с именем пользователя, передайте False, чтобы запросить чат без имени пользователя. Если не указано, дополнительных ограничений не применяется.
+  chat_is_created?: boolean; // Передайте True, чтобы запросить чат, принадлежащий пользователю. В противном случае дополнительные ограничения не применяются.
+  user_administrator_rights?: TG_ChatAdministratorRights; // JSON-сериализованный объект, перечисляющий требуемые права администратора пользователя в чате. Права должны быть надмножеством bot_administrator_rights. Если не указано, дополнительных ограничений не применяется.
+  bot_administrator_rights?: TG_ChatAdministratorRights; // JSON-сериализованный объект, перечисляющий требуемые права администратора бота в чате. Права должны быть подмножеством user_administrator_rights. Если не указано, дополнительных ограничений не применяется.
+  bot_is_member?: boolean; // Передайте True, чтобы запросить чат с ботом в качестве участника. В противном случае дополнительные ограничения не применяются.
+  request_title?: boolean; // Передайте True, чтобы запросить название чата
+  request_username?: boolean; // Передайте True, чтобы запросить имя пользователя чата
+  request_photo?: boolean; // Передайте True, чтобы запросить фотографию чата
+}
+
+export interface TG_KeyboardButtonPollType {
+  type?: 'quiz' | 'regular'; // Опционально. Если передается 'quiz', пользователю разрешено создавать только опросы в режиме викторины. Если передается 'regular', разрешены только обычные опросы. В противном случае пользователю разрешено создавать опрос любого типа.
+}
+
+export interface TG_KeyboardButton {
+  text: string; // Текст кнопки. Если ни одно из дополнительных полей не используется, оно будет отправлено как сообщение при нажатии на кнопку
+  request_users?: TG_KeyboardButtonRequestUsers; // Если указано, нажатие на кнопку откроет список подходящих пользователей. Идентификаторы выбранных пользователей будут отправлены боту в сообщении о «users_shared». Доступно только в личных чатах.
+  request_chat?: TG_KeyboardButtonRequestChat; // Если указано, нажатие на кнопку откроет список подходящих чатов. Нажатие на чат отправит его идентификатор боту в сообщении о «chat_shared». Доступно только в личных чатах.
+  request_contact?: boolean; // Если True, номер телефона пользователя будет отправлен как контакт при нажатии на кнопку. Доступно только в личных чатах.
+  request_location?: boolean; // Если True, текущее местоположение пользователя будет отправлено при нажатии на кнопку. Доступно только в личных чатах.
+  request_poll?: TG_KeyboardButtonPollType; // Если указано, пользователь будет предложено создать опрос и отправить его боту при нажатии на кнопку. Доступно только в личных чатах.
+  web_app?: TG_WebAppInfo; // Если указано, описанное веб-приложение будет запущено при нажатии на кнопку. Веб-приложение сможет отправить сообщение о «web_app_data». Доступно только в личных чатах.
+}
+
+export interface TG_ReplyKeyboardMarkup {
+  keyboard: TG_KeyboardButton[][]; // Массив строк кнопок, каждая строка представлена массивом объектов KeyboardButton
+  is_persistent?: boolean; // Запрашивает клиентов всегда показывать клавиатуру, когда обычная клавиатура скрыта. По умолчанию false.
+  resize_keyboard?: boolean; // Запрашивает вертикальное изменение размера клавиатуры для оптимального подгонки (например, уменьшение клавиатуры, если есть только две строки кнопок). По умолчанию false.
+  one_time_keyboard?: boolean; // Запрашивает клиентов скрыть клавиатуру сразу после использования. Клавиатура все еще будет доступна, но клиенты автоматически отобразят обычную буквенную клавиатуру в чате - пользователь может нажать специальную кнопку в поле ввода, чтобы снова увидеть пользовательскую клавиатуру. По умолчанию false.
+  input_field_placeholder?: string; // Текст-подсказка, отображаемый в поле ввода, когда клавиатура активна; 1-64 символа
+  selective?: boolean; // Используйте этот параметр, если вы хотите показывать клавиатуру только определенным пользователям. Цели: 1) пользователи, которые @упоминаются в тексте объекта Message; 2) если сообщение бота является ответом на сообщение в том же чате и форуме, отправитель исходного сообщения.
+}
+
+export interface TG_ReplyKeyboardRemove {
+  remove_keyboard: true; // Запрашивает у клиентов удаление пользовательской клавиатуры (пользователь не сможет вызвать эту клавиатуру; если вы хотите скрыть клавиатуру из виду, но сохранить доступ к ней, используйте one_time_keyboard в ReplyKeyboardMarkup)
+  selective?: boolean; // Используйте этот параметр, если вы хотите удалить клавиатуру только для определенных пользователей. Цели: 1) пользователи, упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом на сообщение в том же чате и форумной теме, отправитель оригинального сообщения.
+}
+
+export interface TG_ForceReply {
+  force_reply: true; // Показывает интерфейс ответа пользователю, как если бы они вручную выбрали сообщение бота и нажали «Ответить»
+  input_field_placeholder?: string; // Плейсхолдер, отображаемый в поле ввода при активном ответе; от 1 до 64 символов
+  selective?: boolean; // Используйте этот параметр, если вы хотите принудительный ответ только от определенных пользователей. Цели: 1) пользователи, упомянутые в тексте объекта сообщения; 2) если сообщение бота является ответом на сообщение в том же чате и форумной теме, отправитель оригинального сообщения.
+}
+
+export interface TG_SendMessageInput {
+  business_connection_id?: string;
+  chat_id: number | string;
+  message_thread_id?: number;
+  text: string;
+  parse_mode?: TG_ParseMode;
+  entities?: TG_MessageEntity[];
+  link_preview_options?: TG_LinkPreviewOptions;
+  disable_notification?: boolean;
+  protect_content?: boolean;
+  reply_parameters?: TG_ReplyParameters;
+  reply_markup?:
+    | TG_InlineKeyboardMarkup
+    | TG_ReplyKeyboardMarkup
+    | TG_ReplyKeyboardRemove
+    | TG_ForceReply;
+}
+
+export interface TG_EditMessageTextInput {
+  chat_id?: number | string;
+  message_id?: number;
+  inline_message_id?: string;
+  text: string;
+  parse_mode?: TG_ParseMode;
+  disable_web_page_preview?: boolean;
+  reply_markup?: any;
+}
+
+export interface TG_SendPhotoInput {
+  business_connection_id?: string;
+  chat_id: number | string;
+  message_thread_id?: number;
+  photo: FileUpload | string;
+  caption?: string;
+  parse_mode?: TG_ParseMode;
+  caption_entities?: TG_MessageEntity[];
+  has_spoiler?: boolean;
+  disable_notification?: boolean;
+  protect_content?: boolean;
+  reply_parameters?: TG_ReplyParameters;
+  reply_markup?:
+    | TG_InlineKeyboardMarkup
+    | TG_ReplyKeyboardMarkup
+    | TG_ReplyKeyboardRemove
+    | TG_ForceReply;
+}
+
+export interface TG_SendVideoInput {
+  business_connection_id?: string;
+  chat_id: number | string;
+  message_thread_id?: number;
+  video: FileUpload | string;
+  duration?: number;
+  width?: number;
+  height?: number;
+  thumbnail?: FileUpload | string;
+  caption?: string;
+  parse_mode?: TG_ParseMode;
+  caption_entities?: TG_MessageEntity[];
+  has_spoiler?: boolean;
+  supports_streaming?: boolean;
+  disable_notification?: boolean;
+  protect_content?: boolean;
+  reply_parameters?: TG_ReplyParameters;
+  reply_markup?:
+    | TG_InlineKeyboardMarkup
+    | TG_ReplyKeyboardMarkup
+    | TG_ReplyKeyboardRemove
+    | TG_ForceReply;
+}
+
+export interface TG_EditMessageMediaInput {
+  chat_id?: number | string;
+  message_id?: number;
+  inline_message_id?: string;
+  media: {
+    type: TG_InputMediaType;
+    media: string; // file_id, URL, или "attach://<file_name>"
+    caption?: string;
+    parse_mode?: TG_ParseMode;
+  };
+  reply_markup?: any;
+}
+
+/* export interface TG_EditMessageMediaResponse {
+  ok: boolean;
+  result?: any;
+  description?: string;
+} */
+
+export interface TG_EditMessageCaptionInput {
+  chat_id?: number | string;
+  message_id?: number;
+  inline_message_id?: string;
+  caption?: string;
+  parse_mode?: TG_ParseMode;
+  caption_entities?: Array<{
+    type: string;
+    offset: number;
+    length: number;
+    url?: string;
+    user?: any;
+    language?: string;
+  }>;
+  reply_markup?: any;
+}
+
+/* export interface TG_EditMessageCaptionResponse {
+  ok: boolean;
+  result?: any;
+  description?: string;
+} */
+
+export interface TG_SendDocumentInput {
+  business_connection_id?: string; // Optional: Unique identifier of the business connection on behalf of which the message will be sent
+  chat_id: number | string; // Required: Unique identifier for the target chat or username of the target channel (e.g., @channelusername)
+  message_thread_id?: number; // Optional: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
+  document: File | Buffer | string; // Required: File to send. Can be a file_id, HTTP URL, or a new file uploaded via multipart/form-data
+  thumbnail?: File | string; // Optional: Thumbnail for the file (JPEG format, less than 200 kB, max 320x320)
+  caption?: string; // Optional: Document caption (0-1024 characters)
+  parse_mode?: TG_ParseMode; // Optional: Mode for parsing entities in the document caption
+  caption_entities?: TG_MessageEntity[]; // Optional: JSON-serialized list of special entities in the caption
+  disable_content_type_detection?: boolean; // Optional: Disables automatic server-side content type detection for multipart/form-data uploads
+  disable_notification?: boolean; // Optional: Sends the message silently (no sound notification)
+  protect_content?: boolean; // Optional: Protects the content of the message from forwarding or saving
+  allow_paid_broadcast?: boolean; // Optional: Allows up to 1000 messages per second with a fee of 0.1 Telegram Stars per message
+  message_effect_id?: string; // Optional: Unique identifier of the message effect to be applied (for private chats only)
+  reply_parameters?: TG_ReplyParameters; // Optional: Description of the message to reply to
+  reply_markup?:
+    | TG_InlineKeyboardMarkup
+    | TG_ReplyKeyboardMarkup
+    | TG_ReplyKeyboardRemove
+    | TG_ForceReply; // Optional: Additional export interface options for custom keyboards or reply instructions
+}
+
+/* export interface TG_SendPhotoResponse {
+  ok: boolean;
+  error_code?: number;
+  description?: string;
+  result?: TG_Message;
+} */
+
+/* export interface TG_SendDocumentResponse {
+  ok: boolean;
+  error_code?: number;
+  description?: string;
+  result?: TG_Message;
+} */
+
+export interface TG_DeleteMessageInput {
+  chat_id: number | string;
+  message_id: number;
+}
+
+export interface TG_LabeledPrice {
+  label: string; // Название позиции (например, "Товар", "Доставка")
+  amount: number; // Цена в минимальных единицах валюты (целое число, не float/double)
+}
+
+export interface TG_CreateInvoiceInput {
+  business_connection_id?: string; // Уникальный идентификатор бизнес-соединения (только для Telegram Stars)
+  title: string; // Название товара, 1-32 символа
+  description: string; // Описание товара, 1-255 символов
+  payload: string; // Полезная нагрузка счета, задается ботом
+  provider_token?: string; // Токен платежного провайдера. Передайте "" для Telegram Stars
+  currency: string; // Валюта счета (например, "USD", "RUB", "EUR", "XTR")
+  prices: TG_LabeledPrice[]; // Состав цены (список позиций)
+  subscription_period?: number; // Срок действия подписки в секундах (только для XTR, всегда 2592000)
+  max_tip_amount?: number; // Максимальная сумма чаевых в минимальных единицах валюты
+  suggested_tip_amounts?: number[]; // Список рекомендуемых сумм чаевых
+  provider_data?: string; // JSON-данные о счете для провайдера
+  photo_url?: string; // URL фото товара или услуги
+  photo_size?: number; // Размер фото в байтах
+  photo_width?: number; // Ширина фото
+  photo_height?: number; // Высота фото
+  need_name?: boolean; // Требуется ли ФИО пользователя
+  need_phone_number?: boolean; // Требуется ли телефон пользователя
+  need_email?: boolean; // Требуется ли email пользователя
+  need_shipping_address?: boolean; // Требуется ли адрес доставки
+  send_phone_number_to_provider?: boolean; // Отправлять ли телефон провайдеру
+  send_email_to_provider?: boolean; // Отправлять ли email провайдеру
+  is_flexible?: boolean; // Финальная цена зависит от метода доставки
+}
+
+export interface TG_AnswerPreCheckoutQueryInput {
+  pre_checkout_query_id: string; // Уникальный идентификатор запроса, на который нужно ответить
+  ok: boolean; // Укажите true, если всё в порядке и бот готов продолжить оформление заказа; false, если возникли проблемы
+  error_message?: string; // Обязательно, если ok = false. Сообщение об ошибке, объясняющее причину невозможности продолжить оформление заказа
+}
+
+/**
+ * Ответ Telegram API на метод answerPreCheckoutQuery.
+ */
+export interface TG_AnswerPreCheckoutQueryResponse extends TG_Response {
+  result?: boolean; // true, если ответ на предварительный запрос успешно принят
+}