POST/api/global-chatbot/demo/voice-speak
Zamienia tekst na mowę (wyjście głosowe na stronie demo), jeśli funkcja głosowa demo jest włączona.
Wyślij `visitor_id` (UUID) i tekst do odczytania w `text`. Odpowiedź zawiera dane audio do odtworzenia; dla elementu `<audio>` ta sama ścieżka jest też dostępna przez GET. Endpoint odpowiada `POST /api/public/widget/voice-speak`, ale jest powiązany z demo na zentor-app.de i nie jest przeznaczony jako ogólny interfejs zamiany tekstu na mowę. Przypadki błędów: 400 `INVALID_VISITOR_ID` (brakujący lub nieprawidłowy UUID), 403 `ORIGIN_DENIED` (wywołanie nie z zentor-app.de) i 503 `VOICE_UNAVAILABLE` (funkcja głosowa aktualnie niedostępna).
Przegląd
Wywołanie: POST /api/global-chatbot/demo/voice-speak. Ten endpoint należy do grupy „Chatbot demonstracyjny i SSO” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie jest idempotentne: powtarzane wywołania z tymi samymi danymi zwracają ten sam wynik. Parametry wymagane: visitor_id (body), text (body). Udokumentowane przypadki błędów: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
Przyjmuje tylko wywołania z https://zentor-app.de i https://www.zentor-app.de; dla demo nie jest wymagany token osadzania.
Idempotentny: Tak
Parametry
visitor_id(body, string, wymagane)— ID odwiedzającego, musi być prawidłowym UUIDtext(body, string, wymagane)— Tekst do odczytania na głosPrzykładowa odpowiedź
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funkcja mowy jest obecnie niedostępna."}}Kody błędów
400 INVALID_VISITOR_ID — `visitor_id` jest nieobecne lub nie jest prawidłowym UUID.403 ORIGIN_DENIED — Wywołanie nie pochodzi z zentor-app.de.503 VOICE_UNAVAILABLE — Funkcja głosowa jest aktualnie niedostępna.Zweryfikowane zachowanie
Nieprawidłowy `visitor_id` zwraca 400 `INVALID_VISITOR_ID`, niedostępna funkcja głosowa zwraca 503 `VOICE_UNAVAILABLE`. Przypadek powodzenia jest możliwy tylko z zentor-app.de.
Chatbot demonstracyjny i SSO
POST /api/global-chatbot/demoWysyła wiadomość do publicznego chatbota demonstracyjnego na zentor-app.de/demo i zwraca jego odpowiedź. Demo można wypróbować w przeglądarce bez rejestracji.GET /api/global-chatbot/demo/historyWczytuje dotychczasową historię wiadomości rozmowy demonstracyjnej, aby zachować ją po ponownym otwarciu demo.POST /api/global-chatbot/demo/pollPobiera nowe wiadomości rozmowy demonstracyjnej, np. gdy pracownik Zentor przejął rozmowę. Strona demo wywołuje endpoint w odstępach czasu.POST /api/global-chatbot/demo/ratingZapisuje ocenę rozmowy demonstracyjnej (pomocna lub niepomocna) z opcjonalnym komentarzem.POST /api/global-chatbot/demo/trackRejestruje anonimowe zdarzenia użycia strony demo na potrzeby statystyk odwiedzających Zentor.POST /api/global-chatbot/demo/voice-transcribeZamienia nagranie głosowe na stronie demo na tekst (wejście głosowe), jeśli funkcja głosowa demo jest włączona.GET /api/sso/:tenantSlug/statusSprawdza, czy jednokrotne logowanie (SAML lub OIDC) jest skonfigurowane dla konta. Strona logowania wykorzystuje wynik, aby zaproponować logowanie SSO.GET /api/sso/:tenantSlug/oidc/startUruchamia logowanie przez OpenID Connect i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.GET /api/sso/:tenantSlug/oidc/callbackOdbiera przekierowanie dostawcy identyfikacji po zalogowaniu OIDC i przekierowuje przeglądarkę z powrotem do Zentor App.GET /api/sso/:tenantSlug/saml/startUruchamia logowanie przez SAML i przekierowuje przeglądarkę do skonfigurowanego dostawcy identyfikacji.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): odbiera podpisaną odpowiedź SAML od dostawcy identyfikacji poprzez formularzowy POST.GET /api/sso/:tenantSlug/saml/metadataZwraca metadane SAML Zentor App (XML) do zaimportowania w Państwa dostawcy identyfikacji.