sendPhoto

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

📘 Bots can currently send photo files of up to 20 MB in size, this limit may be changed in the future.

Field	Type	Required	Description
method	String	Yes	"sendPhoto"
chat_id	String	Yes	Unique identifier for the target Chat or User_id.
photo	String	Yes	Photo: pass a media_id as a string to send a photo that exists on the nandbox servers.
caption	String	Optional	Photo caption: 0-256 characters.
disable_web_page_preview	Boolean	Optional	Disables link previews for links in this message.
disable_notification	Boolean	Optional	Sends the message silently: users will receive a notification with no sound.
reply_to_message_id	String	Optional	Unique identification for the original parent message if the message is a reply.
reference	Long	Yes	Unique local identifier for the target Chat or User.
to_user_id	String	Optional	Unique identifier of the target user if a user replies or sends a message to the target user within a Group or Channel.
echo	Integer	Optional	1= repeat message 0= no echo
menu_ref	String	Optional	Menu reference for an existing predefined menu: the menu will be displayed as an inline menu associated with the message.
inline_menu	Array of Menu	Optional	Inline menu object to hold menus: if both inline_menu and menu_ref are defined, the priority goes to inline_menu.
chat_settings	Integer	Optional	1: if you want to send to bot chat settings

Requests

json
{
  "method": "sendPhoto",
  "chat_id": "12547774103695899",
  "reference": 4458716963254,
  "photo": "f3b0f1e475e5eebf9c320c1231767f3476210a24c04285132cae083494a65468.jpg",
  "caption": "Taste of life",
  "echo": 5
}

java

// SEND PHOTO
else if (incomingMsg.getText().toLowerCase().equals("photo")) {
	String uploadedPhotoId = MediaTransfer.uploadFile(TOKEN, System.getProperty("user.dir") + "/src/main/resources/upload/welcome.jpg");
	PhotoOutMessage photoMsg = new PhotoOutMessage();
	photoMsg.setChatId(incomingMsg.getChat().getId());
	photoMsg.setReference(Utils.getUniqueId());
	if (uploadedPhotoId != null) {
		photoMsg.setPhoto(uploadedPhotoId);
		api.send(photoMsg);
	} else {
		System.out.println("Upload Failed");
	}
}

javascript
/* use the MediaTansfer in src/util/MediaTransfer class to upload the photo to the server
 then send it */
MediaTransfer.uploadFile(TOKEN, "./your_photo.jpg", config.UploadServer)
  .then((uploadedPhotoId) => {
    let photoMsg = new PhotoOutMessage();
    photoMsg.chat_id = incomingMsg.chat.id;
    photoMsg.reference = Id();
    photoMsg.photo = uploadedPhotoId;
    photoMsg.caption = "Photo From Bot";
    photoMsg.echo = 1;

    api.send(JSON.stringify(photoMsg));
  })
  .catch((e) => console.log("Upload failed", e));

python

napi.send_photo("chatId","photoId",Utils.get_unique_id())

Response

json
{
  "method": "message",
  "message": {
    "date": 1600168078602,
    "reference": 2097,
    "chat": {
      "name": "Alice Park",
      "id": "90089668723575679",
      "terminal": "Mobile",
      "type": "Contact",
      "version": "('0HNt','1QBk','2c2H','31RN')"
    },
    "sent_to": {
      "id": "90091903321704167"
    },
    "message_id": "i1_CD11KwDr126551",
    "style": 6,
    "from": {
      "name": "Alice Park",
      "id": "90089668723575679",
      "terminal": "Mobile",
      "type": "Contact",
      "version": "('0HNt','1QBk','2c2H','31RN')"
    },
    "text": "Hello",
    "type": "text"
  }
}