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 validaudio(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.