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

Convertit du texte en parole (sortie vocale sur la page de démonstration), si la fonction vocale de la démo est activée.

Envoyez `visitor_id` (UUID) et le texte à lire dans `text`. La réponse contient les données audio pour la lecture ; pour un élément `<audio>`, le même chemin est également disponible via GET. Le point de terminaison correspond à `POST /api/public/widget/voice-speak`, mais est lié à la démo sur zentor-app.de et n'est pas conçu comme une interface de synthèse vocale générale. Cas d'erreur : 400 `INVALID_VISITOR_ID` (UUID manquant ou invalide), 403 `ORIGIN_DENIED` (appel ne provenant pas de zentor-app.de) et 503 `VOICE_UNAVAILABLE` (fonction vocale actuellement indisponible).

Vue d'ensemble

Appel : POST /api/global-chatbot/demo/voice-speak. 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 : visitor_id (body), text (body). Cas d'erreur documentés : 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. 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

N'accepte que les appels provenant de https://zentor-app.de et https://www.zentor-app.de ; aucun jeton d'intégration n'est requis pour la démo.

Idempotent: Oui

Paramètres

visitor_id(body, string, requis)— ID visiteur, doit être un UUID valide
text(body, string, requis)— Texte à lire à voix haute

Exemple de réponse

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

Codes d'erreur

400 INVALID_VISITOR_ID — `visitor_id` est manquant ou n'est pas un UUID valide.
403 ORIGIN_DENIED — L'appel ne provient pas de zentor-app.de.
503 VOICE_UNAVAILABLE — La fonction vocale est actuellement indisponible.

Comportement vérifié

Un `visitor_id` invalide renvoie 400 `INVALID_VISITOR_ID`, une fonction vocale indisponible 503 `VOICE_UNAVAILABLE`. Le cas de succès n'est possible que depuis zentor-app.de.

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.GET /api/global-chatbot/demo/historyCharge l'historique des messages d'une conversation de démonstration afin qu'il soit conservé lors de la réouverture de la démo.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.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