sendDocument

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

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

Field	Type	Required	Description
method	String	Yes	"sendDocument"
chat_id	String	Yes	Unique identifier for the target Chat or User_id.
name	String	Optional	Name of document
size	String	Optional	Size of document
document	String	Yes	Document: pass a media_id as a string to a file that exists on the nandbox servers.
caption	String	Optional	Document 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": "sendDocument",
       "chat_id": "45874412013335894",
       "reference": 96181774767671,
       "caption": "CV.Brian",
       "name": 22,
       "size": 700
   }

java
// SEND DOCUMENT

else if (incomingMsg.getText().toLowerCase().equals("document")) {
	api.sendText(incomingMsg.getChat().getId(),"Uploading the document to the server...");
	String uploadedDocumentId = MediaTransfer.uploadFile(TOKEN, System.getProperty("user.dir") + "/src/main/resources/upload/malala.pdf");
	DocumentOutMessage documentMsg = new DocumentOutMessage();
	documentMsg.setChatId(incomingMsg.getChat().getId());
	documentMsg.setReference(Utils.getUniqueId());
	documentMsg.setCaption("Audio From Bot");
	if (uploadedDocumentId != null) {
		documentMsg.setDocument(uploadedDocumentId);
		documentMsg.setName("Malala Book");
		api.send(documentMsg);
	} else {
		System.out.println("Upload Failed");
	}
}

javascript
MediaTransfer.uploadFile(
  TOKEN,
  "./your_document.pdf",
  config.UploadServer
).then((uploadedDocumentId) => {
  let documentOutMsg = new DocumentOutMessage();
  documentOutMsg.chat_id = incomingMsg.chat.id;
  documentOutMsg.reference = Id();
  documentOutMsg.document = uploadedDocumentId;
  documentOutMsg.name = "Document renamed inside Bot";
  documentOutMsg.caption = "Document From Bot";

  api.send(JSON.stringify(documentOutMsg));
});

python

napi.send_document("chatId","documentId",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"
    }
}