POST/api/public/widget/voice-transcribe
Widget için sesli işlev etkinleştirilmişse, ziyaretçinin sesli kaydını metne dönüştürür (sesli giriş).
`widget_code`'u ve `audio` alanında ses verisini `multipart/form-data` olarak gönderin. Yanıt, ardından `POST /api/public/widget/message` üzerinden göndereceğiniz tanınan metni içerir. Sesli işlevin etkin olup olmadığını widget yapılandırmasındaki `voice_enabled` gösterir. `widget_code` eksikse, sunucu 400 `WIDGET_CODE_REQUIRED` ile yanıt verir; sesli işlev etkin değilse veya şu anda kullanılamıyorsa, 503 `VOICE_UNAVAILABLE` ile. Sesli işlevi Zentor widget'ınız için kurar.
Genel Bakış
Çağrı: POST /api/public/widget/voice-transcribe. Bu uç nokta, Zentor App API'sinin “Sohbet Widget'ı” grubuna aittir. Geçerli bir widget embed token'ı gerektirir. Çağrı idempotent değildir: Her başarılı çağrı işlemi yeniden tetikler. Zorunlu parametreler: widget_code (Body), audio (Body). Belgelenmiş hata durumları: 400 WIDGET_CODE_REQUIRED, 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
Widget gömme jetonu (X-Widget-Token başlığı) + kaynak onay listesi
İdempotent: Hayır
Parametreler
widget_code(body, string, zorunlu)— Yerleştirme (embed) kodunuzdan widget koduaudio(body, binary, zorunlu)— Dosya olarak ses kaydı (`multipart/form-data`)Örnek Yanıt
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Hata Kodları
400 WIDGET_CODE_REQUIRED — `widget_code` alanı eksik.503 VOICE_UNAVAILABLE — Sesli işlev bu widget için etkinleştirilmemiş veya şu anda kullanılamıyor.Doğrulanmış davranış
Eksik bir `widget_code` 400 `WIDGET_CODE_REQUIRED` döner, sesli işlevi olmayan bir widget 503 `VOICE_UNAVAILABLE` döner. Başarı durumu, sesli işlevi etkinleştirilmiş bir widget gerektirir.
Sohbet Widget'ı
GET /api/public/widget/healthWidget hizmetinin basit bir erişilebilirlik kontrolü.GET /api/public/widget/config/:widget_codeTarayıcıda başlatma için bir widget'ın herkese açık yapılandırmasını (görünen ad, karşılama metni, tasarım, dil, sesli işlev) döndürür.POST /api/public/widget/messageZiyaretçinin bir mesajını sohbet botuna gönderir ve onun yanıtını döndürür – sohbet widget'ının merkezi uç noktası.GET /api/public/widget/historyÖrneğin sayfa yeniden yüklendikten sonra, bir widget konuşmasının önceki mesaj geçmişini yükler.POST /api/public/widget/pollBelirli bir zamandan sonra alınan mesajları alır – örneğin, konuşmayı devralan bir çalışanın yanıtı.POST /api/public/widget/ratingZiyaretçinin bir konuşma hakkındaki değerlendirmesini (yararlı veya yararlı değil) kaydeder.POST /api/public/widget/trackDashboard'daki analizler için widget'ın anonim bir kullanım olayını (örn. "widget açıldı") kaydeder.POST /api/public/widget/voice-speakSesli işlev etkinleştirilmişse, metni sesli konuşmaya dönüştürür (widget'ta sesli çıkış).