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

Pretvori glasovni posnetek na demo strani v besedilo (govorni vnos), če je glasovna funkcija demo verzije aktivirana.

Pošljite `visitor_id` (UUID) in avdio datoteko v polju `audio` kot `multipart/form-data`. Odgovor vsebuje prepoznano besedilo. Končna točka ustreza `POST /api/public/widget/voice-transcribe`, vendar je vezana na demo na zentor-app.de. Primeri napak: 400 `INVALID_VISITOR_ID` (manjkajoč ali neveljaven UUID), 403 `ORIGIN_DENIED` (klic ni iz zentor-app.de), 413 `AUDIO_TOO_LARGE` (datoteka prevelika) in 415 `AUDIO_TYPE_UNSUPPORTED` (format ni podprt).

Pregled

Klic: POST /api/global-chatbot/demo/voice-transcribe. Ta endpoint spada v skupino »Demo klepetalni robot in SSO« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: visitor_id (body), audio (body). Dokumentirani primeri napak: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. 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: Ne

Parametri

visitor_id(body, string, obvezno)— ID obiskovalca, mora biti veljaven UUID
audio(body, file, obvezno)— Avdio datoteka (`multipart/form-data`)

Primer odgovora

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id mora biti veljaven UUID."}}

Kode napak

400 INVALID_VISITOR_ID — `visitor_id` manjka ali ni veljaven UUID.
403 ORIGIN_DENIED — Klic ne prihaja iz zentor-app.de.
413 AUDIO_TOO_LARGE — Avdio datoteka presega dovoljeno velikost.
415 AUDIO_TYPE_UNSUPPORTED — Avdio format ni podprt.

Preverjeno vedenje

Neveljaven `visitor_id` vrne 400 `INVALID_VISITOR_ID`, klic z druge domene 403 `ORIGIN_DENIED`. 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-speakPretvori besedilo v govor (glasovni izhod na demo strani), č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