POST/api/global-chatbot/demo/voice-speak

Mengubah teks menjadi bahasa yang diucapkan (Text-to-Speech) untuk output bahasa pada halaman demo, jika diaktifkan.

`POST /api/global-chatbot/demo/voice-speak` menukar teks kepada suara pertuturan, sekiranya fungsi suara diaktifkan untuk demo. Titik akhir ini digunakan oleh halaman demo awam dan tidak direka sebagai API teks-ke-suara (text-to-speech) umum yang boleh digunakan secara bebas. Pengesahan papan pemuka tidak diperlukan, sebaliknya semakan origin tetap dikuatkuasakan untuk `https://zentor-app.de` dan `https://www.zentor-app.de`. Permintaan mengandungi teks yang perlu disuarakan dan pilihan suara yang ditetapkan dalam skema yang didokumenkan. Klien hanya perlu menghantar teks yang benar-benar akan disuarakan dalam dialog demo. Input kosong, format yang tidak sah atau fungsi suara yang tidak diaktifkan mesti dikendalikan sebagai ralat. Perubahan origin secara tempatan atau panggilan daripada domain luar tidak dapat mengelak semakan di pihak pelayan. Operasi ini menghasilkan audio dan oleh itu tidak boleh dianggap sebagai operasi baca (read) tulen yang idempoten. Penghantaran teks yang sama berulang kali boleh mencetuskan beberapa proses pemprosesan. Antara muka demo perlu melumpuhkan butang output semasa pemprosesan berlangsung dan menghentikan main balik yang sedang berjalan secara bersih sebelum memulakan satu yang baharu. Aliran yang realistik bermula dengan jawapan bot dalam demo. Pengguna mengaktifkan output suara, halaman menghantar teks jawapan kepada `voice-speak`, menerima data audio atau respons audio yang didokumenkan, dan memainkannya dalam pelayar. Jika permintaan gagal kerana origin yang tidak dibenarkan, antara muka tidak boleh memanggil sebarang perkhidmatan gantian, sebaliknya perlu memaparkan fungsi suara sebagai tidak tersedia. Kata laluan, token atau kandungan sulit tidak sesuai dalam permintaan ini. Saluran demo bersifat awam dan tidak direka untuk data syarikat yang sulit. Respons audio juga tidak sepatutnya disimpan secara kekal dalam log awam. Titik akhir ini secara teknikal berasingan daripada Zentor SIP-Voicebot. Telefoni berjalan dalam instans SIP yang terasing bagi setiap penyewa (tenant) dan hanya diaktifkan melalui Master Admin; `voice-speak` tidak mengawal sebarang nombor telefon dan tidak memulakan sebarang panggilan telefon. Untuk kebolehcapaian (accessibility), demo perlu sentiasa memaparkan teks penuh di samping output audio. Output suara tidak boleh mengandungi maklumat yang tiada secara visual. Pelayar boleh menyekat main balik selagi tiada interaksi pengguna; oleh itu permulaan perlu dicetuskan secara sengaja melalui klik. Pembatalan dan main balik semula mesti boleh dilakukan secara terkawal.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"fungsi suara tidak tersedia pada masa ini"}}