Тип данных InlineQueryResultVoice

Объект, представляющий результат встроенного запроса в виде голосового сообщения в формате OGG/Opus с возможностью замены на текстовое сообщение.

Описание

Представляет ссылку на голосовую запись в контейнере .OGG, закодированную с помощью OPUS. По умолчанию эта голосовая запись будет отправлена пользователем. Альтернативно, вы можете использовать input_message_content для отправки сообщения с указанным содержимым вместо голосового сообщения.

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

Примеры

json

{
  "type": "voice",
  "id": "unique_result_123",
  "voice_url": "https://example.com/voice_recording.ogg",
  "title": "Sample Voice Recording",
  "caption": "This is a sample voice message with *bold* text",
  "parse_mode": "MarkdownV2",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 31,
      "length": 4
    }
  ],
  "voice_duration": 45,
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Listen Again",
          "callback_data": "play_voice_123"
        },
        {
          "text": "Open Website",
          "url": "https://example.com"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Voice message: Sample Voice Recording",
    "parse_mode": "HTML"
  }
}

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

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

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

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