GET/api/sso/:tenantSlug/saml/metadata
Returns the Zentor App SAML metadata (XML) for import into your identity provider.
The metadata contains, among other things, the entity ID and the ACS URL that your identity provider needs for setup. The response is an XML document, not JSON. If SAML is not set up for the account, the server responds with 404 `SSO_NOT_CONFIGURED`.
Overview
Call: GET /api/sso/:tenantSlug/saml/metadata. 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 upExample Response
(SAML metadata as an XML document if SAML is set up for the account – not JSON)
Error Codes
404 - — SAML is not set up for this account.Verified behaviour
For an account without SAML, the request 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/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.