الملفات الصوتية
اعرضوا مقاطع الترحيب والانتظار والحملات وارفعوها وحدّثوها واحذفوها. يُحوَّل الملف المرفوع تلقائيًا إلى 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"