Тип данных Message

Описание

Примеры

json

{
  "message_id": 12345,
  "message_thread_id": 678,
  "from": {
    "id": 987654321,
    "is_bot": false,
    "first_name": "John",
    "last_name": "Doe",
    "username": "johndoe",
    "language_code": "en"
  },
  "sender_chat": {
    "id": -1001234567890,
    "title": "Test Channel",
    "type": "channel"
  },
  "date": 1698765432,
  "chat": {
    "id": -1001234567890,
    "title": "Test Channel",
    "type": "channel"
  },
  "text": "Hello, world! This is a test message with **bold** and _italic_ text.",
  "entities": [
    {
      "type": "bold",
      "offset": 35,
      "length": 4
    },
    {
      "type": "italic",
      "offset": 44,
      "length": 6
    }
  ],
  "link_preview_options": {
    "is_disabled": false,
    "url": "https://example.com",
    "prefer_small_media": true,
    "prefer_large_media": false,
    "show_above_text": false
  },
  "reply_to_message": {
    "message_id": 12344,
    "from": {
      "id": 987654321,
      "is_bot": false,
      "first_name": "Jane",
      "username": "janedoe"
    },
    "chat": {
      "id": -1001234567890,
      "title": "Test Channel",
      "type": "channel"
    },
    "date": 1698765400,
    "text": "Original message being replied to"
  },
  "edit_date": 1698765445,
  "has_protected_content": true,
  "author_signature": "Admin",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Button 1",
          "callback_data": "button1"
        },
        {
          "text": "Button 2",
          "url": "https://example.com"
        }
      ]
    ]
  }
}

История изменений

• API 2.0. Обновлен объект Message: Добавлены поля venue, pinned_message, entities; переименованы поля new_chat_participant и left_chat_participant в new_chat_member и left_chat_member
• API 2.1.. Обновлен объект Message: Добавлено поле edit_date
• API 2.3. Обновлен объект Message: Добавлено поле forward_from_message_id
• API 3.0. Обновлен объект Message: Добавлены новые типы контента invoice и successful_payment, добавлено поле video_note, заменено поле new_chat_member на new_chat_members
• API 3.3. Обновлен объект Message: Добавлены поля author_signature и forward_signature
• API 3.4. Обновлен объект Message: Добавлено поле caption_entities
• API 3.6. Обновлен объект Message: Добавлено поле connected_website
• API 4.0. Обновлен объект Message: Добавлено поле animation
• API 4.2. Обновлен объект Message: Добавлено поле poll для хранения опросов
• API 4.3. Обновлен объект Message: Добавлено поле reply_markup, содержащее inline клавиатуру сообщения
• API 4.7. Обновлен объект Message: Добавлено поле dice
• API 4.9. Обновлен объект Message: Добавлено поле via_bot
• API 5.0. Обновлен объект Message: Добавлены поля proximity_alert_triggered, sender_chat, author_signature
• API 5.1. Обновлен объект Message: Добавлены поля voice_chat_started, voice_chat_ended, voice_chat_participants_invited и message_auto_delete_timer_changed
• API 5.2. Обновлен объект Message: Добавлено поле voice_chat_scheduled
• API 5.5. Обновлен объект Message: Добавлено поле has_protected_content для проверки возможности пересылки сообщений
• API 6.0. Обновлен объект Message: Добавлено поле web_app_data и переименованы поля voice_chat_* в video_chat_*
• API 6.3. Обновлен объект Message: Добавлены поля is_topic_message, message_thread_id, forum_topic_created, forum_topic_closed, forum_topic_reopened
• API 6.4. Обновлен объект Message: Добавлено поле has_media_spoiler и поля forum_topic_edited, general_forum_topic_hidden, general_forum_topic_unhidden, write_access_allowed
• API 6.5. Обновлен объект Message: Добавлены поля user_shared и chat_shared
• API 6.8. Обновлен объект Message: Добавлено поле story для сообщений с пересланными историями
• API 7.0. Обновлен объект Message: Добавлено поле external_reply
• API 7.1. Обновлен объект Message: Добавлено поле boost_added
• API 7.2. Обновлен объект Message: Добавлены поля business_connection_id, sender_business_bot, is_from_offline
• API 7.3. Обновлен объект Message: Добавлено поле chat_background_set типа ChatBackground для сервисных сообщений об изменении фона
• API 7.4. Обновлен объект Message: Добавлено поле effect_id
• API 7.7. Обновлен объект Message: Добавлено поле refunded_payment
• API 9.1. Обновлен объект Message: Добавлены поля checklist, checklist_tasks_done, checklist_tasks_added, direct_message_price_changed
• API 9.2. Обновлен объект Message: Добавлено поле reply_to_checklist_task_id
• API 9.3. Обновлен объект Message: Поддержаны поля message_thread_id и is_topic_message для сообщений в личных чатах с включенным режимом тем форума. Добавлено поле gift_upgrade_sent.
• API 9.4. Обновлен объект Message: Добавлено поле chat_owner_left
• API 9.4. Обновлен объект Message: Добавлено поле chat_owner_changed
• API 9.5. Обновлен объект Message: Добавлено поле sender_tag
• API 9.6. Обновлен объект Message: Добавили поле managed_bot_created к классу Message
• API 9.6. Обновлен объект Message: Добавили поле poll_option_added к классу Message
• API 9.6. Обновлен объект Message: Добавили поле poll_option_deleted к классу Message
• API 9.6. Обновлен объект Message: Добавили поле reply_to_poll_option_id к классу Message

Дополнительно

• DirectMessagesTopic - Объект, описывающий тему в чате прямых сообщений Telegram, содержащий уникальный идентификатор и информацию о создателе.
• User - Объект, представляющий пользователя или бота Telegram с основной информацией и настройками.
• Chat - Объект, представляющий чат в Telegram с его основными характеристиками и типом.
• MessageOrigin - Объект, описывающий источник происхождения сообщения в Telegram.
• ExternalReplyInfo - Объект содержит информацию о сообщении из другого чата или темы форума, на которое даётся ответ.
• TextQuote - Объект содержит информацию о цитируемой части сообщения, на которое производится ответ.
• Story - Объект, представляющий историю, опубликованную в чате Telegram.
• MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
• LinkPreviewOptions - Объект для настройки параметров предварительного просмотра ссылок в сообщениях Telegram.
• SuggestedPostInfo - Объект содержит информацию о состоянии, цене и дате публикации предложенного поста в Telegram.
• Animation - Объект представляет файл анимации (GIF или видео без звука) с метаданными о размере, длительности и характеристиках файла.
• Audio - Объект, представляющий музыкальный аудиофайл в Telegram с метаданными, такими как длительность, исполнитель и обложка альбома.
• Document - Объект, представляющий общий файл (не фото, голосовое или аудио) с метаданными для загрузки и идентификации.
• PaidMediaInfo - Объект описывает платный медиаконтент в сообщении и условия его покупки за Telegram Stars.
• PhotoSize - Объект, представляющий один размер фотографии или миниатюры файла/стикера с метаданными файла.
• Sticker - Объект, представляющий стикер в Telegram, содержащий информацию о его типе, размере, формате и дополнительных характеристиках.
• Video - Объект, представляющий видеофайл с метаданными, включая размер, продолжительность, миниатюру и информацию о файле.
• VideoNote - Объект, представляющий видеосообщение в Telegram, с информацией о файле, размере, длительности и миниатюре.
• Voice - Объект, представляющий голосовое сообщение в Telegram Bot API.
• Checklist - Объект, описывающий контрольный список с задачами и настройками доступа для других пользователей.
• Contact - Объект Contact представляет телефонный контакт с основной информацией и дополнительными данными в формате vCard.
• Dice - Объект, представляющий анимированный эмодзи с случайным значением, используемый для игр в Telegram.
• Game - Объект Game представляет игру в Telegram, создаваемую через BotFather, и содержит её название, описание, медиафайлы и текст с возможными сущностями.
• Poll - Объект, содержащий информацию об опросе, включая вопрос, варианты ответов, настройки и результаты голосования.
• Venue - Объект, описывающий место проведения с его координатами, названием, адресом и дополнительными идентификаторами сервисов.
• Location - Объект, представляющий географическую точку на карте с координатами и дополнительными параметрами для live-локаций.
• ChatOwnerLeft - Описывает служебное сообщение, информирующее о том, что владелец чата его покинул.
• ChatOwnerChanged - Объект, представляющий служебное сообщение о том, что владелец чата сменился.
• MessageAutoDeleteTimerChanged - Объект, уведомляющий об изменении времени автоматического удаления сообщений в чате.
• MaybeInaccessibleMessage - Объект, представляющий сообщение, которое может быть либо обычным сообщением, либо недоступным для бота сообщением.
• Invoice - Объект содержит основную информацию о платёжном счёте, включая название товара, описание, валюту и общую сумму.
• SuccessfulPayment - Объект содержит информацию об успешно проведённом платеже, включая валюту, сумму, идентификаторы и данные о подписке.
• RefundedPayment - Объект содержит информацию о возвращённом платеже, включая валюту, сумму и идентификаторы.
• UsersShared - Объект содержит информацию о пользователях, чьи идентификаторы были переданы боту через специальную кнопку клавиатуры.
• ChatShared - Объект содержит информацию о чате, предоставленном боту через специальную кнопку клавиатуры.
• GiftInfo - Объект описывает служебное сообщение о регулярном подарке в Telegram, включая его свойства, возможность улучшения и конвертации в звёзды.
• UniqueGiftInfo - Объект описывает служебное сообщение об уникальном подарке в Telegram, включая его происхождение, стоимость и условия передачи.
• WriteAccessAllowed - Объект, уведомляющий о предоставлении боту права отправки сообщений пользователю через меню вложений, веб-приложение или явный запрос.
• ProximityAlertTriggered - Объект, содержащий информацию о срабатывании оповещения о приближении между двумя пользователями в чате.
• ChatBoostAdded - Объект представляет служебное сообщение о бусте чата, добавленном пользователем.
• ChatBackground - Объект, описывающий фоновое изображение или оформление чата в Telegram.
• ChecklistTasksDone - Служебное сообщение об изменении статуса выполнения задач в чек-листе.
• ChecklistTasksAdded - Служебное сообщение о добавлении новых задач в контрольный список.
• DirectMessagePriceChanged - Служебное сообщение об изменении стоимости отправки прямых сообщений в канал.
• ForumTopicCreated - Объект представляет служебное сообщение о создании новой темы форума в чате с информацией о названии, цвете иконки и пользовательском эмодзи.
• ForumTopicEdited - Объект, представляющий служебное сообщение об изменении названия или иконки темы форума.
• ForumTopicClosed - Служебное сообщение, информирующее о закрытии темы в форуме чата.
• ForumTopicReopened - Служебное сообщение о том, что закрытая тема форума в чате была снова открыта.
• GeneralForumTopicHidden - Служебное сообщение о скрытии общей темы форума в чате.
• GeneralForumTopicUnhidden - Служебное сообщение об открытии общей темы форума в чате.
• GiveawayCreated - Объект, представляющий служебное сообщение о создании запланированного розыгрыша призов.
• Giveaway - Объект, описывающий запланированный розыгрыш с указанием условий участия, призов и правил выбора победителей.
• GiveawayWinners - Объект, содержащий информацию о завершённом розыгрыше с публичными победителями, включая список победителей, параметры розыгрыша и детали призов.
• GiveawayCompleted - Объект представляет служебное сообщение о завершении розыгрыша без публичных победителей.
• ManagedBotCreated - Этот объект используется для передачи данных о созданном управляемом боте. Он содержит информацию о боте (объект User) и позволяет получить его токен через специальный метод.
• PaidMessagePriceChanged - Служебное сообщение об изменении стоимости платных сообщений в чате.
• PollOptionAdded - Этот объект представляет служебное сообщение, которое появляется, когда в опрос (poll) добавляется новая опция. Он содержит идентификатор и текст добавленной опции, а также ссылку на исходное сообщение с опросом, если оно доступно.
• PollOptionDeleted - Этот объект представляет служебное сообщение, которое появляется при удалении опции из опроса (poll). Он содержит идентификатор и текст удаленной опции, а также ссылку на исходное сообщение с опросом, если оно доступно.
• SuggestedPostApproved - Служебное сообщение об одобрении предложенной публикации с информацией о стоимости и дате публикации.
• SuggestedPostApprovalFailed - Служебное сообщение о неудачном одобрении предложенной публикации из-за недостаточного баланса пользователя.
• SuggestedPostDeclined - Служебное сообщение об отклонении предложенной публикации с возможным комментарием.
• SuggestedPostPaid - Объект описывает служебное сообщение об успешной оплате предложенной публикации в канале, включая детали валюты и суммы.
• SuggestedPostRefunded - Служебное сообщение о возврате платежа за предложенную публикацию в Telegram.
• VideoChatScheduled - Объект представляет служебное сообщение о запланированном видеочате с указанием времени начала.
• VideoChatStarted - Служебное сообщение, информирующее о начале видеозвонка в чате.
• VideoChatEnded - Объект представляет служебное сообщение о завершении видеозвонка с указанием его длительности.
• VideoChatParticipantsInvited - Объект представляет служебное сообщение о приглашении новых участников в видеозвонок.
• WebAppData - Объект, содержащий данные, переданные из Веб-приложения Telegram боту, включая сами данные и текст кнопки, которая открыла приложение.
• InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.