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

Konverton tekstin në të folur (prodhim zanor në faqen demo), nëse funksioni i zërit i demo-s është i aktivizuar.

Dërgoni `visitor_id` (UUID) dhe tekstin që duhet lexuar në `text`. Përgjigja përmban të dhënat audio për riprodhim; për një element `<audio>` i njëjti shteg është gjithashtu i disponueshëm përmes GET. Endpoint-i korrespondon me `POST /api/public/widget/voice-speak`, por është i lidhur me demo-n në zentor-app.de dhe nuk është menduar si një ndërfaqe e përgjithshme për të folur. Rastet e gabimit: 400 `INVALID_VISITOR_ID` (UUID që mungon ose i pavlefshëm), 403 `ORIGIN_DENIED` (thirrja nuk është nga zentor-app.de) dhe 503 `VOICE_UNAVAILABLE` (funksioni i zërit aktualisht i padisponueshëm).

Përmbledhje

Thirrja: POST /api/global-chatbot/demo/voice-speak. Ky endpoint i përket grupit “Demo-chatbot dhe SSO” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja është idempotente: thirrjet e përsëritura me të njëjtat të dhëna kthejnë të njëjtin rezultat. Parametrat e detyrueshëm: visitor_id (body), text (body). Rastet e dokumentuara të gabimeve: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.

Autentifikimi dhe siguria

Nuk kërkohet autentifikim

Pranon vetëm thirrje nga https://zentor-app.de dhe https://www.zentor-app.de; nuk nevojitet token ngulitje për demo-n.

Idempotent: Po

Parametrat

visitor_id(body, string, i detyrueshëm)— ID-ja e vizitorit, duhet të jetë UUID i vlefshëm
text(body, string, i detyrueshëm)— Teksti që duhet lexuar

Shembull response-i

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funksioni i zërit aktualisht nuk është i disponueshëm."}}

Kodet e gabimeve

400 INVALID_VISITOR_ID — `visitor_id` mungon ose nuk është UUID i vlefshëm.
403 ORIGIN_DENIED — Thirrja nuk vjen nga zentor-app.de.
503 VOICE_UNAVAILABLE — Funksioni i zërit aktualisht nuk është i disponueshëm.

Sjellja e verifikuar

Një `visitor_id` i pavlefshëm kthen 400 `INVALID_VISITOR_ID`, një funksion zanor i padisponueshëm 503 `VOICE_UNAVAILABLE`. Rasti i suksesit është i mundur vetëm nga zentor-app.de.

Demo-chatbot dhe SSO

POST /api/global-chatbot/demoDërgon një mesazh te chatbot-i publik demo në zentor-app.de/demo dhe kthen përgjigjen e tij. Demo-ja mund të provohet në shfletues pa regjistrim.GET /api/global-chatbot/demo/historyNgarkon historinë e mëparshme të mesazheve të një bisede demo, që të ruhet kur demo-ja hapet përsëri.POST /api/global-chatbot/demo/pollMerr mesazhet e reja të një bisede demo, për shembull kur një punonjës i Zentor e ka marrë përsipër bisedën. Faqja demo e thërret endpoint-in në intervale.POST /api/global-chatbot/demo/ratingRuaj vlerësimin e një bisede demo (e dobishme ose jo e dobishme) me koment opsional.POST /api/global-chatbot/demo/trackRegjistron ngjarje anonime të përdorimit të faqes demo për statistikat e vizitorëve të Zentor.POST /api/global-chatbot/demo/voice-transcribeKonverton një regjistrim zanor në faqen demo në tekst (hyrje me zë), nëse funksioni i zërit i demo-s është i aktivizuar.GET /api/sso/:tenantSlug/statusKontrollon nëse për një llogari është konfiguruar hyrja e njëhershme (SAML ose OIDC). Faqja e hyrjes e përdor rezultatin për të ofruar hyrjen SSO.GET /api/sso/:tenantSlug/oidc/startNis identifikimin përmes OpenID Connect dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.GET /api/sso/:tenantSlug/oidc/callbackPranon ridrejtimin e ofruesit të identitetit pas hyrjes OIDC dhe ridrejton shfletuesin përsëri te Zentor App.GET /api/sso/:tenantSlug/saml/startNis identifikimin përmes SAML dhe ridrejton shfletuesin te ofruesi i identitetit i konfiguruar.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): pranon përgjigjen e nënshkruar SAML të ofruesit të identitetit përmes formularit POST.GET /api/sso/:tenantSlug/saml/metadataKthen metadatat SAML të Zentor App (XML) për importim në ofruesin tuaj të identitetit.

Artikuj të lidhur

← Demo-chatbot dhe SSO