OpenIntegrations/docs/en/md/Telegram/Data-sending/Send-document.mdx

---
sidebar_position: 5
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Send document
 Sends a document to a chat or channel



`Function SendDocument(Val Token, Val ChatID, Val Text, Val Document, Val Keyboard = "", Val Markup = "Markdown", Val FileName = "") Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | Token | --token | String | ✔ | Bot token |
  | ChatID | --chat | String, Number | ✔ | Target chat ID or ChatID*TopicID |
  | Text | --text | String | ✔ | Message text |
  | Document | --doc | BinaryData, String | ✔ | Document file |
  | Keyboard | --keyboard | String | ✖ | Keyboard. See FormKeyboardFromButtonArray |
  | Markup | --parsemode | String | ✖ | Text processing type (HTML, Markdown, MarkdownV2) |
  | FileName | --filename | String | ✖ | Custom displayed file name with extension, if necessary |

  
  Returns:  Map Of KeyAndValue - serialized JSON response from Telegram

<br/>

:::tip
Method at API documentation: [sendDocument](https://core.telegram.org/bots/api#senddocument)<br/>
Parameters with Binary data type can also accept file paths on disk and URLs
:::
<br/>


```bsl title="1C:Enterprise/OneScript code example"
    Token     = "6129457865:AAFyzNYOAFbu...";
    ChatID    = "461699897";
    ChannelID = "@testsichee";
    Text      = "Строковое значение";
    Document  = "https://api.athenaeum.digital/test_data/document.docx";

    DocumentPath = GetTempFileName("docx");
    CopyFile(Document, DocumentPath);

    DocumentDD = New BinaryData(DocumentPath);

    Result = OPI_Telegram.SendDocument(Token, ChatID, Text, Document);

    Result = OPI_Telegram.SendDocument(Token, ChatID, Text, Document, , , "customname.docx");

    Result = OPI_Telegram.SendDocument(Token, ChannelID, Text, DocumentPath);

    Result = OPI_Telegram.SendDocument(Token, ChannelID, Text, DocumentDD, , , "customname.docx");
```
 

 <Tabs>
  
    <TabItem value="bash" label="Bash" default>
        ```bash
            oint telegram SendDocument \
             --token "***" \
             --chat "@testsichee" \
             --text "Строковое значение" \
             --doc "C:\Users\Administrator\AppData\Local\Temp\noku1z2d43c.docx" \
             --filename "custom.docx"
        ```
    </TabItem>
  
    <TabItem value="bat" label="CMD/Bat" default>
        ```batch
            oint telegram SendDocument ^
             --token "***" ^
             --chat "@testsichee" ^
             --text "Строковое значение" ^
             --doc "C:\Users\Administrator\AppData\Local\Temp\noku1z2d43c.docx" ^
             --filename "custom.docx"
        ```
    </TabItem>
</Tabs>


```json title="Result"
{
 "ok": true,
 "result": {
  "message_id": 8307,
  "from": {
   "id": 6129457865,
   "is_bot": true,
   "first_name": "Бот Виталий",
   "username": "sicheebot"
  },
  "chat": {
   "id": 461699897,
   "first_name": "Anton",
   "last_name": "Titowets",
   "username": "JKIee",
   "type": "private"
  },
  "date": 1728453390,
  "document": {
   "file_name": "document.docx",
   "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
   "file_id": "BQACAgIAAxkDAAIgc2cGGw4a6yPdiNLubNQsFLQQPLHoAAJPWgAC_cg4SJF9HYfiILIbNgQ",
   "file_unique_id": "AgADT1oAAv3IOEg",
   "file_size": 24069
  },
  "caption": "Строковое значение"
 }
}
```