Audiodateien
Listen, laden, aktualisieren und löschen Sie Begrüßungs-, Warte- und Kampagnenansagen. Die hochgeladene Datei wird automatisch für die Telefonleitung in 8 kHz Mono umgewandelt und erscheint im Panel unter „Audiodateien“. Telefonanlagenschlüssel (key=K…). Ratenbegrenzung: 10 Anfragen pro Minute.
GETListe der Audiodateien
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 Werte in Auto-Call-Kampagnen media_file_id, bei Click-to-call announcement_to_* wird verwendet als.
POSTNeue Audiodatei hochladen
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…| Parameter | Pflichtfeld | Beschreibung |
|---|---|---|
name | ja | In der Liste anzuzeigender Name |
sounddata | ja | Dateiinhalt, Data URL im Format: data:<mime>;name:<dosyaadı>;base64,<içerik> |
Akzeptierte Dateiendungen: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Höchstens 20 MB.
Antwort 200 OK, im Body die ID des neuen Datensatzes (859).
PUTAudiodatei aktualisieren
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,…Nur um den Namen zu ändern sounddata nicht senden. Antwort OK.
DELETEAudiodatei löschen
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Eine Datei, die in einem IVR, einer Warteschlange oder Kampagne verwendet wird, kann nicht gelöscht werden; 400 announcement in use kommt zurück.
Ansage aus Text
Zum Schreiben und Vertonen (TTS) von Text in Auto-Call-Kampagnen tts_template verwenden oder im Panel > Sprachstudio erzeugen; im Studio erzeugte Dateien stehen ebenfalls in dieser Liste [Stüdyo] kommt mit dem Etikett.
Beispiel: Hochladen mit 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"