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

Wandelt eine Sprachaufnahme auf der Demo-Seite in Text um (Spracheingabe), sofern die Sprachfunktion der Demo aktiviert ist.

Senden Sie `visitor_id` (UUID) und die Audiodatei im Feld `audio` als `multipart/form-data`. Die Antwort enthält den erkannten Text. Der Endpunkt entspricht `POST /api/public/widget/voice-transcribe`, ist aber an die Demo auf zentor-app.de gebunden. Fehlerfälle: 400 `INVALID_VISITOR_ID` (fehlende oder ungültige UUID), 403 `ORIGIN_DENIED` (Aufruf nicht von zentor-app.de), 413 `AUDIO_TOO_LARGE` (Datei zu groß) und 415 `AUDIO_TYPE_UNSUPPORTED` (Format nicht unterstützt).

Überblick

Aufruf: POST /api/global-chatbot/demo/voice-transcribe. Der Endpunkt gehört zur Gruppe „Demo-Chatbot und SSO“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist nicht idempotent: Jeder erfolgreiche Aufruf löst die Aktion erneut aus. Pflichtparameter: visitor_id (Body), audio (Body). Dokumentierte Fehlerfälle: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.

Auth & Absicherung

Keine Authentifizierung erforderlich

Nimmt nur Aufrufe von https://zentor-app.de und https://www.zentor-app.de an; ein Embed-Token ist für die Demo nicht erforderlich.

Idempotent: Nein

Parameter

visitor_id(body, string, erforderlich)— Besucher-ID, muss eine gültige UUID sein
audio(body, file, erforderlich)— Audiodatei (`multipart/form-data`)

Beispiel-Response

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

Fehlercodes

400 INVALID_VISITOR_ID — `visitor_id` fehlt oder ist keine gültige UUID.
403 ORIGIN_DENIED — Der Aufruf kommt nicht von zentor-app.de.
413 AUDIO_TOO_LARGE — Die Audiodatei überschreitet die zulässige Größe.
415 AUDIO_TYPE_UNSUPPORTED — Das Audioformat wird nicht unterstützt.

Geprüftes Verhalten

Eine ungültige `visitor_id` liefert 400 `INVALID_VISITOR_ID`, ein Aufruf von einer anderen Domain 403 `ORIGIN_DENIED`. Der Erfolgsfall ist nur von zentor-app.de aus möglich.

Demo-Chatbot und SSO

POST /api/global-chatbot/demoSendet eine Nachricht an den öffentlichen Demo-Chatbot auf zentor-app.de/demo und liefert dessen Antwort. Die Demo lässt sich ohne Registrierung im Browser ausprobieren.GET /api/global-chatbot/demo/historyLädt den bisherigen Nachrichtenverlauf einer Demo-Konversation, damit er beim erneuten Öffnen der Demo erhalten bleibt.POST /api/global-chatbot/demo/pollRuft neue Nachrichten einer Demo-Konversation ab, etwa wenn ein Mitarbeiter von Zentor das Gespräch übernommen hat. Die Demo-Seite ruft den Endpunkt in Abständen auf.POST /api/global-chatbot/demo/ratingSpeichert die Bewertung einer Demo-Konversation (hilfreich oder nicht hilfreich) mit optionalem Kommentar.POST /api/global-chatbot/demo/trackErfasst anonyme Nutzungsereignisse der Demo-Seite für die Besucherstatistik von Zentor.POST /api/global-chatbot/demo/voice-speakWandelt Text in gesprochene Sprache um (Sprachausgabe auf der Demo-Seite), sofern die Sprachfunktion der Demo aktiviert ist.GET /api/sso/:tenantSlug/statusPrüft, ob für ein Konto Single Sign-On (SAML oder OIDC) eingerichtet ist. Die Anmeldeseite nutzt das Ergebnis, um die SSO-Anmeldung anzubieten.GET /api/sso/:tenantSlug/oidc/startStartet die Anmeldung per OpenID Connect und leitet den Browser zum eingerichteten Identity-Provider weiter.GET /api/sso/:tenantSlug/oidc/callbackNimmt die Weiterleitung des Identity-Providers nach der OIDC-Anmeldung entgegen und leitet den Browser zurück zu Zentor App.GET /api/sso/:tenantSlug/saml/startStartet die Anmeldung per SAML und leitet den Browser zum eingerichteten Identity-Provider weiter.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): nimmt die signierte SAML-Antwort des Identity-Providers per Formular-POST entgegen.GET /api/sso/:tenantSlug/saml/metadataLiefert die SAML-Metadaten von Zentor App (XML) zum Import in Ihren Identity-Provider.

Verwandte Artikel

← Demo-Chatbot und SSO