Звукові файли
Переглядайте, завантажуйте, оновлюйте, видаляйте привітальні оголошення, оголошення очікування та кампаній. Завантажений файл автоматично перетворюється на 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, у клік-дзвінку 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"