v1

latestOpenAPI 3.0.32026-07-1416059.6 KB

sendPhoto

Use this method to send photos.

post/bot{token}/sendPhoto

Path parameters

tokenstring required

Your Bot Token

Request body

chat_idstring

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

photostring

Photo to send. You can either pass a file_id as String to resend a photo that is already on the Telegram servers, or upload a new photo by just passing the path to the file as String and the SDK will take care of uploading the file for you. You can also directly pass Image URL as String to automatically download and send it to Telegram.

captionstring

Photo caption (may also be used when resending photos by file_id), 0-200 characters

disable_notificationboolean

Sends the message (silently)[https://telegram.org/blog/channels-2-0#silent-messages]. iOS users will not receive a notification, Android users will receive a notification with no sound. Other apps coming soon.

reply_to_message_idinteger

If the message is a reply, ID of the original message

reply_markupobject

Additional interface options. A JSON-serialized object for a (custom reply keyboard)[https://core.telegram.org/bots#keyboards], instructions to hide keyboard or to force a reply from the user.

Response

200

okboolean

Example response

{
  "ok": true,
  "result": {
    "message_id": 1,
    "from": {
      "id": 12345678,
      "first_name": "YourBot",
      "username": "YourBot"
    },
    "chat": {
      "id": 123456789,
      "first_name": "John",
      "last_name": "Doe",
      "username": "JohnDoe",
      "type": "private"
    },
    "date": 1459976718,
    "photo": [
      {
        "file_id": "AbCdE123XyZ...",
        "file_size": 1437,
        "width": 70,
        "height": 90
      }
    ]
  }
}