---
sidebar_position: 3
---

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



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

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

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

<br/>

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

 Метод в документации API: [POST /messages/sendVoice](https://teams.vk.com/botapi/#/messages/post_messages_sendVoice)
:::
<br/>


```bsl title="Пример кода"
    Токен         = "001.3501506236.091...";
    IDЧата        = "689203963@chat.agent";
    IDЦитируемого = "7404833070697677387";
    Текст         = "Подпись к файлу";

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

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

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

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

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

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



```sh title="Пример команды CLI"
    
  oint vkteams ОтправитьГолосовоеСообщение --token "001.3501506236.091..." --chatid "689203963@chat.agent" --file "https://openintegrations.dev/test_data/song.m4a" --type %type% --reply "7401868177463836806" --keyboard %keyboard%

```

```json title="Результат"
{
 "fileId": "I000bAvKAbBkpO2IN0gXEY66c0998a1bd",
 "msgId": "7404086605381632210",
 "ok": true
}
```
