Ses Dosyaları
Karşılama, bekleme ve kampanya anonslarını listeleyin, yükleyin, güncelleyin, silin. Yüklenen dosya telefon hattı için otomatik olarak 8 kHz mono'ya çevrilir ve panelde "Ses Dosyaları" altında görünür. Santral anahtarı (key=K…). Hız sınırı: dakikada 10 istek.
GETSes dosyası listesi
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 değerleri otomatik arama kampanyalarında media_file_id, tıkla-ara'da announcement_to_* olarak kullanılır.
POSTYeni ses dosyası yükle
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…| Parametre | Zorunlu | Açıklama |
|---|---|---|
name | evet | Listede görünecek ad |
sounddata | evet | Dosya içeriği, Data URL biçiminde: data:<mime>;name:<dosyaadı>;base64,<içerik> |
Kabul edilen uzantılar: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. En fazla 20 MB.
Cevap 200 OK, gövdede yeni kaydın id'si (859).
PUTSes dosyasını güncelle
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ızca adı değiştirmek için sounddata göndermeyin. Cevap OK.
DELETESes dosyasını sil
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Bir IVR, kuyruk ya da kampanyada kullanılan dosya silinemez; 400 announcement in use döner.
Metinden anons
Metni yazıp seslendirmek (TTS) için otomatik arama kampanyalarında tts_template kullanın ya da panel > Seslendirme Stüdyosu'ndan üretin; stüdyoda üretilen dosyalar da bu listede [Stüdyo] etiketiyle gelir.
Örnek: PHP ile yükleme
$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"