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

Zet een spraakopname op de demopagina om in tekst (spraakinvoer), als de spraakfunctie van de demo is ingeschakeld.

Verzend `visitor_id` (UUID) en het audiobestand in het veld `audio` als `multipart/form-data`. Het antwoord bevat de herkende tekst. Het endpoint komt overeen met `POST /api/public/widget/voice-transcribe`, maar is gebonden aan de demo op zentor-app.de. Foutgevallen: 400 `INVALID_VISITOR_ID` (ontbrekende of ongeldige UUID), 403 `ORIGIN_DENIED` (aanroep niet vanaf zentor-app.de), 413 `AUDIO_TOO_LARGE` (bestand te groot) en 415 `AUDIO_TYPE_UNSUPPORTED` (formaat niet ondersteund).

Overzicht

Aanroep: POST /api/global-chatbot/demo/voice-transcribe. Dit endpoint hoort bij de groep ‘Demo-chatbot en SSO’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is niet idempotent: elke geslaagde aanroep activeert de actie opnieuw. Verplichte parameters: visitor_id (body), audio (body). Gedocumenteerde foutgevallen: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.

Auth & beveiliging

Geen authenticatie vereist

Accepteert alleen aanroepen vanaf https://zentor-app.de en https://www.zentor-app.de; voor de demo is geen embed-token vereist.

Idempotent: Nee

Parameters

visitor_id(body, string, vereist)— Bezoeker-ID, moet een geldige UUID zijn
audio(body, file, vereist)— Audiobestand (`multipart/form-data`)

Voorbeeld-response

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id moet een geldige UUID zijn."}}

Foutcodes

400 INVALID_VISITOR_ID — `visitor_id` ontbreekt of is geen geldige UUID.
403 ORIGIN_DENIED — De aanroep komt niet van zentor-app.de.
413 AUDIO_TOO_LARGE — Het audiobestand overschrijdt de toegestane grootte.
415 AUDIO_TYPE_UNSUPPORTED — Het audioformaat wordt niet ondersteund.

Geverifieerd gedrag

Een ongeldige `visitor_id` levert 400 `INVALID_VISITOR_ID`, een aanroep vanaf een ander domein 403 `ORIGIN_DENIED`. Het succesgeval is alleen mogelijk vanaf zentor-app.de.

Demo-chatbot en SSO

POST /api/global-chatbot/demoVerzendt een bericht naar de openbare demo-chatbot op zentor-app.de/demo en levert het antwoord daarvan. De demo kan zonder registratie in de browser worden uitgeprobeerd.GET /api/global-chatbot/demo/historyLaadt de bestaande berichtgeschiedenis van een demogesprek, zodat deze behouden blijft bij het opnieuw openen van de demo.POST /api/global-chatbot/demo/pollHaalt nieuwe berichten van een demogesprek op, bijvoorbeeld wanneer een medewerker van Zentor het gesprek heeft overgenomen. De demopagina roept het endpoint met tussenpozen aan.POST /api/global-chatbot/demo/ratingSlaat de beoordeling van een demogesprek op (nuttig of niet nuttig) met een optionele opmerking.POST /api/global-chatbot/demo/trackRegistreert anonieme gebruiksgebeurtenissen van de demopagina voor de bezoekersstatistieken van Zentor.POST /api/global-chatbot/demo/voice-speakZet tekst om in gesproken taal (spraakuitvoer op de demopagina), als de spraakfunctie van de demo is ingeschakeld.GET /api/sso/:tenantSlug/statusControleert of single sign-on (SAML of OIDC) is ingericht voor een account. De aanmeldpagina gebruikt het resultaat om de SSO-aanmelding aan te bieden.GET /api/sso/:tenantSlug/oidc/startStart het aanmelden via OpenID Connect en leidt de browser door naar de ingerichte identity provider.GET /api/sso/:tenantSlug/oidc/callbackOntvangt de doorverwijzing van de identity provider na de OIDC-aanmelding en leidt de browser terug naar Zentor App.GET /api/sso/:tenantSlug/saml/startStart het aanmelden via SAML en leidt de browser door naar de ingerichte identity provider.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): ontvangt het ondertekende SAML-antwoord van de identity provider via een formulier-POST.GET /api/sso/:tenantSlug/saml/metadataLevert de SAML-metadata van Zentor App (XML) voor import in uw identity provider.

Gerelateerde artikelen

← Demo-chatbot en SSO