Chat.set_photo()#

Chat.set_photo()#

Bound method set_photo of Chat.

Use as a shortcut for:

await client.set_chat_photo(
    chat_id=chat_id,
    photo=photo
)

Example

# Set chat photo using a local file
await chat.set_photo(photo="photo.jpg")

# Set chat photo using an existing Photo file_id
await chat.set_photo(photo=photo.file_id)


# Set chat video using a local file
await chat.set_photo(video="video.mp4")

# Set chat photo using an existing Video file_id
await chat.set_photo(video=video.file_id)
Parameters:

  • photo (str | io.BytesIO, optional) – New chat photo. You can pass a Photo file_id, a file path to upload a new photo from your local machine or a binary file-like object with its attribute “.name” set for in-memory uploads.

  • video (str | io.BytesIO, optional) – New chat video. You can pass a Video file_id, a file path to upload a new video from your local machine or a binary file-like object with its attribute “.name” set for in-memory uploads.

  • photo_frame_start_timestamp (float, optional) – Floating point UNIX timestamp in seconds, indicating the frame of the video/sticker that should be used as static preview; can only be used if video or video_emoji_markup is set.

Returns:

Message | bool – On success, a service message will be returned (when applicable), otherwise, in case a message object couldn’t be returned, True is returned.

Raises:

  • RPCError – In case of a Telegram RPC error.

  • ValueError – if a chat_id belongs to user.