Список аудиофайлов Загрузить новый аудиофайл Обновить аудиофайл Удалить аудиофайл Объявление из текста Пример: загрузка на PHP

Аудиофайлы

Просматривайте, загружайте, обновляйте и удаляйте приветственные объявления, музыку ожидания и объявления для кампаний. Загруженный файл автоматически преобразуется в моно 8 кГц для телефонной линии и отображается в панели в разделе «Аудиофайлы». Ключ АТС (key=K…). Лимит запросов: 10 в минуту.

GETСписок аудиофайлов

GET https://api.buluthat.com/api/announcements.php?key=K…

[
  { "id": 112, "name": "Firmamıza hoş geldiniz" },
  { "id": 113, "name": "Mesai dışındayız" },
  { "id": 115, "name": "Öğle molası" }
]

id значения в кампаниях автодозвона media_file_id, в click-to-call announcement_to_* используется как.

POSTЗагрузить новый аудиофайл

POST https://api.buluthat.com/api/announcements.php
Content-Type: application/x-www-form-urlencoded

key=K…&name=Karşılama+sesi&sounddata=data:audio/mp3;name:anons.mp3;base64,SUQzAwAAAAAH…

Параметр	Обязательно	Описание
`name`	да	Имя, отображаемое в списке
`sounddata`	да	Содержимое файла, Data URL в формате: `data:<mime>;name:<dosyaadı>;base64,<içerik>`

Допустимые расширения: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Не более 20 МБ.

Ответ 200 OK, в теле — id новой записи (859).

PUTОбновить аудиофайл

PUT https://api.buluthat.com/api/announcements.php/859
Content-Type: application/x-www-form-urlencoded

key=K…&name=Karşılama+sesi+v2&sounddata=data:audio/mp3;name:anons2.mp3;base64,…

Только чтобы изменить имя sounddata не отправляйте. Ответ OK.

DELETEУдалить аудиофайл

DELETE https://api.buluthat.com/api/announcements.php/859?key=K…

Файл, используемый в IVR, очереди или кампании, удалить нельзя; 400 announcement in use возвращается.

Объявление из текста

Чтобы написать текст и озвучить его (TTS), в кампаниях автодозвона tts_template используйте или создайте в разделе «Панель > Студия озвучивания»; файлы, созданные в студии, тоже появляются в этом списке [Stüdyo] приходит с меткой.

Пример: загрузка на PHP

$file = 'anons.mp3';
$data = 'data:audio/mp3;name:' . rawurlencode(basename($file)) . ';base64,' . base64_encode(file_get_contents($file));
$ch = curl_init('https://api.buluthat.com/api/announcements.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query(['key' => $key, 'name' => 'Karşılama', 'sounddata' => $data]),
]);
$id = curl_exec($ch);   // "859"

← Чёрный список Автодозвон