Archivos de audio
Liste, cargue, actualice y elimine las locuciones de bienvenida, espera y campaña. El archivo cargado se convierte automáticamente a 8 kHz mono para la línea telefónica y aparece en "Archivos de audio" en el panel. Clave de la central (key=K…). Límite de velocidad: 10 solicitudes por minuto.
GETLista de archivos de 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 los valores en las campañas de llamadas automáticas media_file_id, en clic para llamar announcement_to_* se usa como.
POSTCargar nuevo archivo de 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…| Parámetro | Obligatorio | Descripción |
|---|---|---|
name | sí | Nombre que se mostrará en la lista |
sounddata | sí | Contenido del archivo, Data URL en el formato: data:<mime>;name:<dosyaadı>;base64,<içerik> |
Extensiones aceptadas: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. Máximo 20 MB.
Respuesta 200 OK, el id del nuevo registro en el cuerpo (859).
PUTActualizar archivo de 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 para cambiar el nombre sounddata no envíe. La respuesta OK.
DELETEEliminar archivo de audio
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…Un IVR, cola o campaña; el archivo en uso no se puede eliminar; 400 announcement in use devuelve.
Locución a partir de texto
Para escribir el texto y locutarlo (TTS), en las campañas de llamadas automáticas tts_template utilícelo o genérelo desde Panel > Estudio de locución; los archivos generados en el estudio también aparecen en esta lista [Stüdyo] viene con la etiqueta.
Ejemplo: carga 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"