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

Konverterer tekst til tale (taleutgang på demosiden), hvis demoens talefunksjon er aktivert.

Send `visitor_id` (UUID) og teksten som skal leses opp, i `text`. Svaret inneholder lyddataene for avspilling; for et `<audio>`-element er samme sti i tillegg tilgjengelig via GET. Endepunktet svarer til `POST /api/public/widget/voice-speak`, men er bundet til demoen på zentor-app.de og er ikke tenkt som et generelt talesynteseksgrensesnitt. Feiltilfeller: 400 `INVALID_VISITOR_ID` (manglende eller ugyldig UUID), 403 `ORIGIN_DENIED` (kall ikke fra zentor-app.de) og 503 `VOICE_UNAVAILABLE` (talefunksjon for øyeblikket ikke tilgjengelig).

Oversikt

Kall: POST /api/global-chatbot/demo/voice-speak. Endepunktet tilhører gruppen «Demo-chatbot og SSO» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er idempotent: Gjentatte kall med de samme opplysningene gir samme resultat. Obligatoriske parametere: visitor_id (body), text (body). Dokumenterte feiltilfeller: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. Eksempelsvaret nedenfor viser strukturen til et vellykket svar i JSON-format.

Autentisering og sikring

Ingen autentisering påkrevd

Tar bare mot kall fra https://zentor-app.de og https://www.zentor-app.de; et innbyggingstoken er ikke nødvendig for demoen.

Idempotent: Ja

Parametere

visitor_id(body, string, påkrevd)— Besøkende-ID, må være en gyldig UUID
text(body, string, påkrevd)— Tekst som skal leses opp

Eksempel på svar

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Talefunksjonen er for øyeblikket ikke tilgjengelig."}}

Feilkoder

400 INVALID_VISITOR_ID — `visitor_id` mangler eller er ikke en gyldig UUID.
403 ORIGIN_DENIED — Kallet kommer ikke fra zentor-app.de.
503 VOICE_UNAVAILABLE — Talefunksjonen er for øyeblikket ikke tilgjengelig.

Verifisert oppførsel

En ugyldig `visitor_id` returnerer 400 `INVALID_VISITOR_ID`, en utilgjengelig talefunksjon 503 `VOICE_UNAVAILABLE`. Suksesstilfellet er bare mulig fra zentor-app.de.

Demo-chatbot og SSO

POST /api/global-chatbot/demoSender en melding til den offentlige demo-chatboten på zentor-app.de/demo og returnerer svaret. Demoen kan prøves i nettleseren uten registrering.GET /api/global-chatbot/demo/historyLaster inn den tidligere meldingshistorikken til en demosamtale, slik at den bevares når demoen åpnes på nytt.POST /api/global-chatbot/demo/pollHenter nye meldinger fra en demosamtale, for eksempel når en Zentor-ansatt har overtatt samtalen. Demosiden kaller endepunktet med jevne mellomrom.POST /api/global-chatbot/demo/ratingLagrer vurderingen av en demosamtale (nyttig eller ikke nyttig) med valgfri kommentar.POST /api/global-chatbot/demo/trackRegistrerer anonyme brukshendelser på demosiden for Zentors besøksstatistikk.POST /api/global-chatbot/demo/voice-transcribeKonverterer en taleopptak på demosiden til tekst (taleinnmating), hvis demoens talefunksjon er aktivert.GET /api/sso/:tenantSlug/statusKontrollerer om enkelt pålogging (SAML eller OIDC) er satt opp for en konto. Innloggingssiden bruker resultatet til å tilby SSO-innlogging.GET /api/sso/:tenantSlug/oidc/startStarter innlogging via OpenID Connect og omdirigerer nettleseren til den oppsatte identitetsleverandøren.GET /api/sso/:tenantSlug/oidc/callbackMottar identitetsleverandørens omdirigering etter OIDC-innlogging og omdirigerer nettleseren tilbake til Zentor App.GET /api/sso/:tenantSlug/saml/startStarter innlogging via SAML og omdirigerer nettleseren til den oppsatte identitetsleverandøren.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): Mottar identitetsleverandørens signerte SAML-svar via formular-POST.GET /api/sso/:tenantSlug/saml/metadataReturnerer Zentor Apps SAML-metadata (XML) for import i identitetsleverandøren din.

Relaterte artikler

← Demo-chatbot og SSO