Pliki audio
Wyświetlaj, przesyłaj, aktualizuj i usuwaj komunikaty powitalne, oczekiwania i kampanii. Przesłany plik jest automatycznie konwertowany do mono 8 kHz dla linii telefonicznej i widoczny w panelu w „Plikach audio”. Klucz centrali (key=K…). Limit zapytań: 10 na minutę.
GETLista plików audio
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 wartości w kampaniach automatycznych połączeń media_file_id, w click-to-call announcement_to_* używane jako.
POSTPrześlij nowy plik audio
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 | Wymagane | Opis |
|---|---|---|
name | tak | Nazwa widoczna na liście |
sounddata | tak | Zawartość pliku, Data URL w formacie: data:<mime>;name:<dosyaadı>;base64,<içerik> |
Akceptowane rozszerzenia: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Maksymalnie 20 MB.
Odpowiedź 200 OK, w treści identyfikator nowego rekordu (859).
PUTZaktualizuj plik audio
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,…Tylko aby zmienić nazwę sounddata nie wysyłaj. Odpowiedź OK.
DELETEUsuń plik audio
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Plik używany w IVR, kolejce lub kampanii nie może zostać usunięty; 400 announcement in use zwraca.
Komunikat z tekstu
Aby wpisać tekst i go zsyntezować (TTS), w kampaniach automatycznych połączeń tts_template użyj lub wygeneruj w panelu > Studio syntezy mowy; pliki wygenerowane w studiu są też na tej liście [Stüdyo] przychodzi z etykietą.
Przykład: przesyłanie przez 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"