
Объект содержит общую информацию о групповом чате или канале: его тип, настройки отображения (название, аватар, описание, ссылка), публичную доступность, а также информацию об участниках (владельце, боте и других пользователях), времени их последней активности и событиях

ID чата или канала — в зависимости от ограничений метода и от того, с чем вы работаете. Как получить ID — [на странице «Получение ID чата или канала»](/docs-api/use-cases/getting-chat-id)
Возможные значения в enum: `"chat"` `"channel"` `"dialog"`

Тип чата:
 - `"chat"` — Групповой чат
 - `"channel"` — Канал
 - `"dialog"` — Диалог
Возможные значения в enum: `"active"` `"removed"` `"left"` `"closed"`

Статус чата:
- `"active"` — Бот является активным участником чата
- `"removed"` — Бот был удалён из чата
- `"left"` — Бот покинул чат
- `"closed"` — Чат был закрыт
Отображаемое название чата или канала. Может быть `null` для диалогов
Аватар группового чата или канала

URL изображения

Время последнего события в чате или канале в формате Unix timestamp в миллисекундах
Количество участников чата или канала. Для диалогов всегда `2`
ID владельца чата или канала
Список участников в формате ключ-значение, где ключ — идентификатор участника `user_id`, а значение — время его последней активности в чате или канале `last_event_time`. Может быть `null`, если запрашивается список чатов
Параметр показывает, доступен ли групповой чат или канал публично. Для диалогов и приватных каналов — всегда `false`
Ссылка на чат
Описание чата или канала
Данные о пользователе в диалоге (только для чатов типа `"dialog"`)

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота. Для пользователей это поле не возвращается
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_
до `16000` символов

Описание пользователя или бота. В случае с пользователем может принимать значение `null`, если описание не заполнено
URL аватара пользователя или бота в уменьшенном размере
URL аватара пользователя или бота в полном размере

Количество сообщений в групповом чате или постов в канале
Закреплённое сообщение в чате (возвращается только при запросе конкретного чата или канала)

Отправитель сообщения: пользователь или бот

**Обратите внимание**:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота. Для пользователей это поле не возвращается
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Получатель сообщения: пользователь или бот (для диалога), канал или чат

 **Обратите внимание**: все параметры в объекте относятся к получателю сообщения

ID чата или канала — в зависимости от ограничений метода и от того, с чем вы работаете. Как получить ID — [на странице «Получение ID чата или канала»](/docs-api/use-cases/getting-chat-id)
Возможные значения в enum: `"chat"` `"channel"` `"dialog"`

Тип чата:
 - `chat` — групповой чат
 - `channel` — канал или комментарий к посту (для вызовов методов группы `/comments`)
 - `dialog` — диалог
ID получателя сообщения в диалоге (пользователя или бота). Если сообщение отправлено в групповой чат или канал, то параметр отсутствует
Идентификатор поста в канале, к которому оставлен комментарий

Время создания сообщения в формате Unix timestamp в миллисекундах
Пересланное или ответное сообщение

Возможные значения в enum: `"forward"` `"reply"`

Тип связанного сообщения:
  - `"reply"` — ответ на сообщение в чате 
- `"forward"` — пересланное сообщение в чате
Пользователь или бот, отправивший сообщение

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота. Для пользователей это поле не возвращается
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Чат или канал, в котором сообщение было изначально опубликовано. Только для пересланных сообщений с `type = forward`. Как получить ID — [на странице «Получение ID чата или канала»](/docs-api/use-cases/getting-chat-id)
Информация о сообщении

Уникальный ID сообщения
ID расположения сообщения в чате по порядку
Текст сообщения
Вложения сообщения. Могут быть одним из типов `attachment`, описанных в схеме ниже
Если поле пустое или равно `null`, изменений не произойдёт. Если массив пуст, все вложения будут удалены

Данные, использованные для отправки изображения

Уникальный ID этого изображения
Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)
URL изображения. Время жизни ссылки ограниченно. Срок истечения указан в параметре `expires` — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android

Результат загрузки аудио/видео

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
Используйте `token`, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении

Миниатюра видео

URL изображения

Ширина видео
Высота видео
Длина видео в секундах

Результат загрузки аудиосообщения или аудиофайла

 Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип `audio`

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
Используйте `token`, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении

Результат загрузки файла

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
Используйте `token`, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении

Имя загруженного файла
Размер файла в байтах

Результат отправки стикера

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
ID стикера

Ширина стикера
Высота стикера

Результат загрузки данных контакта в сообщение

Информация о пользователе в формате VCF
Хеш информации о пользователе в формате VCF. Используется для проверки того, что пользователь поделился номером телефона, привязанным к его профилю в MAX
 Подробнее — [в разделе «Типы кнопок»](/docs-api/use-cases/sending-messages/keyboard#Типы%20кнопок)
Информация о пользователе

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота. Для пользователей это поле не возвращается
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Клавиатура — это двумерный массив кнопок. Подробнее о типах кнопок и клавиатуре в ботах — [в разделе «Клавиатура для чат-бота»](/docs-api/use-cases/sending-messages/keyboard)

от `1` до `128` символов

Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: `20` символов — при одной кнопке в ряду, `10` — при двух, `5` — при трёх, `3` — при четырёх

до `1024` символов

Токен кнопки

до `2048` символов

Если `true`, отправляет местоположение без запроса подтверждения пользователя
Если `false`, возвращает модальное окно с дополнительным уточнением об отправке местоположения

Публичное имя (username) бота или ссылка на него, чьё мини-приложение надо запустить
Идентификатор бота, чьё мини-приложение надо запустить
Параметр запуска, который будет передан в [initData](/docs/webapps/bridge#WebAppData) мини-приложения

до `1024` символов

Текст, который будет скопирован

Данные, использованные для прикрепления к сообщению предпросмотра контента по внешнему URL

от `1` символа

URL, прикреплённый к сообщению для предпросмотра медиавложения
Токен вложения

Заголовок предпросмотра ссылки.
Описание предпросмотра ссылки
Изображение предпросмотра ссылки

Широта, до 15 символов
Долгота, до 15 символов

Разметка текста сообщения. Подробнее — в разделе [Форматирование](/docs-api/use-cases/sending-messages/text-formatting)

Тип элемента разметки. Может быть **жирный**,  *курсив*, ~зачеркнутый~, подчеркнутый, `моноширинный`, выделенный, цитата, заголовок, ссылка или упоминание пользователя

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
Индекс начала элемента разметки в тексте. Нумерация с нуля
Длина элемента разметки в символах

от `1` до `2048` символов

URL ссылки

`@username` упомянутого пользователя
ID упомянутого пользователя без имени

Содержимое сообщения: текст и вложения. Может быть `null`, если сообщение содержит только пересланное сообщение

Уникальный ID сообщения
ID расположения сообщения в чате по порядку
Текст сообщения
Вложения сообщения. Могут быть одним из типов `attachment`, описанных в схеме ниже
Если поле пустое или равно `null`, изменений не произойдёт. Если массив пуст, все вложения будут удалены

Данные, использованные для отправки изображения

Уникальный ID этого изображения
Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)
URL изображения. Время жизни ссылки ограниченно. Срок истечения указан в параметре `expires` — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android

Результат загрузки аудио/видео

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
Используйте `token`, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении

Миниатюра видео

URL изображения

Ширина видео
Высота видео
Длина видео в секундах

Результат загрузки аудиосообщения или аудиофайла

 Если пользователь отправил боту аудиосообщение, то ответах на запросы получения информации о сообщениях вернётся тип `audio`

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
Используйте `token`, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении

Результат загрузки файла

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
Используйте `token`, если вы пытаетесь повторно использовать одно и то же вложение в другом сообщении

Имя загруженного файла
Размер файла в байтах

Результат отправки стикера

URL вложения, который возвращается в объекте [Update](/docs-api/objects/Update) после отправки сообщения в чат или канал

 В случае с вложенным видео прямую ссылку также можно получить с помощью метода [`GET /videos/{-videoToken-}`](/docs-api/methods/GET/videos/-videoToken-)
ID стикера

Ширина стикера
Высота стикера

Результат загрузки данных контакта в сообщение

Информация о пользователе в формате VCF
Хеш информации о пользователе в формате VCF. Используется для проверки того, что пользователь поделился номером телефона, привязанным к его профилю в MAX
 Подробнее — [в разделе «Типы кнопок»](/docs-api/use-cases/sending-messages/keyboard#Типы%20кнопок)
Информация о пользователе

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота. Для пользователей это поле не возвращается
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Клавиатура — это двумерный массив кнопок. Подробнее о типах кнопок и клавиатуре в ботах — [в разделе «Клавиатура для чат-бота»](/docs-api/use-cases/sending-messages/keyboard)

от `1` до `128` символов

Видимый текст кнопки. Чтобы он отображался полностью, рекомендуем не превышать заданное количество символов в зависимости от размещения текста: `20` символов — при одной кнопке в ряду, `10` — при двух, `5` — при трёх, `3` — при четырёх

до `1024` символов

Токен кнопки

до `2048` символов

Если `true`, отправляет местоположение без запроса подтверждения пользователя
Если `false`, возвращает модальное окно с дополнительным уточнением об отправке местоположения

Публичное имя (username) бота или ссылка на него, чьё мини-приложение надо запустить
Идентификатор бота, чьё мини-приложение надо запустить
Параметр запуска, который будет передан в [initData](/docs/webapps/bridge#WebAppData) мини-приложения

до `1024` символов

Текст, который будет скопирован

Данные, использованные для прикрепления к сообщению предпросмотра контента по внешнему URL

от `1` символа

URL, прикреплённый к сообщению для предпросмотра медиавложения
Токен вложения

Заголовок предпросмотра ссылки.
Описание предпросмотра ссылки
Изображение предпросмотра ссылки

Широта, до 15 символов
Долгота, до 15 символов

Разметка текста сообщения. Подробнее — в разделе [Форматирование](/docs-api/use-cases/sending-messages/text-formatting)

Тип элемента разметки. Может быть **жирный**,  *курсив*, ~зачеркнутый~, подчеркнутый, `моноширинный`, выделенный, цитата, заголовок, ссылка или упоминание пользователя

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминания пользователей
Индекс начала элемента разметки в тексте. Нумерация с нуля
Длина элемента разметки в символах

от `1` до `2048` символов

URL ссылки

`@username` упомянутого пользователя
ID упомянутого пользователя без имени

Статистика просмотров постов и репостов — возвращается только для каналов

Количество пользователей, которые увидели пост или репост в канале. Просмотр засчитывается, когда пост или репост попадает в область видимости экрана
Если это репост, то будет показано количество именно его просмотров

Публичная ссылка на пост в канале. Отсутствует для диалогов и групповых чатов

## Пример объекта

{
    "chat_id": 0,
    "type": "chat",
    "status": "active",
    "title": "string",
    "icon": {
        "url": "string"
    },
    "last_event_time": 0,
    "participants_count": 0,
    "owner_id": 0,
    "participants": {
        "key": 0
    },
    "is_public": true,
    "link": "string",
    "description": "string",
    "dialog_with_user": {
        "user_id": 0,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "is_bot": true,
        "last_activity_time": 0,
        "name": "string",
        "description": "string",
        "avatar_url": "string",
        "full_avatar_url": "string"
    },
    "messages_count": 0,
    "pinned_message": {
        "sender": {
            "user_id": 0,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "is_bot": true,
            "last_activity_time": 0,
            "name": "string"
        },
        "recipient": {
            "chat_id": 0,
            "chat_type": "chat",
            "user_id": 0,
            "post_id": "string"
        },
        "timestamp": 0,
        "link": {
            "type": "forward",
            "sender": {
                "user_id": 0,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "is_bot": true,
                "last_activity_time": 0,
                "name": "string"
            },
            "chat_id": 0,
            "message": {
                "mid": "string",
                "seq": 0,
                "text": "string",
                "attachments": [
                    {
                        "type": "image",
                        "payload": {
                            "photo_id": 0,
                            "token": "string",
                            "url": "string"
                        }
                    }
                ],
                "markup": [
                    {
                        "type": "strong",
                        "from": 0,
                        "length": 0
                    }
                ]
            }
        },
        "body": {
            "mid": "string",
            "seq": 0,
            "text": "string",
            "attachments": [
                {
                    "type": "image",
                    "payload": {
                        "photo_id": 0,
                        "token": "string",
                        "url": "string"
                    }
                }
            ],
            "markup": [
                {
                    "type": "strong",
                    "from": 0,
                    "length": 0
                }
            ]
        },
        "stat": {
            "views": 0
        },
        "url": "string"
    }
}

