GET/api/global-chatbot/demo/history

Charge l'historique des messages d'une conversation de démonstration afin qu'il soit conservé lors de la réouverture de la démo.

Transmettez `session_id` et `visitor_id` en paramètres de requête ; les deux doivent provenir de la même conversation de démonstration. Dans l'objet `data`, la réponse contient la liste `messages` avec `id`, `role`, `text` et `created_at`. L'appel est en lecture seule et idempotent. Si l'un des paramètres est manquant, le serveur répond par 400 `PARAMS_REQUIRED`. Si la session n'est plus connue, démarrez une nouvelle conversation de démonstration.

Vue d'ensemble

Appel : GET /api/global-chatbot/demo/history. Ce point de terminaison appartient au groupe « Chatbot de démonstration et SSO » de l'API de Zentor App. Il est accessible publiquement et ne nécessite aucune authentification. L'appel est idempotent : des appels répétés avec les mêmes données renvoient le même résultat. Paramètres obligatoires : session_id (query), visitor_id (query). Cas d'erreur documentés : 400 PARAMS_REQUIRED. L'exemple de réponse ci-dessous montre la structure d'une réponse réussie au format JSON.

Authentification et sécurité

Aucune authentification requise

Idempotent: Oui

Paramètres

session_id(query, string, requis)— ID de session de la conversation de démonstration
visitor_id(query, string, requis)— ID visiteur (UUID) généré par la page de démonstration

Exemple de réponse

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Bonjour, combien coûte Zentor ?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ich kann dir zeigen, wie das für deinen Anwendungsfall aussehen würde — ohne Verpflichtung.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Codes d'erreur

400 PARAMS_REQUIRED — `session_id` ou `visitor_id` est manquant.

Comportement vérifié

Une session de démonstration existante renvoie 200 avec l'historique ; des paramètres manquants renvoient 400 `PARAMS_REQUIRED`.

Chatbot de démonstration et SSO

POST /api/global-chatbot/demoEnvoie un message au chatbot de démonstration public sur zentor-app.de/demo et renvoie sa réponse. La démo peut être testée dans le navigateur sans inscription.POST /api/global-chatbot/demo/pollRécupère les nouveaux messages d'une conversation de démonstration, par exemple lorsqu'un collaborateur de Zentor a pris en charge la conversation. La page de démonstration appelle le point de terminaison à intervalles réguliers.POST /api/global-chatbot/demo/ratingEnregistre l'évaluation d'une conversation de démonstration (utile ou non utile) avec un commentaire facultatif.POST /api/global-chatbot/demo/trackEnregistre les événements d'utilisation anonymes de la page de démonstration pour les statistiques de visiteurs de Zentor.POST /api/global-chatbot/demo/voice-transcribeConvertit un enregistrement vocal sur la page de démonstration en texte (saisie vocale), si la fonction vocale de la démo est activée.POST /api/global-chatbot/demo/voice-speakConvertit du texte en parole (sortie vocale sur la page de démonstration), si la fonction vocale de la démo est activée.GET /api/sso/:tenantSlug/statusVérifie si l'authentification unique (SAML ou OIDC) est configurée pour un compte. La page de connexion utilise le résultat pour proposer la connexion SSO.GET /api/sso/:tenantSlug/oidc/startDémarre la connexion via OpenID Connect et redirige le navigateur vers le fournisseur d'identité configuré.GET /api/sso/:tenantSlug/oidc/callbackReçoit la redirection du fournisseur d'identité après la connexion OIDC et redirige le navigateur vers Zentor App.GET /api/sso/:tenantSlug/saml/startDémarre la connexion via SAML et redirige le navigateur vers le fournisseur d'identité configuré.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS) : reçoit la réponse SAML signée du fournisseur d'identité via un POST de formulaire.GET /api/sso/:tenantSlug/saml/metadataRenvoie les métadonnées SAML de Zentor App (XML) pour l'importation dans votre fournisseur d'identité.

Articles associés

← Chatbot de démonstration et SSO