POST/api/global-chatbot/demo/voice-speak
Converts text into speech (voice output on the demo page), if the demo's voice feature is enabled.
Send `visitor_id` (UUID) and the text to be read aloud in `text`. The response contains the audio data for playback; for an `<audio>` element, the same path is also available via GET. The endpoint corresponds to `POST /api/public/widget/voice-speak` but is bound to the demo on zentor-app.de and is not intended as a general text-to-speech interface. Error cases: 400 `INVALID_VISITOR_ID` (missing or invalid UUID), 403 `ORIGIN_DENIED` (call not from zentor-app.de) and 503 `VOICE_UNAVAILABLE` (voice feature currently unavailable).
Overview
Call: POST /api/global-chatbot/demo/voice-speak. This endpoint belongs to the “Demo Chatbot and SSO” group of the Zentor App API. It is publicly accessible and requires no authentication. The call is idempotent: repeating it with the same input returns the same result. Required parameters: visitor_id (body), text (body). Documented error cases: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. The example response below shows the structure of a successful JSON response.
Auth & Security
No authentication required
Only accepts calls from https://zentor-app.de and https://www.zentor-app.de; no embed token is required for the demo.
Idempotent: Yes
Parameters
visitor_id(body, string, required)— Visitor ID, must be a valid UUIDtext(body, string, required)— Text to be read aloudExample Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Error Codes
400 INVALID_VISITOR_ID — `visitor_id` is missing or not a valid UUID.403 ORIGIN_DENIED — The call does not come from zentor-app.de.503 VOICE_UNAVAILABLE — The voice feature is currently unavailable.Verified behaviour
An invalid `visitor_id` returns 400 `INVALID_VISITOR_ID`, an unavailable voice feature 503 `VOICE_UNAVAILABLE`. The success case is only possible from zentor-app.de.
Demo Chatbot and SSO
POST /api/global-chatbot/demoSends a message to the public demo chatbot at zentor-app.de/demo and returns its reply. The demo can be tried out in the browser without registering.GET /api/global-chatbot/demo/historyLoads the message history of a demo conversation so that it is preserved when the demo is reopened.POST /api/global-chatbot/demo/pollFetches new messages of a demo conversation, for example when a Zentor team member has taken over the conversation. The demo page calls the endpoint at intervals.POST /api/global-chatbot/demo/ratingStores the rating of a demo conversation (helpful or not helpful) with an optional comment.POST /api/global-chatbot/demo/trackRecords anonymous usage events on the demo page for Zentor's visitor statistics.POST /api/global-chatbot/demo/voice-transcribeConverts a voice recording on the demo page into text (voice input), if the demo's voice feature is enabled.GET /api/sso/:tenantSlug/statusChecks whether single sign-on (SAML or OIDC) is set up for an account. The sign-in page uses the result to offer SSO sign-in.GET /api/sso/:tenantSlug/oidc/startStarts sign-in via OpenID Connect and redirects the browser to the configured identity provider.GET /api/sso/:tenantSlug/oidc/callbackReceives the identity provider's redirect after OIDC sign-in and redirects the browser back to Zentor App.GET /api/sso/:tenantSlug/saml/startStarts sign-in via SAML and redirects the browser to the configured identity provider.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): receives the identity provider's signed SAML response via form POST.GET /api/sso/:tenantSlug/saml/metadataReturns the Zentor App SAML metadata (XML) for import into your identity provider.