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" } }

Powered by Notaku