Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
View this page
Toggle table of contents sidebar

# Voice

class telegram.Voice(file_id, file_unique_id, duration, mime_type=None, file_size=None, *, api_kwargs=None)

  Bases: `telegram.TelegramObject`

  This object represents a voice note.

  Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their `file_unique_id` is equal.

  Use In

  - `telegram.Bot.get_file()`

  - `telegram.Bot.send_voice()`

  Available In

  - `telegram.ExternalReplyInfo.voice`

  - `telegram.Message.voice`

  Parameters:

    - file_id (`str`) – Identifier for this file, which can be used to download or reuse the file.

    - file_unique_id (`str`) – Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

    - duration (`int`) – Duration of the audio in seconds as defined by the sender.

    - mime_type (`str`, optional) – MIME type of the file as defined by the sender.

    - file_size (`int`, optional) – File size in bytes.

  file_id

    Identifier for this file, which can be used to download or reuse the file.

    Type:

      `str`

  file_unique_id

    Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

    Type:

      `str`

  duration

    Duration of the audio in seconds as defined by the sender.

    Type:

      `int`

  mime_type

    Optional. MIME type of the file as defined by the sender.

    Type:

      `str`

  file_size

    Optional. File size in bytes.

    Type:

      `int`

  async get_file(*, read_timeout=None, write_timeout=None, connect_timeout=None, pool_timeout=None, api_kwargs=None)

    Convenience wrapper over `telegram.Bot.get_file()`

    For the documentation of the arguments, please see `telegram.Bot.get_file()`.

    Returns:

      `telegram.File`

    Raises:

      telegram.error.TelegramError –