Описание
Представляет ссылку на голосовую запись в контейнере .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 - Объект, представляющий содержимое сообщения для отправки через инлайн-запрос, поддерживающий пять различных типов контента.