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

Konverton një regjistrim zanor në faqen demo në tekst (hyrje me zë), nëse funksioni i zërit i demo-s është i aktivizuar.

Dërgoni `visitor_id` (UUID) dhe skedarin audio në fushën `audio` si `multipart/form-data`. Përgjigja përmban tekstin e njohur. Endpoint-i korrespondon me `POST /api/public/widget/voice-transcribe`, por është i lidhur me demo-n në zentor-app.de. Rastet e gabimit: 400 `INVALID_VISITOR_ID` (UUID që mungon ose i pavlefshëm), 403 `ORIGIN_DENIED` (thirrja nuk është nga zentor-app.de), 413 `AUDIO_TOO_LARGE` (skedari shumë i madh) dhe 415 `AUDIO_TYPE_UNSUPPORTED` (format i pambështetur).

Përmbledhje

Thirrja: POST /api/global-chatbot/demo/voice-transcribe. 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 nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: visitor_id (body), audio (body). Rastet e dokumentuara të gabimeve: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. 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: Jo

Parametrat

visitor_id(body, string, i detyrueshëm)— ID-ja e vizitorit, duhet të jetë UUID i vlefshëm
audio(body, file, i detyrueshëm)— Skedar audio (`multipart/form-data`)

Shembull response-i

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id duhet të jetë një UUID i vlefshë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.
413 AUDIO_TOO_LARGE — Skedari audio e kalon madhësinë e lejuar.
415 AUDIO_TYPE_UNSUPPORTED — Formati audio nuk mbështetet.

Sjellja e verifikuar

Një `visitor_id` i pavlefshëm kthen 400 `INVALID_VISITOR_ID`, një thirrje nga një domen tjetër 403 `ORIGIN_DENIED`. 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-speakKonverton tekstin në të folur (prodhim zanor në faqen demo), 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