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

Omskep 'n klankopname op die demo-blad na teks (spraakinvoer), indien die spraakfunksie van die demo geaktiveer is.

Stuur `visitor_id` (UUID) en die klanklêer in die veld `audio` as `multipart/form-data`. Die antwoord bevat die herkende teks. Die eindpunt stem ooreen met `POST /api/public/widget/voice-transcribe`, maar is aan die demo op zentor-app.de gebonde. Foutgevalle: 400 `INVALID_VISITOR_ID` (ontbrekende of ongeldige UUID), 403 `ORIGIN_DENIED` (oproep nie van zentor-app.de nie), 413 `AUDIO_TOO_LARGE` (lêer te groot) en 415 `AUDIO_TYPE_UNSUPPORTED` (formaat nie ondersteun nie).

Oorsig

Oproep: POST /api/global-chatbot/demo/voice-transcribe. Hierdie eindpunt behoort tot die groep “Demo-kletsbot en SSO” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: visitor_id (body), audio (body). Gedokumenteerde foutgevalle: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Aanvaar slegs oproepe van https://zentor-app.de en https://www.zentor-app.de; 'n inbedtoken is nie vir die demo nodig nie.

Idempotent: Nee

Parameters

visitor_id(body, string, vereis)— Besoeker-ID, moet 'n geldige UUID wees
audio(body, file, vereis)— Oudiolêer (`multipart/form-data`)

Voorbeeldrespons

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}

Foutkodes

400 INVALID_VISITOR_ID — `visitor_id` ontbreek of is nie 'n geldige UUID nie.
403 ORIGIN_DENIED — Die oproep kom nie van zentor-app.de nie.
413 AUDIO_TOO_LARGE — Die oudiolêer oorskry die toegelate grootte.
415 AUDIO_TYPE_UNSUPPORTED — Die oudioformaat word nie ondersteun nie.

Gekontroleerde gedrag

'n Ongeldige `visitor_id` lewer 400 `INVALID_VISITOR_ID`, 'n oproep van 'n ander domein 403 `ORIGIN_DENIED`. Die suksesgeval is slegs vanaf zentor-app.de moontlik.

Demo-kletsbot en SSO

POST /api/global-chatbot/demoStuur 'n boodskap aan die openbare demo-kletsbot op zentor-app.de/demo en lewer sy antwoord. Die demo kan sonder registrasie in die blaaier probeer word.GET /api/global-chatbot/demo/historyLaai die vorige boodskapgeskiedenis van 'n demo-gesprek sodat dit behoue bly wanneer die demo weer oopgemaak word.POST /api/global-chatbot/demo/pollHaal nuwe boodskappe van 'n demo-gesprek op, byvoorbeeld wanneer 'n personeellid van Zentor die gesprek oorgeneem het. Die demo-blad roep die eindpunt op gereelde tussenposes aan.POST /api/global-chatbot/demo/ratingStoor die beoordeling van 'n demo-gesprek (nuttig of nie nuttig nie) met opsionele kommentaar.POST /api/global-chatbot/demo/trackRegistreer anonieme gebruiksgebeure van die demo-blad vir Zentor se besoekerstatistieke.POST /api/global-chatbot/demo/voice-speakVerander teks in gesproke taal (spraakuitvoer op die demobladsy), mits die spraakfunksie van die demo geaktiveer is.GET /api/sso/:tenantSlug/statusKyk of enkelaanmelding (SAML of OIDC) vir 'n rekening opgestel is. Die aanmeldbladsy gebruik die resultaat om die SSO-aanmelding aan te bied.GET /api/sso/:tenantSlug/oidc/startBegin die aanmelding per OpenID Connect en stuur die blaaier deur na die opgestelde identiteitsverskaffer.GET /api/sso/:tenantSlug/oidc/callbackNeem die omleiding van die identiteitsverskaffer ná die OIDC-aanmelding in ontvangs en stuur die blaaier terug na Zentor App.GET /api/sso/:tenantSlug/saml/startBegin die aanmelding per SAML en stuur die blaaier deur na die opgestelde identiteitsverskaffer.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): neem die ondertekende SAML-antwoord van die identiteitsverskaffer per vorm-POST in ontvangs.GET /api/sso/:tenantSlug/saml/metadataLewer die SAML-metadata van Zentor App (XML) vir invoer in u identiteitsverskaffer.

Verwante artikels

← Demo-kletsbot en SSO