POST/api/global-chatbot/demo/voice-speak
Metni konuşmaya dönüştürür (demo sayfasında sesli çıkış), demo'nun ses özelliği etkinleştirilmişse.
`visitor_id` (UUID) ve `text` alanında okunacak metni gönderin. Yanıt, oynatma için ses verilerini içerir; bir `<audio>` elemanı için aynı yol ayrıca GET ile de kullanılabilir. Uç nokta, `POST /api/public/widget/voice-speak`'e karşılık gelir, ancak zentor-app.de'deki demoya bağlıdır ve genel bir sesli çıkış arayüzü olarak tasarlanmamıştır. Hata durumları: 400 `INVALID_VISITOR_ID` (eksik veya geçersiz UUID), 403 `ORIGIN_DENIED` (çağrı zentor-app.de'den değil) ve 503 `VOICE_UNAVAILABLE` (ses özelliği şu anda kullanılamıyor).
Genel Bakış
Çağrı: POST /api/global-chatbot/demo/voice-speak. 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: visitor_id (Body), text (Body). Belgelenmiş hata durumları: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. 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
Yalnızca https://zentor-app.de ve https://www.zentor-app.de'den çağrıları kabul eder; demo için bir yerleştirme belirteci (embed token) gerekmez.
İdempotent: Evet
Parametreler
visitor_id(body, string, zorunlu)— Ziyaretçi kimliği, geçerli bir UUID olmalıdırtext(body, string, zorunlu)— Sesli okunacak metinÖrnek Yanıt
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Hata Kodları
400 INVALID_VISITOR_ID — `visitor_id` eksik veya geçerli bir UUID değil.403 ORIGIN_DENIED — Çağrı zentor-app.de'den gelmiyor.503 VOICE_UNAVAILABLE — Ses özelliği şu anda kullanılamıyor.Doğrulanmış davranış
Geçersiz bir `visitor_id` 400 `INVALID_VISITOR_ID` döndürür, kullanılamayan bir ses özelliği 503 `VOICE_UNAVAILABLE` döndürür. Başarı durumu yalnızca zentor-app.de'den mümkündü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.GET /api/global-chatbot/demo/historyDemo tekrar açıldığında korunması için bir demo konuşmasının mevcut mesaj geçmişini yükler.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.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.