
Объект используется при отправке нового сообщения в чат или канал[`POST /messages`](/docs-api/methods/POST/messages), редактировании существующего сообщения или поста [`PUT /messages`](/docs-api/methods/PUT/messages), а также callback-отправке сообщения пользователю при нажатии им кнопки в чате или канале [`POST /answers`](/docs-api/methods/POST/answers) 

Параметры объекта содержат: текст и способ его форматирования, вложения, ссылку на связанное сообщение (ответ или пересылка), настройку PUSH-уведомлений для участников чата

до `4000` символов
Вложения сообщения. Если поле пустое или равно `null`, изменений не произойдёт. Если массив пуст, все вложения будут удалены

Данные для прикрепления изображения (все поля являются взаимоисключающими). Вместе с изображениями можно прикрепить видеофайлы (`type: video`) и одно вложение с кнопками (`type: inline_keyboard`). Общее количество вложений не должно превышать общее ограничение — 12. Подробнее — [в примерах](/docs-api/use-cases/sending-messages/media#Как%20отправить%20аудио)

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

Любой внешний URL изображения, которое вы хотите прикрепить
Токен существующего вложения
Токены, полученные после загрузки изображений

Данные, которые вы получили в ответ на запрос [POST /uploads](/docs-api/methods/POST/uploads). Можно передавать после того, как вы загрузили аудио, видео или файл и получили в ответ от сервера `retval`. Подробнее — в описании [POST /uploads](/docs-api/methods/POST/uploads)

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)

Данные, которые вы получили в ответ на запрос [POST /uploads](/docs-api/methods/POST/uploads). Можно передавать после того, как вы загрузили аудио, видео или файл и получили в ответ от сервера `retval`. Подробнее — в описании [POST /uploads](/docs-api/methods/POST/uploads)

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)

Данные для прикрепления файла к сообщению, которые вы получили в ответ на запрос [POST /uploads](/docs-api/methods/POST/uploads). К сообщению можно прикрепить только один файл вместе с одним вложением с кнопками. Отправка файла совместно с другими вложениями не поддерживается

Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)

Данные для при прикрепления стикера к сообщению. Должен быть единственным вложением в сообщении. В одном запросе можно отправить только один стикер

Код стикера

Данные для прикрепления карточки контакта к сообщению. К сообщению можно прикрепить один контакт. Совместно с ним можно прикрепить дополнительно одно вложение с кнопкой (`type: inline_keyboard`). Передача других типов вложений совместно с контактом не поддерживается

Имя контакта
ID контакта, если он зарегистрирован в MAX
Полная информация о контакте в формате VCF

Данные для прикрепления кнопок к сообщению
Ограничения:
- Максимальное количество кнопок в ряду — 7
- Максимальное количество строк с кнопками — 30
- Если в ряду кнопки с типами: `link`, `open_app`, `request_geo_location`, `request_contact`, то максимальное количество кнопок в ряду — три

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

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

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

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

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

Токен кнопки

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

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

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

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

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

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

Данные для прикрепления предпросмотра контента по внешнему URL

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

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

Ссылка на сообщение в чате или пост в канале. Ссылки на комментарии к постам в каналах не поддержаны

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

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

 **Для комментариев поддерживается только тип `reply`**
ID исходного сообщения

По умолчанию: `true`

Для каналов всегда отправляйте запрос с `notify = true` или без этого поля. Отключить push-уведомления в каналах нельзя

В групповых чатах и диалогах, если `notify = true` или поле отсутствует, уведомление отобразится пользователю

При `notify = false` отображение push-уведомлений зависит от платформы:
- **Десктоп-клиент и веб-приложение на iOS**. В диалогах и групповых чатах при `notify = false` уведомления не отображаются
- **Приложение на Android**. В диалогах при `notify = false` уведомления не отображаются. В групповых чатах при `notify = false` уведомление не отображаются, только если приложение МАХ свёрнуто или закрыто. Если приложение открыто, пользователь увидит уведомление
- **Веб-приложение**. Управление отображением уведомлений с помощью параметра `notify` не поддержано
Возможные значения в enum: `"markdown"` `"html"`

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

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

{
    "text": "string",
    "attachments": [
        {
            "type": "image",
            "payload": {
                "url": "string",
                "token": "string",
                "photos": {
                    "token": "string"
                }
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "video",
            "payload": {
                "token": "string"
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "audio",
            "payload": {
                "token": "string"
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "file",
            "payload": {
                "token": "string"
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "sticker",
            "payload": {
                "code": "string"
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "contact",
            "payload": {
                "name": "string",
                "contact_id": 0,
                "vcf_info": "string"
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "callback",
                            "text": "string",
                            "payload": "string"
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "link",
                            "text": "string",
                            "url": "string"
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "request_geo_location",
                            "text": "string",
                            "quick": true
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "request_contact",
                            "text": "string"
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "open_app",
                            "text": "string",
                            "web_app": "string",
                            "contact_id": 0,
                            "payload": "string"
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "message",
                            "text": "string"
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "inline_keyboard",
            "payload": {
                "buttons": [
                    [
                        {
                            "type": "clipboard",
                            "text": "string",
                            "payload": "string"
                        }
                    ]
                ]
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "location",
            "latitude": 0,
            "longitude": 0
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

{
    "text": "string",
    "attachments": [
        {
            "type": "share",
            "payload": {
                "url": "string",
                "token": "string"
            }
        }
    ],
    "link": {
        "type": "forward",
        "mid": "string"
    },
    "notify": true,
    "format": "markdown"
}

