Тип данных InlineQueryResultCachedAudio

Результат встроенного запроса для отправки MP3-аудиофайла, хранящегося на серверах Telegram, с возможностью замены на произвольное сообщение.

Описание

Представляет ссылку на MP3-аудиофайл, хранящийся на серверах Telegram. По умолчанию этот аудиофайл будет отправлен пользователем. В качестве альтернативы можно использовать input_message_content для отправки сообщения с указанным содержимым вместо аудио.

Поле Тип Описание
type String Тип результата, должен быть audio
id String Уникальный идентификатор результата, 1-64 байта
audio_file_id String Действительный идентификатор файла для аудиофайла
caption String Опционально. Подпись, 0-1024 символа после обработки сущностей
parse_mode String Опционально. Режим обработки сущностей в подписи к аудио. Подробнее см. параметры форматирования.
caption_entities Массив MessageEntity Опционально. Список специальных сущностей в подписи, которые можно указать вместо parse_mode
reply_markup InlineKeyboardMarkup Опционально. Инлайн-клавиатура, прикреплённая к сообщению
input_message_content InputMessageContent Опционально. Содержимое сообщения для отправки вместо аудио

Примеры

json

{
  "type": "audio",
  "id": "unique_result_id_123",
  "audio_file_id": "CQACAgIAAxkBAAIBFmZfX7q3p6q7bX2s1QABHq7tT7KqLgACrCwAAjDysUgqAAH7qQABqKpKHgQ",
  "caption": "This is a cached audio file with *bold* text",
  "parse_mode": "MarkdownV2",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 31,
      "length": 10
    }
  ],
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Listen now",
          "callback_data": "play_audio_123"
        },
        {
          "text": "More options",
          "url": "https://example.com/audio"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Alternative text message instead of sending the audio",
    "parse_mode": "HTML"
  }
}

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

  • API 2.2.. Обновлен объект InlineQueryResultCachedAudio: Добавлено поле caption
  • API 5.0. Обновлен объект InlineQueryResultCachedAudio: Добавлена возможность ручного указания текстовых сущностей

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

  • MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
  • InlineKeyboardMarkup - Объект для создания встроенной клавиатуры, которая отображается непосредственно в сообщении.
  • InputMessageContent - Объект, представляющий содержимое сообщения для отправки через инлайн-запрос, поддерживающий пять различных типов контента.
Комментарии