InlineQueryResultAudio

class telegram.InlineQueryResultAudio(id, audio_url, title, performer=None, audio_duration=None, caption=None, reply_markup=None, input_message_content=None, parse_mode=None, caption_entities=None, *, api_kwargs=None)

See More

Bases: telegram.InlineQueryResult

Represents a link to an mp3 audio file. By default, this audio file will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the audio.

See also

Working with Files and Media

Use In

• telegram.Bot.answer_inline_query()

• telegram.Bot.answer_web_app_query()

• telegram.Bot.save_prepared_inline_message()

Parameters:

• id (str) – Unique identifier for this result, 1- 64 Bytes.

• audio_url (str) – A valid URL for the audio file.

• title (str) – Title.

• performer (str, optional) – Performer.

• audio_duration (int | datetime.timedelta, optional) –

  Audio duration in seconds.

  Changed in version v22.2: datetime.timedelta objects are accepted in addition to plain int values.

• caption (str, optional) – Caption, 0-1024 characters after entities parsing.

• parse_mode (str, optional) – Mode for parsing entities. See telegram.constants.ParseMode and formatting options for more details.

• caption_entities (Sequence[telegram.MessageEntity], optional) –

  Sequence of special entities that appear in the caption, which can be specified instead of parse_mode.

  Changed in version 20.0: Accepts any collections.abc.Sequence as input instead of just a list. The input is converted to a tuple.

• reply_markup (telegram.InlineKeyboardMarkup, optional) – Inline keyboard attached to the message.

• input_message_content (telegram.InputMessageContent, optional) – Content of the message to be sent instead of the audio.

type

'audio'.

Type:

str

id

Unique identifier for this result, 1- 64 Bytes.

Type:

str

audio_url

A valid URL for the audio file.

Type:

str

title

Title.

Type:

str

performer

Optional. Performer.

Type:

str

audio_duration

Optional. Audio duration in seconds.

Deprecated since version v22.2: In a future major version this attribute will be of type datetime.timedelta. You can opt-in early by setting PTB_TIMEDELTA=true or PTB_TIMEDELTA=1 as an environment variable.

Type:

int | datetime.timedelta

caption

Optional. Caption, 0-1024 characters after entities parsing.

Type:

str

parse_mode

Optional. Mode for parsing entities. See telegram.constants.ParseMode and formatting options for more details.

Type:

str

caption_entities

Optional. Tuple of special entities that appear in the caption, which can be specified instead of parse_mode.

Changed in version 20.0:

• This attribute is now an immutable tuple.

• This attribute is now always a tuple, that may be empty.

Type:

tuple[telegram.MessageEntity]

reply_markup

Optional. Inline keyboard attached to the message.

Type:

telegram.InlineKeyboardMarkup

input_message_content

Optional. Content of the message to be sent instead of the audio.

Type:

telegram.InputMessageContent