File audio
Elencate, caricate, aggiornate, eliminate gli annunci di benvenuto, di attesa e di campagna. Il file caricato viene convertito automaticamente in mono a 8 kHz per la linea telefonica e compare nel pannello sotto "File audio". Chiave del centralino (key=K…). Limite di frequenza: 10 richieste al minuto.
GETElenco dei file 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 i valori nelle campagne di chiamata automatica media_file_id, nel click-to-call announcement_to_* viene utilizzato come.
POSTCarica un nuovo file 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…| Parametro | Obbligatorio | Descrizione |
|---|---|---|
name | sì | Nome da mostrare nell'elenco |
sounddata | sì | Contenuto del file, Data URL nel formato: data:<mime>;name:<dosyaadı>;base64,<içerik> |
Estensioni accettate: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Al massimo 20 MB.
Risposta 200 OK, nel corpo l'id del nuovo record (859).
PUTAggiorna il file 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,…Solo per modificare il nome sounddata non inviate. La risposta OK.
DELETEElimina il file audio
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Un file utilizzato in un IVR, in una coda o in una campagna non può essere eliminato; 400 announcement in use restituisce.
Annuncio da testo
Per scrivere il testo e sintetizzarlo (TTS) nelle campagne di chiamata automatica tts_template usate oppure producetelo da pannello > Studio di sintesi vocale; anche i file prodotti nello studio sono in questo elenco [Stüdyo] arriva con l'etichetta.
Esempio: caricamento con 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"