aiogram/docs/api/methods/send_photo.md
2020-01-11 22:59:14 +02:00

2.6 KiB

sendPhoto

Description

Use this method to send photos. On success, the sent Message is returned.

Arguments

Name Type Description
chat_id #!python3 Union[int, str] Unique identifier for the target chat or username of the target channel (in the format @channelusername)
photo #!python3 Union[InputFile, str] Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data.
caption #!python3 Optional[str] Optional. Photo caption (may also be used when resending photos by file_id), 0-1024 characters
parse_mode #!python3 Optional[str] Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
disable_notification #!python3 Optional[bool] Optional. Sends the message silently. Users will receive a notification with no sound.
reply_to_message_id #!python3 Optional[int] Optional. If the message is a reply, ID of the original message
reply_markup #!python3 Optional[Union[InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove, ForceReply]] Optional. Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.

Response

Type: #!python3 Message

Description: On success, the sent Message is returned.

Usage

As bot method bot

result: Message = await bot.send_photo(...)

Method as object

Imports:

  • from aiogram.methods import SendPhoto
  • from aiogram.api.methods import SendPhoto
  • from aiogram.api.methods.send_photo import SendPhoto

In handlers with current bot

result: Message = await SendPhoto(...)

With specific bot

result: Message = await bot(SendPhoto(...))

As reply into Webhook in handler

return SendPhoto(...)