GET/api/global-chatbot/demo/history

Demo tekrar açıldığında korunması için bir demo konuşmasının mevcut mesaj geçmişini yükler.

`session_id` ve `visitor_id`'yi sorgu parametresi olarak iletin; her ikisi de aynı demo konuşmasından gelmelidir. Yanıt, `data` nesnesinde `id`, `role`, `text` ve `created_at` içeren `messages` listesini içerir. Çağrı salt okunurdur ve idempotenttir. Parametrelerden biri eksikse, sunucu 400 `PARAMS_REQUIRED` ile yanıt verir. Oturum artık bilinmiyorsa, yeni bir demo konuşması başlatın.

Genel Bakış

Çağrı: GET /api/global-chatbot/demo/history. Bu uç nokta, Zentor App API'sinin “Demo Sohbet Botu ve SSO” grubuna aittir. Herkese açıktır ve kimlik doğrulama gerektirmez. Çağrı idempotenttir: Aynı bilgilerle tekrarlanan çağrılar aynı sonucu döndürür. Zorunlu parametreler: session_id (Query), visitor_id (Query). Belgelenmiş hata durumları: 400 PARAMS_REQUIRED. Aşağıdaki örnek yanıt, JSON formatındaki başarılı bir yanıtın yapısını gösterir.

Kimlik Doğrulama ve Güvenlik

Kimlik doğrulama gerekmez

İdempotent: Evet

Parametreler

session_id(query, string, zorunlu)— Demo konuşmasının oturum kimliği
visitor_id(query, string, zorunlu)— Demo sayfasının oluşturduğu ziyaretçi kimliği (UUID)

Örnek Yanıt

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Merhaba, Zentor ne kadar tutuyor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Ich kann dir zeigen, wie das für deinen Anwendungsfall aussehen würde — ohne Verpflichtung.","created_at":"2026-07-20T17:07:02.329Z"}]}}

Hata Kodları

400 PARAMS_REQUIRED — `session_id` veya `visitor_id` eksik.

Doğrulanmış davranış

Mevcut bir demo oturumu, geçmişle 200 döndürür; eksik parametreler 400 `PARAMS_REQUIRED` döndürür.

Demo Sohbet Botu ve SSO

POST /api/global-chatbot/demozentor-app.de/demo adresindeki genel demo sohbet botuna bir mesaj gönderir ve onun yanıtını döndürür. Demo, tarayıcıda kayıt olmadan denenebilir.POST /api/global-chatbot/demo/pollBir demo konuşmasının yeni mesajlarını alır, örneğin bir Zentor çalışanı görüşmeyi devraldığında. Demo sayfası uç noktayı belirli aralıklarla çağırır.POST /api/global-chatbot/demo/ratingBir demo konuşmasının değerlendirmesini (yararlı veya yararlı değil) isteğe bağlı bir yorumla kaydeder.POST /api/global-chatbot/demo/trackZentor'un ziyaretçi istatistiği için demo sayfasının anonim kullanım olaylarını kaydeder.POST /api/global-chatbot/demo/voice-transcribeDemo sayfasındaki bir ses kaydını metne dönüştürür (sesli giriş), demo'nun ses özelliği etkinleştirilmişse.POST /api/global-chatbot/demo/voice-speakMetni konuşmaya dönüştürür (demo sayfasında sesli çıkış), demo'nun ses özelliği etkinleştirilmişse.GET /api/sso/:tenantSlug/statusBir hesap için tek oturum açmanın (SAML veya OIDC) kurulu olup olmadığını kontrol eder. Giriş sayfası, SSO girişini sunmak için sonucu kullanır.GET /api/sso/:tenantSlug/oidc/startOpenID Connect ile girişi başlatır ve tarayıcıyı kurulu kimlik sağlayıcıya yönlendirir.GET /api/sso/:tenantSlug/oidc/callbackOIDC girişinden sonra kimlik sağlayıcının yönlendirmesini alır ve tarayıcıyı Zentor App'e geri yönlendirir.GET /api/sso/:tenantSlug/saml/startSAML ile girişi başlatır ve tarayıcıyı kurulu kimlik sağlayıcıya yönlendirir.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): kimlik sağlayıcının imzalı SAML yanıtını form POST ile alır.GET /api/sso/:tenantSlug/saml/metadataKimlik sağlayıcınıza içe aktarmak için Zentor App'in SAML meta verilerini (XML) sunar.

İlgili makaleler

← Demo Sohbet Botu ve SSO