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

Converte una registrazione vocale sulla pagina demo in testo (input vocale), se la funzione vocale della demo è attivata.

Inviate `visitor_id` (UUID) e il file audio nel campo `audio` come `multipart/form-data`. La risposta contiene il testo riconosciuto. L'endpoint corrisponde a `POST /api/public/widget/voice-transcribe`, ma è legato alla demo su zentor-app.de. Casi di errore: 400 `INVALID_VISITOR_ID` (UUID mancante o non valido), 403 `ORIGIN_DENIED` (chiamata non proveniente da zentor-app.de), 413 `AUDIO_TOO_LARGE` (file troppo grande) e 415 `AUDIO_TYPE_UNSUPPORTED` (formato non supportato).

Panoramica

Chiamata: POST /api/global-chatbot/demo/voice-transcribe. Questo endpoint appartiene al gruppo «Chatbot demo e SSO» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata non è idempotente: ogni chiamata riuscita attiva nuovamente l'azione. Parametri obbligatori: visitor_id (body), audio (body). Casi di errore documentati: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Accetta solo chiamate da https://zentor-app.de e https://www.zentor-app.de; per la demo non è richiesto alcun token di incorporamento.

Idempotente: No

Parametri

visitor_id(body, string, obbligatorio)— ID visitatore, deve essere un UUID valido
audio(body, file, obbligatorio)— File audio (`multipart/form-data`)

Risposta di esempio

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

Codici di errore

400 INVALID_VISITOR_ID — `visitor_id` è assente o non è un UUID valido.
403 ORIGIN_DENIED — La chiamata non proviene da zentor-app.de.
413 AUDIO_TOO_LARGE — Il file audio supera la dimensione consentita.
415 AUDIO_TYPE_UNSUPPORTED — Il formato audio non è supportato.

Comportamento verificato

Un `visitor_id` non valido restituisce 400 `INVALID_VISITOR_ID`, una chiamata da un altro dominio restituisce 403 `ORIGIN_DENIED`. Il caso di successo è possibile solo da zentor-app.de.

Chatbot demo e SSO

POST /api/global-chatbot/demoInvia un messaggio al chatbot demo pubblico su zentor-app.de/demo e restituisce la sua risposta. La demo può essere provata nel browser senza registrazione.GET /api/global-chatbot/demo/historyCarica la cronologia dei messaggi di una conversazione demo in modo che venga conservata quando la demo viene riaperta.POST /api/global-chatbot/demo/pollRecupera i nuovi messaggi di una conversazione demo, ad esempio quando un collaboratore di Zentor ha preso in carico la conversazione. La pagina demo richiama l'endpoint a intervalli.POST /api/global-chatbot/demo/ratingSalva la valutazione di una conversazione demo (utile o non utile) con un commento opzionale.POST /api/global-chatbot/demo/trackRegistra eventi di utilizzo anonimi della pagina demo per le statistiche visitatori di Zentor.POST /api/global-chatbot/demo/voice-speakConverte il testo in voce (output vocale sulla pagina demo), se la funzione vocale della demo è attivata.GET /api/sso/:tenantSlug/statusVerifica se il Single Sign-On (SAML o OIDC) è configurato per un account. La pagina di login utilizza il risultato per offrire il login SSO.GET /api/sso/:tenantSlug/oidc/startAvvia il login tramite OpenID Connect e reindirizza il browser al provider di identità configurato.GET /api/sso/:tenantSlug/oidc/callbackRiceve il reindirizzamento del provider di identità dopo il login OIDC e reindirizza il browser a Zentor App.GET /api/sso/:tenantSlug/saml/startAvvia il login tramite SAML e reindirizza il browser al provider di identità configurato.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): riceve la risposta SAML firmata del provider di identità tramite POST di un modulo.GET /api/sso/:tenantSlug/saml/metadataRestituisce i metadati SAML di Zentor App (XML) per l'importazione nel vostro provider di identità.

Articoli correlati

← Chatbot demo e SSO