Описание
Этот объект представляет входящий callback-запрос от кнопки обратного вызова в инлайн-клавиатуре. Если кнопка, вызвавшая запрос, была прикреплена к сообщению, отправленному ботом, будет присутствовать поле message. Если кнопка была прикреплена к сообщению, отправленному через бота (в инлайн-режиме), будет присутствовать поле inline_message_id. Ровно одно из полей data или game_short_name будет присутствовать.
| Поле | Тип | Описание |
|---|---|---|
| id | String | Уникальный идентификатор этого запроса |
| from | User | Отправитель |
| message | MaybeInaccessibleMessage | Необязательное. Сообщение, отправленное ботом с кнопкой обратного вызова, которая вызвала запрос |
| inline_message_id | String | Необязательное. Идентификатор сообщения, отправленного через бота в инлайн-режиме, которое вызвало запрос. |
| chat_instance | String | Глобальный идентификатор, однозначно соответствующий чату, в который было отправлено сообщение с кнопкой обратного вызова. Полезно для таблиц рекордов в играх. |
| data | String | Необязательное. Данные, связанные с кнопкой обратного вызова. Учтите, что сообщение, вызвавшее запрос, может не содержать кнопок обратного вызова с этими данными. |
| game_short_name | String | Необязательное. Короткое название Игры, которое нужно вернуть, служит уникальным идентификатором игры |
ПРИМЕЧАНИЕ: После нажатия пользователем кнопки обратного вызова клиенты Telegram будут отображать индикатор выполнения до тех пор, пока вы не вызовете answerCallbackQuery. Поэтому необходимо отреагировать, вызвав answerCallbackQuery, даже если уведомление пользователю не требуется (например, без указания каких-либо необязательных параметров).
Примеры
json
{
"id": "1234567890123456",
"from": {
"id": 987654321,
"is_bot": false,
"first_name": "John",
"last_name": "Doe",
"username": "johndoe",
"language_code": "en"
},
"message": {
"message_id": 123,
"date": 1609459200,
"chat": {
"id": -1001234567890,
"title": "Test Group",
"type": "supergroup"
},
"text": "Choose an option:"
},
"chat_instance": "1234567890123456789",
"data": "button_clicked"
}История изменений
- API 2.0. Добавлен объект CallbackQuery
- API 2.2.. Обновлен объект CallbackQuery: Добавлены поля game_short_name и chat_instance
Дополнительно
- User - Объект, представляющий пользователя или бота Telegram с основной информацией и настройками.
- MaybeInaccessibleMessage - Объект, представляющий сообщение, которое может быть либо обычным сообщением, либо недоступным для бота сообщением.
- answerCallbackQuery - Метод для отправки ответов на callback-запросы от инлайн-клавиатур в виде уведомлений или алертов, с возможностью перенаправления на URL.