Отправить голосовое сообщение

Отправляет аудиофайл в качестве голосового сообщения

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

Функция ОтправитьГолосовоеСообщение(Знач Токен, Знач IDЧата, Знач Файл, Знач ТипФайла = "m4a", Знач IDЦитируемого = 0, Знач Клавиатура = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
Токен	--token	Строка	✔	Токен бота
IDЧата	--chatid	Строка, Число	✔	ID чата для отправки файла
Файл	--file	ДвоичныеДанные, Строка	✔	Файл для отправки
ТипФайла	--type	Строка	✖	Тип аудиофайла: aac, ogg или m4a
IDЦитируемого	--reply	Строка, Число	✖	ID цитируемого сообщения, если необходимо
Клавиатура	--keyboard	Массив Из Строка	✖	Кнопки к сообщению, если необходимо

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

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

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

подсказка

Если вы хотите, чтобы клиент отображал этот файл как воспроизводимое голосовое сообщение, он должен быть в формате aac, ogg или m4a

Метод в документации API: POST /messages/sendVoice

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

Пример использования для 1С:Предприятие/OneScript
    Токен         = "001.3501506236.091...";
    IDЧата        = "689203963@chat.agent";
    IDЦитируемого = "7567354422724936211";

    Файл     = "https://hut.openintegrations.dev/test_data/song.m4a";        // URL
    ФайлПуть = ПолучитьИмяВременногоФайла("m4a");   // Путь

    КопироватьФайл(Файл, ФайлПуть);

    ФайлДД = Новый ДвоичныеДанные(ФайлПуть);      // Двоичные

    Результат = OPI_VKTeams.ОтправитьГолосовоеСообщение(Токен, IDЧата, Файл);

    Результат = OPI_VKTeams.ОтправитьГолосовоеСообщение(Токен, IDЧата, ФайлПуть, , IDЦитируемого);

    Результат = OPI_VKTeams.ОтправитьГолосовоеСообщение(Токен, IDЧата, ФайлДД);

Bash
CMD/Bat

    oint vkteams ОтправитьГолосовоеСообщение \
      --token "***" \
      --chatid "***" \
      --file "/tmp/logvvsmp.z1h"

    oint vkteams ОтправитьГолосовоеСообщение ^
      --token "***" ^
      --chatid "***" ^
      --file "/tmp/logvvsmp.z1h"

Результат
{
 "fileId": "I000bPbL0vwoP5cx5Mp4SW6a1572c71bd",
 "msgId": "7644142141555366015",
 "ok": true
}