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

Pretvori besedilo v govor (glasovni izhod na demo strani), če je glasovna funkcija demo verzije aktivirana.

Pošljite `visitor_id` (UUID) in besedilo za branje v `text`. Odgovor vsebuje avdio podatke za predvajanje; za element `<audio>` je ista pot dodatno na voljo prek GET. Končna točka ustreza `POST /api/public/widget/voice-speak`, vendar je vezana na demo na zentor-app.de in ni mišljena kot splošni vmesnik za pretvorbo besedila v govor. Primeri napak: 400 `INVALID_VISITOR_ID` (manjkajoč ali neveljaven UUID), 403 `ORIGIN_DENIED` (klic ni iz zentor-app.de) in 503 `VOICE_UNAVAILABLE` (glasovna funkcija trenutno ni na voljo).

Pregled

Klic: POST /api/global-chatbot/demo/voice-speak. Ta endpoint spada v skupino »Demo klepetalni robot in SSO« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic je idempotenten: ponovljeni klici z enakimi podatki vrnejo enak rezultat. Obvezni parametri: visitor_id (body), text (body). Dokumentirani primeri napak: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Sprejme samo klice z https://zentor-app.de in https://www.zentor-app.de; žeton za vdelavo za demo ni potreben.

Idempotentno: Da

Parametri

visitor_id(body, string, obvezno)— ID obiskovalca, mora biti veljaven UUID
text(body, string, obvezno)— Besedilo, ki naj se prebere

Primer odgovora

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funkcija govora trenutno ni na voljo."}}

Kode napak

400 INVALID_VISITOR_ID — `visitor_id` manjka ali ni veljaven UUID.
403 ORIGIN_DENIED — Klic ne prihaja iz zentor-app.de.
503 VOICE_UNAVAILABLE — Glasovna funkcija trenutno ni na voljo.

Preverjeno vedenje

Neveljaven `visitor_id` vrne 400 `INVALID_VISITOR_ID`, nedosegljiva glasovna funkcija 503 `VOICE_UNAVAILABLE`. Primer uspeha je mogoč samo iz zentor-app.de.

Demo klepetalni robot in SSO

POST /api/global-chatbot/demoPošlje sporočilo javnemu demo klepetalnemu robotu na zentor-app.de/demo in vrne njegov odgovor. Demo lahko preizkusite v brskalniku brez registracije.GET /api/global-chatbot/demo/historyNaloži dotedanji potek sporočil demo pogovora, da se ohrani ob ponovnem odprtju demo verzije.POST /api/global-chatbot/demo/pollPridobi nova sporočila demo pogovora, na primer ko je sodelavec Zentor prevzel pogovor. Demo stran kliče končno točko v presledkih.POST /api/global-chatbot/demo/ratingShrani oceno demo pogovora (koristno ali nekoristno) z neobveznim komentarjem.POST /api/global-chatbot/demo/trackZajema anonimne dogodke uporabe demo strani za statistiko obiskovalcev Zentor.POST /api/global-chatbot/demo/voice-transcribePretvori glasovni posnetek na demo strani v besedilo (govorni vnos), če je glasovna funkcija demo verzije aktivirana.GET /api/sso/:tenantSlug/statusPreveri, ali je za račun nastavljena enotna prijava (SAML ali OIDC). Stran za prijavo uporabi rezultat za ponudbo prijave SSO.GET /api/sso/:tenantSlug/oidc/startSproži prijavo prek OpenID Connect in preusmeri brskalnik na nastavljenega ponudnika identitete.GET /api/sso/:tenantSlug/oidc/callbackSprejme preusmeritev ponudnika identitete po prijavi OIDC in preusmeri brskalnik nazaj na Zentor App.GET /api/sso/:tenantSlug/saml/startSproži prijavo prek SAML in preusmeri brskalnik na nastavljenega ponudnika identitete.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): sprejme podpisan odgovor SAML ponudnika identitete prek obrazca POST.GET /api/sso/:tenantSlug/saml/metadataVrne SAML metapodatke Zentor App (XML) za uvoz v vašega ponudnika identitete.

Sorodni članki

← Demo klepetalni robot in SSO