音声ファイル
挨拶、待機、キャンペーンのアナウンスを一覧表示、アップロード、更新、削除できます。アップロードしたファイルは電話回線用に自動で8 kHzモノラルに変換され、パネルの「音声ファイル」に表示されます。 交換機キー (key=K…）。レート制限：1分あたり10リクエスト。
GET音声ファイル一覧
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 の値は自動発信キャンペーンで media_file_id、クリックで発信で announcement_to_* として使用されます。
POST新しい音声ファイルをアップロード
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…| パラメータ | 必須 | 説明 |
|---|---|---|
name | はい | リストに表示する名前 |
sounddata | はい | ファイルの内容、 Data URL 形式： data:<mime>;name:<dosyaadı>;base64,<içerik> |
受け付ける拡張子： wav mp3 wma m4a aac ac3 amr flac gsm mpeg mp1 mp2 ra spx ogg 3gp。最大20 MB。
レスポンス 200 OK、本文に新規レコードのID（859).
PUT音声ファイルを更新
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,…名前のみを変更するには sounddata 送信しないでください。レスポンス OK.
DELETE音声ファイルを削除
DELETE https://api.buluthat.com/api/announcements.php/859?key=K…IVR、列、キャンペーンで使用されているファイルは削除できません。 400 announcement in use を返します。
テキストからアナウンスを作成
テキストを入力して音声合成（TTS）するには、自動発信キャンペーンで tts_template を使うか、パネル > 音声スタジオで作成してください。スタジオで作成したファイルもこのリストに [Stüdyo] のラベル付きで届きます。
例：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"