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

Zamienia tekst na mowę (text-to-speech) na potrzeby odtwarzania głosowego na stronie demo, o ile jest włączone.

`POST /api/global-chatbot/demo/voice-speak` konwertuje tekst na mowę, o ile funkcja językowa jest aktywowana w trybie demonstracyjnym. Punkt końcowy jest wykorzystywany przez publiczną stronę demonstracyjną i nie jest przeznaczony do swobodnego użytku jako ogólnodostępna usługa konwersji tekstu na mowę API. Autoryzacja panelu sterowania nie jest wymagana; dla `https://zentor-app.de` i `https://www.zentor-app.de`. obowiązuje stała weryfikacja źródła. Żądanie zawiera tekst do odtworzenia oraz opcje językowe przewidziane w udokumentowanym schemacie. Klient powinien przesyłać wyłącznie tekst, który faktycznie ma zostać odtworzony w dialogu demonstracyjnym. Puste wpisy, nieprawidłowe formaty lub nieaktywowana funkcja językowa muszą być traktowane jako błędy. Zmiana źródła po stronie lokalnej lub wywołanie z innej domeny nie omija serwerowej weryfikacji. Operacja generuje dźwięk i nie może być traktowana jako idempotentna operacja czystego odczytu. Wielokrotne wysłanie tego samego tekstu może wywołać wiele procesów przetwarzania. Interfejs demonstracyjny powinien dezaktywować przycisk wyjścia podczas przetwarzania i poprawnie kończyć bieżące odtwarzanie przed rozpoczęciem nowego. Realistyczny przebieg zaczyna się od odpowiedzi bota w demonstracji. Użytkownik aktywuje wyjście dźwiękowe, strona przesyła tekst odpowiedzi do `voice-speak`, otrzymuje dane audio lub udokumentowaną odpowiedź audio i odtwarza je w przeglądarce. Jeśli żądanie nie powiedzie się z powodu niedozwolonego źródła, interfejs nie powinien wywoływać żadnej zastępczej usługi, lecz powinien wyświetlić komunikat o niedostępności funkcji językowej. Hasła, tokeny lub poufne treści nie powinny być zawarte w żądaniu. Kanał demonstracyjny jest publiczny i nie przeznaczony do poufnych danych firmowych. Odpowiedzi audio również nie powinny być trwale zapisywane w publicznych logach. Punkt końcowy jest technicznie oddzielony od Voicebot SIP. Telefonia działa w izolowanych instancjach SIP dla każdego klienta i jest włączana wyłącznie przez administratora głównego; `voice-speak` nie steruje numerem telefonu ani nie inicjuje połączenia telefonicznego. Dla dostępności osób niepełnosprawnych demonstracja powinna obok wyjścia audio zawsze wyświetlać pełny tekst. Wyjście dźwiękowe nie może zawierać informacji, których nie ma w widoku. Przeglądarki mogą blokować odtwarzanie, dopóki nie nastąpi interakcja użytkownika; dlatego uruchomienie powinno być celowo wywołane kliknięciem. Przerwanie i ponowne odtwarzanie muszą być możliwe do kontroli.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funkcja mowy jest obecnie niedostępna."}}