1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2025-04-13 11:50:53 +02:00

115 lines
4.6 KiB
Plaintext
Raw Normal View History

2024-10-15 10:50:56 +03:00
---
2024-10-15 10:16:04 +03:00
sidebar_position: 5
---
2024-10-15 10:50:56 +03:00
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
2024-10-15 10:16:04 +03:00
# Отправить документ
Отправляет документ в чат или канал
`Функция ОтправитьДокумент(Знач Токен, Знач IDЧата, Знач Текст, Знач Документ, Знач Клавиатура = "", Знач Разметка = "Markdown", Знач ИмяФайла = "") Экспорт`
2024-10-15 15:15:47 +03:00
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|-|-|-|-|-|
| Токен | --token | Строка | ✔ | Токен бота |
| IDЧата | --chat | Строка,Число | ✔ | ID целевого чата или IDЧата*IDТемы |
| Текст | --text | Строка | ✔ | Текст сообщения |
| Документ | --doc | ДвоичныеДанные, Строка | ✔ | Файл документа |
| Клавиатура | --keyboard | Строка | ✖ | Клавиатура. См. СформироватьКлавиатуруПоМассивуКнопок |
| Разметка | --parsemode | Строка | ✖ | Вид обработки текста (HTML, Markdown, MarkdownV2) |
| ИмяФайла | --filename | Строка | ✖ | Отображаемое имя файла c расширением, если необходимо |
2024-10-15 10:16:04 +03:00
Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Telegram
<br/>
:::tip
2024-10-29 17:14:45 +03:00
Метод в документации API: [sendDocument](https://core.telegram.org/bots/api#senddocument)<br/>
2024-10-15 13:51:58 +03:00
Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL
2024-10-15 10:16:04 +03:00
:::
<br/>
2024-10-15 21:15:56 +03:00
```bsl title="Пример использования для 1С:Предприятие/OneScript"
2024-10-15 10:16:04 +03:00
Токен = "6129457865:AAFyzNYOAFbu...";
IDЧата = "461699897";
IDКанала = "@testsichee";
Текст = "Строковое значение";
Документ = "https://api.athenaeum.digital/test_data/document.docx";
ДокументПуть = ПолучитьИмяВременногоФайла("docx");
КопироватьФайл(Документ, ДокументПуть);
ДокументДД = Новый ДвоичныеДанные(ДокументПуть);
Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDЧата, Текст, Документ);
Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDЧата, Текст, Документ, , , "customname.docx");
Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDКанала, Текст, ДокументПуть);
Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDКанала, Текст, ДокументДД, , , "customname.docx");
```
<Tabs>
<TabItem value="bash" label="Bash" default>
```bash
2024-10-15 14:13:44 +03:00
oint telegram ОтправитьДокумент \
2024-10-15 13:07:09 +03:00
--token "***" \
2024-10-15 10:16:04 +03:00
--chat "@testsichee" \
--text "Строковое значение" \
2024-11-17 21:35:22 +03:00
--doc "C:\Users\Administrator\AppData\Local\Temp\meww5rh3jwf.docx" \
2024-10-15 10:16:04 +03:00
--filename "custom.docx"
```
</TabItem>
<TabItem value="bat" label="CMD/Bat" default>
```batch
2024-10-15 14:13:44 +03:00
oint telegram ОтправитьДокумент ^
2024-10-15 10:16:04 +03:00
--token "***" ^
--chat "@testsichee" ^
--text "Строковое значение" ^
2024-11-17 21:35:22 +03:00
--doc "C:\Users\Administrator\AppData\Local\Temp\meww5rh3jwf.docx" ^
2024-10-15 10:16:04 +03:00
--filename "custom.docx"
```
</TabItem>
</Tabs>
```json title="Результат"
{
"ok": true,
"result": {
"message_id": 8279,
"from": {
"id": 6129457865,
"is_bot": true,
"first_name": "Бот Виталий",
"username": "sicheebot"
},
"chat": {
"id": 461699897,
"first_name": "Anton",
"last_name": "Titowets",
"username": "JKIee",
"type": "private"
},
"date": 1728408314,
"document": {
"file_name": "document.docx",
"mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"file_id": "BQACAgIAAxkDAAIgV2cFavr7Sbt50mNnaTLorEcjT60bAAKLXQAC_cgwSJNNK5mZj9GxNgQ",
"file_unique_id": "AgADi10AAv3IMEg",
"file_size": 24069
},
"caption": "Строковое значение"
}
}
```