Отправить аудио

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

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

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

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

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

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

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

подсказка

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

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

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

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

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

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

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

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

Bash
CMD/Bat

    oint telegram ОтправитьАудио \
      --token "***" \
      --chat "***" \
      --text "Строковое значение" \
      --audio "/tmp/soq5gmfz.a5i"

    oint telegram ОтправитьАудио ^
      --token "***" ^
      --chat "***" ^
      --text "Строковое значение" ^
      --audio "/tmp/soq5gmfz.a5i"

Результат
{
 "ok": true,
 "result": {
  "message_id": 21824,
  "from": {
   "id": 6129457865,
   "is_bot": true,
   "first_name": "Бот Виталий",
   "username": "sicheebot"
  },
  "chat": {
   "id": 461699897,
   "first_name": "Anton",
   "last_name": "Titovets",
   "username": "bayselonarrend",
   "type": "private"
  },
  "date": 1779814995,
  "audio": {
   "duration": 228,
   "file_name": "audio",
   "mime_type": "audio/mpeg",
   "title": "Dogs",
   "performer": "Motorhead",
   "file_id": "CQACAgIAAxkDAAJVQGoV0lO8IbGOwP0nv7fJm8uLvpswAAI7nQACTpWxSLVT089fG9gGOwQ",
   "file_unique_id": "AgADO50AAk6VsUg",
   "file_size": 9229352
  },
  "caption": "Строковое значение"
 }
}