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

Omvandlar en röstinspelning på demosidan till text (röstinmatning), om demons röstfunktion är aktiverad.

Skicka `visitor_id` (UUID) och ljudfilen i fältet `audio` som `multipart/form-data`. Svaret innehåller den identifierade texten. Slutpunkten motsvarar `POST /api/public/widget/voice-transcribe`, men är bunden till demon på zentor-app.de. Felfall: 400 `INVALID_VISITOR_ID` (saknad eller ogiltig UUID), 403 `ORIGIN_DENIED` (anrop inte från zentor-app.de), 413 `AUDIO_TOO_LARGE` (filen för stor) och 415 `AUDIO_TYPE_UNSUPPORTED` (format stöds inte).

Översikt

Anrop: POST /api/global-chatbot/demo/voice-transcribe. Endpointen tillhör gruppen ”Demo-chattbot och SSO” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: visitor_id (body), audio (body). Dokumenterade felfall: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.

Autentisering & säkerhet

Ingen autentisering krävs

Accepterar endast anrop från https://zentor-app.de och https://www.zentor-app.de; en inbäddningstoken krävs inte för demon.

Idempotent: Nej

Parametrar

visitor_id(body, string, obligatorisk)— Besökar-ID, måste vara en giltig UUID
audio(body, file, obligatorisk)— Ljudfil (`multipart/form-data`)

Exempel på response

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id måste vara en giltig UUID."}}

Felkoder

400 INVALID_VISITOR_ID — `visitor_id` saknas eller är inte en giltig UUID.
403 ORIGIN_DENIED — Anropet kommer inte från zentor-app.de.
413 AUDIO_TOO_LARGE — Ljudfilen överskrider den tillåtna storleken.
415 AUDIO_TYPE_UNSUPPORTED — Ljudformatet stöds inte.

Verifierat beteende

En ogiltig `visitor_id` returnerar 400 `INVALID_VISITOR_ID`, ett anrop från en annan domän 403 `ORIGIN_DENIED`. Framgångsfallet är endast möjligt från zentor-app.de.

Demo-chattbot och SSO

POST /api/global-chatbot/demoSkickar ett meddelande till den offentliga demo-chattboten på zentor-app.de/demo och returnerar dess svar. Demon kan testas i webbläsaren utan registrering.GET /api/global-chatbot/demo/historyLaddar den tidigare meddelandehistoriken för ett demosamtal, så att den bevaras när demon öppnas igen.POST /api/global-chatbot/demo/pollHämtar nya meddelanden från ett demosamtal, till exempel när en Zentor-medarbetare har tagit över samtalet. Demosidan anropar slutpunkten med jämna mellanrum.POST /api/global-chatbot/demo/ratingSparar bedömningen av ett demosamtal (hjälpsamt eller inte hjälpsamt) med valfri kommentar.POST /api/global-chatbot/demo/trackRegistrerar anonyma användningshändelser på demosidan för Zentors besöksstatistik.POST /api/global-chatbot/demo/voice-speakOmvandlar text till tal (röstutmatning på demosidan), om demons röstfunktion är aktiverad.GET /api/sso/:tenantSlug/statusKontrollerar om enkel inloggning (SAML eller OIDC) är konfigurerad för ett konto. Inloggningssidan använder resultatet för att erbjuda SSO-inloggning.GET /api/sso/:tenantSlug/oidc/startStartar inloggning via OpenID Connect och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.GET /api/sso/:tenantSlug/oidc/callbackTar emot identitetsleverantörens omdirigering efter OIDC-inloggning och omdirigerar webbläsaren tillbaka till Zentor App.GET /api/sso/:tenantSlug/saml/startStartar inloggning via SAML och omdirigerar webbläsaren till den konfigurerade identitetsleverantören.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): tar emot identitetsleverantörens signerade SAML-svar via formulär-POST.GET /api/sso/:tenantSlug/saml/metadataReturnerar Zentor Apps SAML-metadata (XML) för import i din identitetsleverantör.

Relaterade artiklar

← Demo-chattbot och SSO