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

Convertit un enregistrement vocal sur la page de démonstration en texte (saisie vocale), si la fonction vocale de la démo est activée.

Envoyez `visitor_id` (UUID) et le fichier audio dans le champ `audio` en tant que `multipart/form-data`. La réponse contient le texte reconnu. Le point de terminaison correspond à `POST /api/public/widget/voice-transcribe`, mais est lié à la démo sur zentor-app.de. Cas d'erreur : 400 `INVALID_VISITOR_ID` (UUID manquant ou invalide), 403 `ORIGIN_DENIED` (appel ne provenant pas de zentor-app.de), 413 `AUDIO_TOO_LARGE` (fichier trop volumineux) et 415 `AUDIO_TYPE_UNSUPPORTED` (format non pris en charge).

Vue d'ensemble

Appel : POST /api/global-chatbot/demo/voice-transcribe. 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 n'est pas idempotent : chaque appel réussi déclenche à nouveau l'action. Paramètres obligatoires : visitor_id (body), audio (body). Cas d'erreur documentés : 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. 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: Non

Paramètres

visitor_id(body, string, requis)— ID visiteur, doit être un UUID valide
audio(body, file, requis)— Fichier audio (`multipart/form-data`)

Exemple de réponse

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}

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.
413 AUDIO_TOO_LARGE — Le fichier audio dépasse la taille autorisée.
415 AUDIO_TYPE_UNSUPPORTED — Le format audio n'est pas pris en charge.

Comportement vérifié

Un `visitor_id` invalide renvoie 400 `INVALID_VISITOR_ID`, un appel depuis un autre domaine 403 `ORIGIN_DENIED`. 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-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