Тип данных InlineQueryResultAudio

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

Описание

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

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

Примеры

json

{
  "type": "audio",
  "id": "unique-audio-id-123",
  "audio_url": "https://example.com/audio/sample.mp3",
  "title": "Sample Audio Track",
  "caption": "Check out this cool audio!",
  "parse_mode": "MarkdownV2",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 0,
      "length": 4
    }
  ],
  "performer": "The Musicians",
  "audio_duration": 180,
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Listen Now",
          "url": "https://example.com/player"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Here's the audio you requested!",
    "parse_mode": "HTML"
  }
}

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

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

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

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