Отправить документ

Отправляет документ в чат или канал

Параметры
Расширенный вызов ?

Функция ОтправитьДокумент(Знач Токен, Знач IDЧата, Знач Текст, Знач Документ, Знач Клавиатура = "", Знач Разметка = "Markdown", Знач ИмяФайла = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
Токен	--token	Строка	✔	Токен бота
IDЧата	--chat	Строка, Число	✔	ID целевого чата или IDЧата*IDТемы
Текст	--text	Строка	✔	Текст сообщения
Документ	--doc	ДвоичныеДанные, Строка	✔	Файл документа
Клавиатура	--keyboard	Строка, Структура Из КлючИЗначение	✖	Клавиатура. См. `СформироватьКлавиатуруПоМассивуКнопок`
Разметка	--parsemode	Строка	✖	Вид обработки текста (HTML, Markdown, MarkdownV2)
ИмяФайла	--filename	Строка	✖	Отображаемое имя файла c расширением, если необходимо

Возвращаемое значение

Соответствие Из КлючИЗначение - сериализованный JSON ответа от Telegram

Параметр	Описание
proxy	`ИнтернетПрокси` или структура полей `Протокол`, `Сервер`, `Порт`, `Пользователь`, `Пароль`, `ИспользоватьАутентификациюОС`
timeout	Таймаут выполнения запроса
adv_response	Оформляет ответ в виде полной структуры HTTP-ответа с полями `code`, `body` и `headers`
retries	Число попыток отправки HTTP-запроса при коде `5**` или внутренних ошибках клиента
dontwait	Создает фоновое задание и возвращает его данные (только для 1С и OneScript)

подсказка

Метод в документации API: sendDocument

Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL

Пример использования для 1С:Предприятие/OneScript
    Токен    = "6129457865:AAFyzNYOAFbu...";
    IDЧата   = "461699897";
    IDКанала = "@testsichee";
    Текст    = "Строковое значение";
    Документ = "https://releases.openintegrations.dev/test_data/document.docx";

    ДокументПуть = ПолучитьИмяВременногоФайла("docx");
    КопироватьФайл(Документ, ДокументПуть);

    ДокументДД = Новый ДвоичныеДанные(ДокументПуть);

    // В чат, по URL
    Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDЧата, Текст, Документ);

    // В чат, по URL, с указанием имени файла
    Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDЧата, Текст, Документ, , , "customname.docx");

    // В канал, на диске
    Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDКанала, Текст, ДокументПуть);

    // В канал, из двоичных данных, с указанием имени файла
    Результат = OPI_Telegram.ОтправитьДокумент(Токен, IDКанала, Текст, ДокументДД, , , "customname.docx");

Bash
CMD/Bat

    oint telegram ОтправитьДокумент \
      --token "***" \
      --chat "***" \
      --text "Строковое значение" \
      --doc "C:\Users\bayselonarrend\AppData\Local\Temp\3qdyhgow.bcw" \
      --filename "customname.docx"

    oint telegram ОтправитьДокумент ^
      --token "***" ^
      --chat "***" ^
      --text "Строковое значение" ^
      --doc "C:\Users\bayselonarrend\AppData\Local\Temp\3qdyhgow.bcw" ^
      --filename "customname.docx"

Результат
{
 "ok": true,
 "result": {
  "message_id": 24463,
  "from": {
   "id": 6129457865,
   "is_bot": true,
   "first_name": "Бот Виталий",
   "username": "sicheebot"
  },
  "chat": {
   "id": 461699897,
   "first_name": "Anton",
   "last_name": "Titovets",
   "username": "bayselonarrend",
   "type": "private"
  },
  "date": 1784488346,
  "document": {
   "file_name": "document.docx",
   "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
   "file_id": "BQACAgIAAxkDAAJfj2pdIZqq1FTNUJUt_XIQLXGm6KU0AAIGmwACabHxSnG9wcP6IulWPQQ",
   "file_unique_id": "AgADBpsAAmmx8Uo",
   "file_size": 24069
  },
  "caption": "Строковое значение"
 }
}