GET/api/global-chatbot/demo/history
Carica la cronologia dei messaggi di una conversazione demo in modo che venga conservata quando la demo viene riaperta.
Trasmettete `session_id` e `visitor_id` come parametri di query; entrambi devono provenire dalla stessa conversazione demo. Nell'oggetto `data`, la risposta contiene l'elenco `messages` con `id`, `role`, `text` e `created_at`. La chiamata è di sola lettura e idempotente. Se manca uno dei parametri, il server risponde con 400 `PARAMS_REQUIRED`. Se la sessione non è più nota, avviate una nuova conversazione demo.
Panoramica
Chiamata: GET /api/global-chatbot/demo/history. Questo endpoint appartiene al gruppo «Chatbot demo e SSO» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata è idempotente: chiamate ripetute con gli stessi dati restituiscono lo stesso risultato. Parametri obbligatori: session_id (query), visitor_id (query). Casi di errore documentati: 400 PARAMS_REQUIRED. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.
Autenticazione e sicurezza
Nessuna autenticazione richiesta
Idempotente: Sì
Parametri
session_id(query, string, obbligatorio)— ID sessione della conversazione demovisitor_id(query, string, obbligatorio)— ID visitatore (UUID) generato dalla pagina demoRisposta di esempio
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Ciao, quanto costa Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Posso mostrarti come potrebbe funzionare per il tuo caso d'uso — senza impegno.","created_at":"2026-07-20T17:07:02.329Z"}]}}Codici di errore
400 PARAMS_REQUIRED — `session_id` o `visitor_id` è assente.Comportamento verificato
Una sessione demo esistente restituisce 200 con la cronologia; i parametri mancanti restituiscono 400 `PARAMS_REQUIRED`.
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.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-transcribeConverte una registrazione vocale sulla pagina demo in testo (input vocale), se la funzione vocale della demo è attivata.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à.