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

Convertește text în vorbire (ieșire vocală pe pagina demo), dacă funcția vocală a demo-ului este activată.

Trimiteți `visitor_id` (UUID) și textul care trebuie citit în `text`. Răspunsul conține datele audio pentru redare; pentru un element `<audio>`, aceeași cale este disponibilă și prin GET. Endpointul corespunde lui `POST /api/public/widget/voice-speak`, dar este legat de demo-ul de pe zentor-app.de și nu este conceput ca o interfață generală text-în-vorbire. Cazuri de eroare: 400 `INVALID_VISITOR_ID` (UUID absent sau invalid), 403 `ORIGIN_DENIED` (apel care nu provine de la zentor-app.de) și 503 `VOICE_UNAVAILABLE` (funcție vocală indisponibilă în prezent).

Prezentare generală

Apel: POST /api/global-chatbot/demo/voice-speak. Acest endpoint aparține grupului „Chatbot demonstrativ și SSO” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul este idempotent: apelurile repetate cu aceleași date returnează același rezultat. Parametri obligatorii: visitor_id (body), text (body). Cazuri de eroare documentate: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. 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: Da

Parametri

visitor_id(body, string, obligatoriu)— ID vizitator, trebuie să fie un UUID valid
text(body, string, obligatoriu)— Textul care trebuie citit cu voce tare

Exemplu de răspuns

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funcția de vorbire nu este disponibilă în prezent."}}

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.
503 VOICE_UNAVAILABLE — Funcția vocală este indisponibilă în prezent.

Comportament verificat

Un `visitor_id` invalid returnează 400 `INVALID_VISITOR_ID`, o funcție vocală indisponibilă 503 `VOICE_UNAVAILABLE`. 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-transcribeConvertește o înregistrare vocală de pe pagina demo în text (intrare vocală), 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