Тип данных InlineQueryResultCachedVoice

Объект для отправки сохранённого на серверах Telegram голосового сообщения через инлайн-режим бота.

Описание

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

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

Примеры

json

{
  "type": "voice",
  "id": "unique_result_123",
  "voice_file_id": "AwACAgQAAxkBAAIB",
  "title": "Sample Voice Message",
  "caption": "This is a *cached* voice message with formatting",
  "parse_mode": "MarkdownV2",
  "caption_entities": [
    {
      "type": "bold",
      "offset": 12,
      "length": 6
    }
  ],
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Listen Again",
          "callback_data": "play_voice_123"
        }
      ]
    ]
  },
  "input_message_content": {
    "message_text": "Alternative text message instead of voice",
    "parse_mode": "HTML"
  }
}

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

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

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

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