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

Hubadilisha maandishi kuwa sauti inayosemwa (matamshi kwenye ukurasa wa demo), ikiwa kipengele cha sauti cha demo kimewezeshwa.

Tumeni `visitor_id` (UUID) na maandishi yanayopaswa kusomwa katika `text`. Jibu lina data ya sauti kwa uchezaji; kwa kipengele cha `<audio>` njia ile ile inapatikana pia kwa GET. Kipengele hiki kinalingana na `POST /api/public/widget/voice-speak`, lakini kimefungwa kwa demo kwenye zentor-app.de na hakikusudiwa kuwa kiolesura cha jumla cha matamshi. Hali za makosa: 400 `INVALID_VISITOR_ID` (UUID haipo au si sahihi), 403 `ORIGIN_DENIED` (ombi halitoki kwenye zentor-app.de) na 503 `VOICE_UNAVAILABLE` (kipengele cha sauti hakipatikani kwa sasa).

Muhtasari

Mwito: POST /api/global-chatbot/demo/voice-speak. Endpoint hii ni sehemu ya kundi la “Chatbot ya demo na SSO” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu ni idempotent: miito inayorudiwa yenye data ileile hurudisha matokeo yaleyale. Vigezo vya lazima: visitor_id (body), text (body). Hali za hitilafu zilizoandikwa: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.

Uthibitishaji na ulinzi

Hakuna uthibitishaji unaohitajika

Hupokea tu maombi kutoka https://zentor-app.de na https://www.zentor-app.de; tokeni ya kupachika haihitajiki kwa demo.

Idempotent: Ndiyo

Vigezo

visitor_id(body, string, inahitajika)— ID ya mgeni, inapaswa kuwa UUID sahihi
text(body, string, inahitajika)— Maandishi yanayopaswa kusomwa

Mfano wa jibu (response)

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

Misimbo ya hitilafu

400 INVALID_VISITOR_ID — `visitor_id` haipo au si UUID sahihi.
403 ORIGIN_DENIED — Ombi halitoki kwenye zentor-app.de.
503 VOICE_UNAVAILABLE — Kipengele cha sauti hakipatikani kwa sasa.

Tabia iliyoangaliwa

`visitor_id` isiyo sahihi hutoa 400 `INVALID_VISITOR_ID`, kipengele cha sauti kisichopatikana 503 `VOICE_UNAVAILABLE`. Hali ya mafanikio inawezekana tu kutoka zentor-app.de.

Chatbot ya demo na SSO

POST /api/global-chatbot/demoHutuma ujumbe kwa boti ya onyesho ya umma kwenye zentor-app.de/demo na hutoa jibu lake. Onyesho linaweza kujaribiwa bila kujisajili kwenye kivinjari.GET /api/global-chatbot/demo/historyHupakia historia ya awali ya ujumbe wa mazungumzo ya onyesho ili ihifadhiwe wakati onyesho linapofunguliwa tena.POST /api/global-chatbot/demo/pollHupata ujumbe mpya wa mazungumzo ya onyesho, kwa mfano wakati mfanyakazi wa Zentor amechukua mazungumzo. Ukurasa wa onyesho huita kituo kwa vipindi.POST /api/global-chatbot/demo/ratingHuhifadhi tathmini ya mazungumzo ya onyesho (ya manufaa au si ya manufaa) na maoni ya hiari.POST /api/global-chatbot/demo/trackHurekodi matukio ya matumizi yasiyojulikana ya ukurasa wa onyesho kwa takwimu za wageni wa Zentor.POST /api/global-chatbot/demo/voice-transcribeHubadilisha rekodi ya sauti kwenye ukurasa wa onyesho kuwa maandishi (ingizo la sauti), ikiwa kipengele cha sauti cha onyesho kimewezeshwa.GET /api/sso/:tenantSlug/statusHuangalia kama kuingia mara moja (SAML au OIDC) kumewekwa kwa akaunti. Ukurasa wa kuingia hutumia matokeo kutoa kuingia kwa SSO.GET /api/sso/:tenantSlug/oidc/startHuanzisha kuingia kupitia OpenID Connect na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.GET /api/sso/:tenantSlug/oidc/callbackHupokea uelekezaji wa mtoa huduma wa utambulisho baada ya kuingia kwa OIDC na kurudisha kivinjari kwa Zentor App.GET /api/sso/:tenantSlug/saml/startHuanzisha kuingia kupitia SAML na kuelekeza kivinjari kwa mtoa huduma wa utambulisho aliyewekwa.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): hupokea jibu la SAML lililotiwa saini kutoka mtoa huduma wa utambulisho kwa fomu ya POST.GET /api/sso/:tenantSlug/saml/metadataHutoa metadata ya SAML ya Zentor App (XML) kwa kuingiza kwenye mtoa huduma wenu wa utambulisho.

Makala zinazohusiana

← Chatbot ya demo na SSO