فایل‌های صوتی
اعلان‌های خوشامد، انتظار و کمپین را فهرست کنید، بارگذاری کنید، به‌روزرسانی کنید، حذف کنید. فایل بارگذاری‌شده خودکار برای خط تلفن به 8 kHz مونو تبدیل می‌شود و در پنل زیر «فایل‌های صوتی» دیده می‌شود. کلید سانترال (key=K…). محدودیت نرخ: 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 مگابایت.
پاسخ 200 OK، در بدنه شناسه رکورد جدید (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"