POST/api/global-chatbot/demo/voice-speak
Mətni səsli nitqə çevirir (Text-to-Speech) demo səhifəsində səs çıxışı üçün, aktiv olduqda.
`POST /api/global-chatbot/demo/voice-speak` mətni səsli nitqə çevirir, əgər demo üçün səs funksiyası aktivdirsə. Endpoint ictimai demo səhifəsi tərəfindən istifadə olunur və sərbəst istifadə edilə bilən ümumi mətn-nitq API-si kimi nəzərdə tutulmayıb. Dashboard autentifikasiyası tələb olunmur, bunun əvəzinə `https://zentor-app.de` və `https://www.zentor-app.de` üçün sabit mənşə yoxlaması tətbiq edilir. Soruğu səsləndiriləcək mətni və sənədləşdirilmiş sxemdə nəzərdə tutulmuş dil seçimlərini ehtiva edir. Müştəri yalnız demo dialoqunda həqiqətən səsləndirilməli olan mətni göndərməlidir. Boş girişlər, yanlış formatlar və ya aktiv edilməmiş səs funksiyası xəta kimi işlənməlidir. Mənşəyin lokal dəyişdirilməsi və ya kənar domendən çağırış server tərəfindəki yoxlamanı keçə bilməz. Əməliyyat audio yaradır və buna görə də idempotent təmiz oxu əməliyyatı kimi qəbul edilməməlidir. Eyni mətnin təkrar göndərilməsi bir neçə emal prosesini tetikleyebilir. Demo interfeysi emal zamanı çıxış düyməsini deaktiv etməli və yeni başlamazdan əvvəl davam edən oxutmaları təmiz şəkildə dayandırmalıdır. Realist bir axın demo-da bot cavabı ilə başlayır. İstifadəçi səs çıxışını aktivləşdirir, səhifə cavab mətnini `voice-speak`-ə göndərir, audio məlumatları və ya sənədləşdirilmiş audio cavabı alır və brauzerdə oxudur. Sorğu icazə verilməyən mənşə səbəbindən uğursuz olarsa, interfeys heç bir təsadüfi əvəzedici xidməti çağırmamalı, əksinə səs funksiyasını əlçatan deyil kimi göstərməlidir. Parollar, tokenlər və ya məxfi məzmunlar sorğuya daxil edilməməlidir. Demo kanalı ictimaiyyətə açıqdır və gizli korporativ məlumatlar üçün nəzərdə tutulmayıb. Audio cavablar da ictimai loglarda daimi saxlanılmamalıdır. Endpoint texniki olaraq SIP voicebot-dan ayrıdır. Telefoniya hər müştəri üçün izolyasiya edilmiş SIP instansiyalarında işləyir və yalnız Master Admin tərəfindən aktivləşdirilir; `voice-speak` heç bir telefon nömrəsini idarə etmir və telefon zəngi başlatmır. Əlçatanlıq üçün demo audio çıxışı ilə yanaşı həmişə tam mətni göstərməlidir. Səs çıxışı vizual olaraq çatışmayan heç bir məlumat ehtiva etməməlidir. Brauzerlər istifadəçi qarşılıqlı əlaqəsi olmadan oxutmanı bloklaya bilər; buna görə də başlanğıc şüurlu şəkildə kliklə tetiklenmelidir. Dayandırma və yenidən oxutma nəzarətli şəkildə mümkün olmalıdır.
Auth & Absicherung
Keine Authentifizierung erforderlich
Origin yoxlaması https://zentor-app.de / https://www.zentor-app.de ünvanına sabitlənib (konfiqurasiya edilə bilməz, demo yolu üzrə widget token üçün əvəz).
Idempotent: Ja
Parameter
visitor_id(body, string, erforderlich)— Etibarlı UUID olmalıdırtext(body, string, erforderlich)— Dilə çevriləcək mətnBeispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Səs funksiyası hazırda mövcud deyil."}}Fehlercodes
400 INVALID_VISITOR_ID — visitor_id yoxdur və ya etibarlı UUID deyil.403 ORIGIN_DENIED — Sorğu mənşəyi zentor-app.de deyil.503 VOICE_UNAVAILABLE — Dil funksiyası hazırda mövcud deyil.Live-Test-Nachweis
Mənfi hallar (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, hər biri düzgün Origin-Header ilə) canlı yoxlanıldı. Eyni yolun GET variantı da mövcuddur (native <audio src> axını, eyni davranış). widget.voice_speak-in demo qarşılığı.