GET/api/sso/:tenantSlug/oidc/start

Starts sign-in via OpenID Connect and redirects the browser to the configured identity provider.

Call the endpoint via browser navigation, not via a JavaScript request. If OIDC is set up, the server responds with a redirect (302) to the identity provider; after signing in there, the browser returns via `oidc/callback`. If OIDC is not set up for the account, the server responds with 404 `SSO_NOT_CONFIGURED` and a JSON error message.

Overview

Call: GET /api/sso/:tenantSlug/oidc/start. 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: tenantSlug (path). Documented error cases: 404 -.

Auth & Security

No authentication required

Idempotent: Yes

Parameters

tenantSlug(path, string, required)— Identifier (slug) of the account for which SSO is set up

Example Response

(302 redirect to the identity provider if OIDC is set up for the account)

Error Codes

404 - — OIDC is not set up for this account.

Verified behaviour

For an account without OIDC, the call returns 404.

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.POST /api/global-chatbot/demo/voice-speakConverts text into speech (voice output on the demo page), 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/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.

Related articles

← Demo Chatbot and SSO