Geluidsbestanden
Geef welkomst-, wacht- en campagneaankondigingen weer, upload, werk bij en verwijder ze. Het geüploade bestand wordt automatisch omgezet naar 8 kHz mono voor de telefoonlijn en verschijnt in het paneel onder "Geluidsbestanden". Telefooncentralesleutel (key=K…). Snelheidslimiet: 10 verzoeken per minuut.
GETLijst van geluidsbestanden
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 waarden bij campagnes voor automatisch bellen media_file_id, bij click-to-call announcement_to_* wordt gebruikt als.
POSTNieuw geluidsbestand uploaden
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 | Verplicht | Omschrijving |
|---|---|---|
name | ja | Naam die in de lijst wordt getoond |
sounddata | ja | Bestandsinhoud, Data URL in het formaat: data:<mime>;name:<dosyaadı>;base64,<içerik> |
Geaccepteerde extensies: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Maximaal 20 MB.
Antwoord 200 OK, in de body het id van het nieuwe record (859).
PUTGeluidsbestand bijwerken
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,…Alleen om de naam te wijzigen sounddata niet meesturen. Antwoord OK.
DELETEGeluidsbestand verwijderen
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Een bestand dat in een IVR, wachtrij of campagne wordt gebruikt, kan niet worden verwijderd; 400 announcement in use geeft terug.
Aankondiging uit tekst
Om tekst in te spreken (TTS) in campagnes voor automatisch bellen tts_template gebruik of genereer ze via het paneel > Spraakstudio; ook in de studio gegenereerde bestanden staan in deze lijst [Stüdyo] komt met het label.
Voorbeeld: uploaden met 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"