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

Iguqula umbhalo ube yintetho ekhulunywayo (isandi kwikhasi ledemo), ukuba umsebenzi wentetho yedemo uvulwe.

Thumela `visitor_id` (UUID) nombhalo omawufundwe ku-`text`. Impendulo iqulethe idatha yesandi sokudlala; kwi-elementi ye-`<audio>` kuyafumaneka indlela efanayo nge-GET. Isicelo sihambelana ne-`POST /api/public/widget/voice-speak`, kodwa sibophelelwe kwidemo ku-zentor-app.de kwaye asihloswe ukuba yijongano jikelele lesandi sentetho. Iimeko zempazamo: 400 `INVALID_VISITOR_ID` (i-UUID engekhoyo okanye engasebenziyo), 403 `ORIGIN_DENIED` (ukubizwa akuveli ku-zentor-app.de) kunye no-503 `VOICE_UNAVAILABLE` (umsebenzi wentetho awukafumaneki okwangoku).

Ushwankathelo

Ukubiza: POST /api/global-chatbot/demo/voice-speak. Le endpoint yeyeqela elithi “Idemo ye-chatbot ne-SSO” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza yi-idempotent: ukubiza kaninzi ngolwazi olufanayo kubuyisa isiphumo esifanayo. Iipharamitha ezinyanzelekileyo: visitor_id (body), text (body). Iimeko zeempazamo ezibhaliweyo: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.

Ukuqinisekiswa nokhuseleko

Akukho kuqinisekiswa kufunekayo

Yamkela kuphela izicelo ezivela ku-https://zentor-app.de ne-https://www.zentor-app.de; i-token yokufaka ayifunekile kwidemo.

Idempotent: Yebo

Iiparamitha

visitor_id(body, string, kuyafuneka)— I-ID yesindwendwe, kufuneka ibe i-UUID esemthethweni
text(body, string, kuyafuneka)— Umbhalo omawufundwe

Umzekelo we-response

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wentetho awukho ngoku."}}

Iikhowudi zeempazamo

400 INVALID_VISITOR_ID — I-`visitor_id` ayikho okanye ayisiyo UUID esemthethweni.
403 ORIGIN_DENIED — Ukubizwa akuveli ku-zentor-app.de.
503 VOICE_UNAVAILABLE — Umsebenzi wentetho awufumaneki okwangoku.

Ukuziphatha okujongwe

I-`visitor_id` engasebenziyo inika u-400 `INVALID_VISITOR_ID`, umsebenzi wentetho ongafumanekiyo u-503 `VOICE_UNAVAILABLE`. Imeko yempumelelo inokwenzeka kuphela kusuka ku-zentor-app.de.

Idemo ye-chatbot ne-SSO

POST /api/global-chatbot/demoIthumela umyalezo kwibhoti yokubonisa yoluntu ku-zentor-app.de/demo kwaye inikeze impendulo yayo. Idemo inganzanwa ngaphandle kokubhalisa kwibhrawuza.GET /api/global-chatbot/demo/historyIlayisha imbali yemiyalezo yangaphambili yencoko yedemo ukuze igcinwe xa idemo ivulwa kwakhona.POST /api/global-chatbot/demo/pollLithatha imiyalezo emitsha yencoko yedemo, umzekelo xa umsebenzi we-Zentor uthatha incoko. Iphepha ledemo libiza isidibanisi kumaxesha athile.POST /api/global-chatbot/demo/ratingIgcina ukuvavanywa kwencoko yedemo (okunceda okanye okungancedi) ngokuphawula okukhethiweyo.POST /api/global-chatbot/demo/trackIrekhoda iziganeko zokusetyenziswa ezingaziwayo zephepha ledemo zamanani weendwendwe ze-Zentor.POST /api/global-chatbot/demo/voice-transcribeIguqula uqoshoyi lwezwi kwiphepha ledemo kube ngumbhalo (ongeno lwezwi), ukuba umsebenzi wezwi wedemo uvuliwe.GET /api/sso/:tenantSlug/statusIhlola ukuba ukungena kanye (SAML okanye OIDC) kusetwe na kwi-akhawunti. Iphepha lokungena lisebenzisa isiphumo ukunika ukungena nge-SSO.GET /api/sso/:tenantSlug/oidc/startIqalisa ukungena nge-OpenID Connect kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.GET /api/sso/:tenantSlug/oidc/callbackYamkela ukudluliselwa komboneleli wesazisi emva kokungena nge-OIDC kwaye ibuyisela isikhangeli kwi-Zentor App.GET /api/sso/:tenantSlug/saml/startIqalisa ukungena nge-SAML kwaye idlulisela isikhangeli kumboneleli wesazisi osetiweyo.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): yamkela impendulo ye-SAML esayinweyo yomboneleli wesazisi nge-POST yefomu.GET /api/sso/:tenantSlug/saml/metadataInikeza iinkcukacha ze-SAML ze-Zentor App (XML) ukuba zifakwe kumboneleli wenu wesazisi.

Amanqaku ahambelanayo

← Idemo ye-chatbot ne-SSO