Fichiers audio
Listez, importez, mettez à jour, supprimez les annonces d'accueil, d'attente et de campagne. Le fichier importé est automatiquement converti en mono 8 kHz pour la ligne téléphonique et apparaît sous « Fichiers audio » dans le panneau. Clé du standard (key=K…). Limite de débit : 10 requêtes par minute.
GETListe des fichiers 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 les valeurs dans les campagnes d'appels automatiques media_file_id, pour le clic pour appeler announcement_to_* est utilisé comme.
POSTImporter un nouveau fichier 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…| Paramètre | Obligatoire | Description |
|---|---|---|
name | oui | Nom affiché dans la liste |
sounddata | oui | Contenu du fichier, Data URL sous la forme : data:<mime>;name:<dosyaadı>;base64,<içerik> |
Extensions acceptées : wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. 20 Mo maximum.
Réponse 200 OK, l'id du nouvel enregistrement dans le corps (859).
PUTMettre à jour le fichier 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,…Uniquement pour changer le nom sounddata n'envoyez pas. Réponse OK.
DELETESupprimer le fichier audio
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Un fichier utilisé dans un IVR, une file ou une campagne ne peut pas être supprimé ; 400 announcement in use renvoie.
Annonce à partir du texte
Pour saisir le texte et le synthétiser (TTS) dans les campagnes d'appels automatiques tts_template utilisez-le ou générez-le depuis panneau > Studio de synthèse vocale ; les fichiers générés dans le studio figurent aussi dans cette liste [Stüdyo] arrive avec l'étiquette.
Exemple : envoi avec 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"