Səs faylı siyahısı Yeni səs faylı yüklə Səs faylını yenilə Səs faylını sil Mətndən anons Nümunə: PHP ilə yükləmə

Səs Faylları

Qarşılama, gözləmə və kampaniya anonslarını siyahılayın, yükləyin, yeniləyin, silin. Yüklənən fayl telefon xətti üçün avtomatik olaraq 8 kHz mono-ya çevrilir və paneldə "Səs Faylları" altında görünür. Santral açarı (key=K…). Sürət limiti: dəqiqədə 10 sorğu.

GETSəs faylı siyahısı

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 dəyərləri avtomatik zəng kampaniyalarında media_file_id, kliklə-zəngdə announcement_to_* olaraq istifadə olunur.

POSTYeni səs faylı yüklə

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…

Parametr	Məcburi	İzah
`name`	bəli	Siyahıda görünəcək ad
`sounddata`	bəli	Fayl məzmunu, Data URL formatında: `data:<mime>;name:<dosyaadı>;base64,<içerik>`

Qəbul edilən uzantılar: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Ən çox 20 MB.

Cavab 200 OK, gövdədə yeni qeydin id-si (859).

PUTSəs faylını yenilə

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,…

Yalnız adı dəyişdirmək üçün sounddata göndərməyin. Cavab OK.

DELETESəs faylını sil

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

Bir IVR, növbə ya da kampaniyada istifadə olunan fayl silinə bilməz; 400 announcement in use qaytarır.

Mətndən anons

Mətni yazıb səsləndirmək (TTS) üçün avtomatik zəng kampaniyalarında tts_template istifadə edin ya da panel > Səsləndirmə Studiyasından yaradın; studiyada yaradılan fayllar da bu siyahıda [Stüdyo] etiketi ilə gəlir.

Nümunə: PHP ilə yükləmə

$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"

← Qara siyahı Avtomatik Zəng