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

Prevádza hlasový záznam na demo stránke na text (hlasový vstup), ak je hlasová funkcia dema aktivovaná.

Odošlite `visitor_id` (UUID) a audio súbor v poli `audio` ako `multipart/form-data`. Odpoveď obsahuje rozpoznaný text. Endpoint zodpovedá `POST /api/public/widget/voice-transcribe`, ale je viazaný na demo na zentor-app.de. Chybové prípady: 400 `INVALID_VISITOR_ID` (chýbajúce alebo neplatné UUID), 403 `ORIGIN_DENIED` (volanie nie z zentor-app.de), 413 `AUDIO_TOO_LARGE` (súbor príliš veľký) a 415 `AUDIO_TYPE_UNSUPPORTED` (nepodporovaný formát).

Prehľad

Volanie: POST /api/global-chatbot/demo/voice-transcribe. Tento endpoint patrí do skupiny „Demo chatbot a SSO“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: visitor_id (body), audio (body). Zdokumentované chybové prípady: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.

Autentifikácia a zabezpečenie

Nevyžaduje sa žiadna autentifikácia

Prijíma iba volania z https://zentor-app.de a https://www.zentor-app.de; pre demo nie je vyžadovaný vkladací token.

Idempotentné: Nie

Parametre

visitor_id(body, string, povinné)— ID návštevníka, musí byť platné UUID
audio(body, file, povinné)— Audio súbor (`multipart/form-data`)

Príklad odpovede

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id musí byť platný UUID."}}

Chybové kódy

400 INVALID_VISITOR_ID — `visitor_id` chýba alebo nie je platné UUID.
403 ORIGIN_DENIED — Volanie nepochádza z zentor-app.de.
413 AUDIO_TOO_LARGE — Audio súbor prekračuje povolenú veľkosť.
415 AUDIO_TYPE_UNSUPPORTED — Formát zvuku nie je podporovaný.

Overené správanie

Neplatné `visitor_id` vracia 400 `INVALID_VISITOR_ID`, volanie z inej domény 403 `ORIGIN_DENIED`. Úspešný prípad je možný iba z zentor-app.de.

Demo chatbot a SSO

POST /api/global-chatbot/demoOdošle správu verejnému demo chatbotovi na zentor-app.de/demo a vráti jeho odpoveď. Demo je možné vyskúšať v prehliadači bez registrácie.GET /api/global-chatbot/demo/historyNačíta doterajšiu históriu správ demo konverzácie, aby sa zachovala pri opätovnom otvorení dema.POST /api/global-chatbot/demo/pollZískava nové správy demo konverzácie, napríklad ak konverzáciu prevzal pracovník Zentoru. Demo stránka volá endpoint v intervaloch.POST /api/global-chatbot/demo/ratingUloží hodnotenie demo konverzácie (užitočná alebo neužitočná) s nepovinným komentárom.POST /api/global-chatbot/demo/trackZaznamenáva anonymné udalosti využitia demo stránky pre štatistiku návštevníkov Zentoru.POST /api/global-chatbot/demo/voice-speakPrevádza text na hovorenú reč (hlasový výstup na demo stránke), ak je hlasová funkcia dema aktivovaná.GET /api/sso/:tenantSlug/statusSkontroluje, či je pre účet nastavené jednotné prihlásenie (SAML alebo OIDC). Prihlasovacia stránka použije výsledok na ponúknutie prihlásenia cez SSO.GET /api/sso/:tenantSlug/oidc/startSpustí prihlásenie cez OpenID Connect a presmeruje prehliadač na nastaveného poskytovateľa identity.GET /api/sso/:tenantSlug/oidc/callbackPrijíma presmerovanie poskytovateľa identity po prihlásení OIDC a presmeruje prehliadač späť na Zentor App.GET /api/sso/:tenantSlug/saml/startSpustí prihlásenie cez SAML a presmeruje prehliadač na nastaveného poskytovateľa identity.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): prijíma podpísanú odpoveď SAML od poskytovateľa identity formulárovým POST.GET /api/sso/:tenantSlug/saml/metadataVracia metadáta SAML Zentor App (XML) na import do vášho poskytovateľa identity.

Súvisiace články

← Demo chatbot a SSO