POST/api/global-chatbot/demo/voice-transcribe
Zamienia nagranie głosowe na stronie demo na tekst (wejście głosowe), jeśli funkcja głosowa demo jest włączona.
Wyślij `visitor_id` (UUID) i plik audio w polu `audio` jako `multipart/form-data`. Odpowiedź zawiera rozpoznany tekst. Endpoint odpowiada `POST /api/public/widget/voice-transcribe`, ale jest powiązany z demo na zentor-app.de. Przypadki błędów: 400 `INVALID_VISITOR_ID` (brakujący lub nieprawidłowy UUID), 403 `ORIGIN_DENIED` (wywołanie nie z zentor-app.de), 413 `AUDIO_TOO_LARGE` (plik za duży) i 415 `AUDIO_TYPE_UNSUPPORTED` (format nieobsługiwany).
Przegląd
Wywołanie: POST /api/global-chatbot/demo/voice-transcribe. Ten endpoint należy do grupy „Chatbot demonstracyjny i SSO” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: visitor_id (body), audio (body). Udokumentowane przypadki błędów: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. 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: Nie
Parametry
visitor_id(body, string, wymagane)— ID odwiedzającego, musi być prawidłowym UUIDaudio(body, file, wymagane)— Plik audio (`multipart/form-data`)Przykładowa odpowiedź
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id musi być prawidłowym UUID."}}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.413 AUDIO_TOO_LARGE — Plik audio przekracza dopuszczalny rozmiar.415 AUDIO_TYPE_UNSUPPORTED — Format audio nie jest obsługiwany.Zweryfikowane zachowanie
Nieprawidłowy `visitor_id` zwraca 400 `INVALID_VISITOR_ID`, wywołanie z innej domeny zwraca 403 `ORIGIN_DENIED`. 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-speakZamienia tekst na mowę (wyjście głosowe na stronie demo), 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.