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

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

`POST /api/global-chatbot/demo/voice-speak` mengubah teks menjadi suara yang diucapkan, asalkan fungsi suara diaktifkan untuk demo. Titik akhir ini digunakan oleh halaman demo publik dan tidak dimaksudkan sebagai API teks-ke-suara umum yang dapat digunakan secara bebas. Autentikasi dashboard tidak diperlukan, melainkan berlaku pemeriksaan Origin tetap untuk `https://zentor-app.de` dan `https://www.zentor-app.de`. Permintaan berisi teks yang akan diucapkan serta opsi bahasa sesuai skema yang didokumentasikan. Klien hanya boleh mengirim teks yang benar-benar akan diucapkan dalam dialog demo. Input kosong, format tidak valid, atau fungsi suara yang tidak diaktifkan harus ditangani sebagai kesalahan. Perubahan lokal pada Origin atau panggilan dari domain pihak ketiga tidak akan melewati pemeriksaan sisi server. Operasi ini menghasilkan audio dan oleh karena itu tidak boleh dianggap sebagai operasi baca murni yang idempoten. Pengiriman teks yang sama berulang kali dapat memicu beberapa proses pemrosesan. Antarmuka demo harus menonaktifkan tombol output selama pemrosesan berlangsung dan menghentikan pemutaran yang sedang berjalan dengan bersih sebelum memulai yang baru. Alur kerja yang realistis dimulai dengan jawaban bot dalam demo. Pengguna mengaktifkan output suara, halaman mengirim teks jawaban ke `voice-speak`, menerima data audio atau respons audio yang didokumentasikan, dan memutarkannya di browser. Jika permintaan gagal karena Origin tidak diizinkan, antarmuka tidak boleh memanggil layanan pengganti sembarangan, melainkan harus menampilkan fungsi suara sebagai tidak tersedia. Kata sandi, token, atau konten rahasia tidak boleh dimasukkan ke dalam permintaan. Saluran demo bersifat publik dan tidak dimaksudkan untuk data perusahaan yang rahasia. Respons audio juga tidak boleh disimpan secara permanen dalam log publik. Titik akhir ini secara teknis terpisah dari SIP Voicebot. Teleponi berjalan dalam instans SIP yang terisolasi per penyewa dan hanya diaktifkan oleh Master Admin; `voice-speak` tidak mengontrol nomor telepon dan tidak memulai panggilan telepon. Untuk aksesibilitas, demo harus selalu menampilkan teks lengkap selain output suara. Output suara tidak boleh mengandung informasi yang hilang secara visual. Browser dapat memblokir pemutaran selama tidak ada interaksi pengguna; oleh karena itu, pemicu harus dimulai secara sadar melalui klik. Penghentian dan pemutaran ulang harus dapat dikendalikan dengan baik.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Fungsi suara saat ini tidak tersedia."}}