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

Demo sayfasındaki bir ses kaydını metne dönüştürür (sesli giriş), demo'nun ses özelliği etkinleştirilmişse.

`visitor_id` (UUID) ve ses dosyasını `audio` alanında `multipart/form-data` olarak gönderin. Yanıt, tanınan metni içerir. Uç nokta, `POST /api/public/widget/voice-transcribe`'a karşılık gelir, ancak zentor-app.de'deki demoya bağlıdır. Hata durumları: 400 `INVALID_VISITOR_ID` (eksik veya geçersiz UUID), 403 `ORIGIN_DENIED` (çağrı zentor-app.de'den değil), 413 `AUDIO_TOO_LARGE` (dosya çok büyük) ve 415 `AUDIO_TYPE_UNSUPPORTED` (format desteklenmiyor).

Genel Bakış

Çağrı: POST /api/global-chatbot/demo/voice-transcribe. 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ı idempotent değildir: Her başarılı çağrı işlemi yeniden tetikler. Zorunlu parametreler: visitor_id (Body), audio (Body). Belgelenmiş hata durumları: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. 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: Hayır

Parametreler

visitor_id(body, string, zorunlu)— Ziyaretçi kimliği, geçerli bir UUID olmalıdır
audio(body, file, zorunlu)— Ses dosyası (`multipart/form-data`)

Örnek Yanıt

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

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.
413 AUDIO_TOO_LARGE — Ses dosyası izin verilen boyutu aşıyor.
415 AUDIO_TYPE_UNSUPPORTED — Ses formatı desteklenmiyor.

Doğrulanmış davranış

Geçersiz bir `visitor_id` 400 `INVALID_VISITOR_ID` döndürür, başka bir alan adından çağrı 403 `ORIGIN_DENIED` 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-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