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

Convertește o înregistrare vocală de pe pagina demo în text (intrare vocală), dacă funcția vocală a demo-ului este activată.

Trimiteți `visitor_id` (UUID) și fișierul audio în câmpul `audio` ca `multipart/form-data`. Răspunsul conține textul recunoscut. Endpointul corespunde lui `POST /api/public/widget/voice-transcribe`, dar este legat de demo-ul de pe zentor-app.de. Cazuri de eroare: 400 `INVALID_VISITOR_ID` (UUID absent sau invalid), 403 `ORIGIN_DENIED` (apel care nu provine de la zentor-app.de), 413 `AUDIO_TOO_LARGE` (fișier prea mare) și 415 `AUDIO_TYPE_UNSUPPORTED` (format neacceptat).

Prezentare generală

Apel: POST /api/global-chatbot/demo/voice-transcribe. Acest endpoint aparține grupului „Chatbot demonstrativ și SSO” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: visitor_id (body), audio (body). Cazuri de eroare documentate: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.

Autentificare și securitate

Nu este necesară autentificarea

Acceptă doar apeluri de la https://zentor-app.de și https://www.zentor-app.de; pentru demo nu este necesar niciun token de încorporare.

Idempotent: Nu

Parametri

visitor_id(body, string, obligatoriu)— ID vizitator, trebuie să fie un UUID valid
audio(body, file, obligatoriu)— Fișier audio (`multipart/form-data`)

Exemplu de răspuns

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id trebuie să fie o UUID validă."}}

Coduri de eroare

400 INVALID_VISITOR_ID — `visitor_id` lipsește sau nu este un UUID valid.
403 ORIGIN_DENIED — Apelul nu provine de la zentor-app.de.
413 AUDIO_TOO_LARGE — Fișierul audio depășește dimensiunea permisă.
415 AUDIO_TYPE_UNSUPPORTED — Formatul audio nu este acceptat.

Comportament verificat

Un `visitor_id` invalid returnează 400 `INVALID_VISITOR_ID`, un apel de pe un alt domeniu 403 `ORIGIN_DENIED`. Cazul de succes este posibil doar de la zentor-app.de.

Chatbot demonstrativ și SSO

POST /api/global-chatbot/demoTrimite un mesaj către chatbotul demonstrativ public de la zentor-app.de/demo și returnează răspunsul acestuia. Demo-ul poate fi testat în browser fără înregistrare.GET /api/global-chatbot/demo/historyÎncarcă istoricul de mesaje al unei conversații demonstrative, astfel încât acesta să fie păstrat la reluarea demo-ului.POST /api/global-chatbot/demo/pollObține mesajele noi ale unei conversații demonstrative, de exemplu atunci când un angajat Zentor a preluat conversația. Pagina demo apelează endpointul la intervale.POST /api/global-chatbot/demo/ratingSalvează evaluarea unei conversații demonstrative (utilă sau neutilă) cu un comentariu opțional.POST /api/global-chatbot/demo/trackÎnregistrează evenimente de utilizare anonime ale paginii demo pentru statisticile de vizitatori ale Zentor.POST /api/global-chatbot/demo/voice-speakConvertește text în vorbire (ieșire vocală pe pagina demo), dacă funcția vocală a demo-ului este activată.GET /api/sso/:tenantSlug/statusVerifică dacă autentificarea unică (SAML sau OIDC) este configurată pentru un cont. Pagina de autentificare folosește rezultatul pentru a oferi autentificarea SSO.GET /api/sso/:tenantSlug/oidc/startPornește autentificarea prin OpenID Connect și redirecționează browserul către furnizorul de identitate configurat.GET /api/sso/:tenantSlug/oidc/callbackPrimește redirecționarea furnizorului de identitate după autentificarea OIDC și redirecționează browserul înapoi la Zentor App.GET /api/sso/:tenantSlug/saml/startPornește autentificarea prin SAML și redirecționează browserul către furnizorul de identitate configurat.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): primește răspunsul SAML semnat al furnizorului de identitate printr-un POST de formular.GET /api/sso/:tenantSlug/saml/metadataReturnează metadatele SAML ale Zentor App (XML) pentru import în furnizorul dumneavoastră de identitate.

Articole similare

← Chatbot demonstrativ și SSO