Отправить файл

Отправляет файл в выбранный чат

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

Функция ОтправитьФайл(Знач ПараметрыДоступа, Знач IDЧата, Знач Файл, Знач ИмяФайла, Знач Описание = "", Знач IDЦитируемого = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
ПараметрыДоступа	--access	Структура Из КлючИЗначение	✔	Параметры доступа. См. `СформироватьПараметрыДоступа`
IDЧата	--chat	Строка	✔	Идентификатор чата
Файл	--file	Строка, ДвоичныеДанные	✔	Данные или путь к файлу
ИмяФайла	--filename	Строка	✔	Имя загружаемого файла с расширением
Описание	--caption	Строка	✖	Текст сообщения под файлом
IDЦитируемого	--quoted	Строка	✖	ID цитируемого сообщения, если необходимо

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

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

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

подсказка

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

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

Пример использования для 1С:Предприятие/OneScript
    ApiUrl           = "https://7105.api.greenapi.com";
    MediaUrl         = "https://7105.media.greenapi.com";
    IdInstance       = "71051...";
    ApiTokenInstance = "425010d90e114aa6b78f0969e...";

    Файл     = "https://hut.openintegrations.dev/test_data/picture.jpg"; // URL, Путь или Двоичные данные
    ИмяФайла = "photo.jpg";
    IDЧата   = "120363410406221140@g.us";
    Описание = "Описание файла";

    ПараметрыДоступа = OPI_GreenAPI.СформироватьПараметрыДоступа(ApiUrl, MediaUrl, IdInstance, ApiTokenInstance);
    Результат        = OPI_GreenAPI.ОтправитьФайл(ПараметрыДоступа, IDЧата, Файл, ИмяФайла, Описание);

Bash
CMD/Bat

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint greenapi ОтправитьФайл \
      --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" \
      --chat "***" \
      --file "https://hut.openintegrations.dev/test_data/video.mp4" \
      --filename "vid.mp4" \
      --caption "Описание файла" \
      --quoted "3EB0A8F765406F2E9AA4EC"

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint greenapi ОтправитьФайл ^
      --access "{'apiUrl':'***','mediaUrl':'https://7105.media.greenapi.com','idInstance':'7105187566','apiTokenInstance':'***'}" ^
      --chat "***" ^
      --file "https://hut.openintegrations.dev/test_data/video.mp4" ^
      --filename "vid.mp4" ^
      --caption "Описание файла" ^
      --quoted "3EB0A8F765406F2E9AA4EC"

Результат
{
 "idMessage": "3EB0A8F765406F2E9AA4EC",
 "urlFile": "https://do-mediaout-7105.fra1.digitaloceanspaces.com/7105187566/432edaea-2336-490f-b612-46f659bc2587..."
}