InputMediaVoiceNote

class pyrogram.types.InputMediaVoiceNote[source]

A voice message to be sent.

Use this class to send a voice note (audio recording) to a chat. The voice note is uploaded to Telegram servers and sent as a document with a voice attribute.

Parameters:

  • media (str | BinaryIO) – Voice note to send. Pass a file_id as string to send a voice note that exists on the Telegram servers or pass a file path as string to upload a new voice note that exists on your local machine or pass a binary file-like object with its attribute “.name” set for in-memory uploads or pass an HTTP URL as a string for Telegram to get a voice note from the Internet.

  • duration (int, optional) – Duration of the voice note in seconds.

  • waveform (bytes, optional) – Waveform representation of the voice note, as a byte string. Used by clients to render the audio waveform visualization.

  • caption (str, optional) – Caption of the voice note to be sent, 0-1024 characters. If not specified, the original caption is kept. Pass “” (empty string) to remove the caption.

  • parse_mode (ParseMode, optional) – By default, texts are parsed using both Markdown and HTML styles. You can combine both syntaxes together.

  • caption_entities (List of MessageEntity) – List of special entities that appear in the caption, which can be specified instead of parse_mode.

  • file_name (str, optional) – File name of the voice note sent. Defaults to file’s path basename.

Example

from pyrogram.types import InputMediaVoiceNote

# Send a voice note by file path
voice = InputMediaVoiceNote(media="voice.ogg", duration=30)

# Send a voice note by file_id
voice = InputMediaVoiceNote(media="<file_id>")