Lista de ficheiros de áudio Carregar novo ficheiro de áudio Atualizar ficheiro de áudio Eliminar ficheiro de áudio Anúncio a partir de texto Exemplo: carregamento com PHP

Ficheiros de Áudio

Liste, carregue, atualize e elimine anúncios de boas-vindas, de espera e de campanha. O ficheiro carregado é convertido automaticamente para mono 8 kHz para a linha telefónica e aparece no painel em "Ficheiros de Áudio". Chave da central (key=K…). Limite de pedidos: 10 por minuto.

GETLista de ficheiros de áudio

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 valores em campanhas de chamadas automáticas media_file_id, no click-to-call announcement_to_* é utilizado como.

POSTCarregar novo ficheiro de áudio

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	Obrigatório	Descrição
`name`	sim	Nome a apresentar na lista
`sounddata`	sim	Conteúdo do ficheiro, Data URL no formato: `data:<mime>;name:<dosyaadı>;base64,<içerik>`

Extensões aceites: wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp. No máximo 20 MB.

Resposta 200 OK, no corpo o id do novo registo (859).

PUTAtualizar ficheiro de áudio

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,…

Apenas para alterar o nome sounddata não envie. Resposta OK.

DELETEEliminar ficheiro de áudio

DELETE https://api.buluthat.com/api/announcements.php/859?key=K…

Um ficheiro utilizado num IVR, fila ou campanha não pode ser eliminado; 400 announcement in use devolve.

Anúncio a partir de texto

Para escrever o texto e sintetizá-lo (TTS), nas campanhas de chamadas automáticas tts_template use ou produza no painel > Estúdio de Síntese de Voz; os ficheiros produzidos no estúdio também aparecem nesta lista [Stüdyo] vem com a etiqueta.

Exemplo: carregamento com 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"

← Lista negra Chamadas Automáticas