POST/api/global-chatbot/demo/voice-speak
Iguqula umbhalo ube yinkulumo (umsindo wasekhaya wekhulumo kukhasi lwedemo), uma umsebenzi wenkulumo wedemo uvuliwe.
Thumela `visitor_id` (UUID) nombhalo okufanele ufundwe ku-`text`. Impendulo iqukethe idatha yomsindo yokudlalisa; kwi-elementi ye-`<audio>` kutholakala futhi indlela efanayo nge-GET. Indawo yokungena ihambisana ne-`POST /api/public/widget/voice-speak`, kodwa ibophezelwe kudemo ku-zentor-app.de futhi akuhlosiwe ukuba yindawo yokungena ejwayelekile yomsindo wekhulumo. Izimo zephutha: 400 `INVALID_VISITOR_ID` (i-UUID engekho noma engalungile), 403 `ORIGIN_DENIED` (ukubizwa akuveli ku-zentor-app.de) kanye no-503 `VOICE_UNAVAILABLE` (umsebenzi wekhulumo akatholakali okwamanje).
Ukubuka konke
Ukubiza: POST /api/global-chatbot/demo/voice-speak. Le endpoint ingeyeqembu elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kaningi ngemininingwane efanayo kubuyisa umphumela ofanayo. Amapharamitha ayimpoqo: visitor_id (body), text (body). Izimo zamaphutha ezibhaliwe: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubunikazi nokuvikeleka
Akudingeki ukuqinisekisa ubunikazi
Yamukela kuphela izicelo ezivela ku-https://zentor-app.de ne-https://www.zentor-app.de; ithokheni yokufaka ayidingekile kudemo.
I-idempotent: Yebo
Amapharamitha
visitor_id(body, string, kuyadingeka)— I-ID yesivakashi, kumele ibe i-UUID esemthethwenitext(body, string, kuyadingeka)— Umbhalo omawufundweIsibonelo se-response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wezwi awutholakali okwamanje."}}Amakhodi amaphutha
400 INVALID_VISITOR_ID — I-`visitor_id` ayikho noma ayisiyo UUID esemthethweni.403 ORIGIN_DENIED — Ukubizwa akuveli ku-zentor-app.de.503 VOICE_UNAVAILABLE — Umsebenzi wekhulumo awutholakali okwamanje.Ukuziphatha okuhlolwe
I-`visitor_id` engalungile inikeza u-400 `INVALID_VISITOR_ID`, umsebenzi wekhulumo ongatholakali u-503 `VOICE_UNAVAILABLE`. Isimo sempumelelo singenziwa kuphela kusuka ku-zentor-app.de.
Idemo ye-chatbot ne-SSO
POST /api/global-chatbot/demoIthumela umlayezo kubhothi lokubonisa yomphakathi ku-zentor-app.de/demo futhi inikeze impendulo yayo. Idemo ingazanywa ngaphandle kobhalisi kubhrawuza.GET /api/global-chatbot/demo/historyIlayisha umlando wemiyalezo yangaphambilini wengxoxo yedemo ukuze igcinwe uma idemo ivulwa kabusha.POST /api/global-chatbot/demo/pollLithatha imiyalezo emisha yengxoxo yedemo, isibonelo uma isisebenzi se-Zentor sithatha ingxoxo. Ikhasi ledemo libiza isixhumi ngezikhathi ezihleliwe.POST /api/global-chatbot/demo/ratingIgcina ukuhlolwa kwengxoxo yedemo (okusizile noma okungasizile) ngokuphawula okukhethekile.POST /api/global-chatbot/demo/trackIrekhoda izenzakalo zokusetshenziswa ezingaziwa zekhasi ledemo zamanani wezivakashi ze-Zentor.POST /api/global-chatbot/demo/voice-transcribeIguqula ukuqoshwa kwezwi ekhasini ledemo kube ngumbhalo (okungenayo kwezwi), uma umsebenzi wezwi wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuthi ukungena kanye (SAML noma OIDC) kulungiswe yini ku-akhawunti. Ikhasi lokungena lisebenzisa umphumela ukuze linikeze ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqala ukungena nge-OpenID Connect futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.GET /api/sso/:tenantSlug/oidc/callbackYamukela ukudluliselwa komhlinzeki womazisi ngemva kokungena nge-OIDC futhi ibuyisele isiphequluli ku-Zentor App.GET /api/sso/:tenantSlug/saml/startIqala ukungena nge-SAML futhi idlulisele isiphequluli kumhlinzeki womazisi olungiswe.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamukela impendulo ye-SAML esayiniwe yomhlinzeki womazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza imininingwane ye-SAML ye-Zentor App (XML) ukuba ifakwe emhlinzekini wenu womazisi.