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

Ses özelliği etkinse, demo sayfasından konuşulan bir ses kaydını metne dönüştürür (konuşmadan metne). widget.voice_transcribe'ın demo karşılığı, bir kiracı widget'ı yerine Zentor pazarlama sitesine bağlıdır.

`POST /api/global-chatbot/demo/voice-transcribe`, demo sayfasından gönderilen bir ses kaydını metne dönüştürür. İşlev yalnızca ses özelliği etkin olduğunda kullanılabilir. Bu uç nokta, kiracı widgetı için kullanılan ses transkripsiyonunun demo karşılığıdır ve Zentor pazarlama sitesinin demo kanalına bağlıdır. Gösterge paneli oturumu gerekmez, ancak istek kaynağı ve dosya biçimi sunucu tarafından kontrol edilir. İstemci, desteklenen ses verisini belgelenen alan adıyla göndermelidir. Boş kayıt, geçersiz içerik türü, aşırı büyük dosya veya devre dışı özellik hata üretmelidir. Kullanıcı arayüzü kayıt başlamadan önce mikrofon izni istemeli ve izin reddedildiğinde metin girişine geri dönmelidir. İşlem saf bir okuma değildir; her ses kaydı harici veya yerel konuşma işleme sürecini tetikleyebilir. Aynı kaydın arka arkaya gönderilmesi gereksiz işlem oluşturur. Gönderim sırasında kayıt düğmesi devre dışı bırakılmalı ve istemci tek bir aktif transkripsiyon tutmalıdır. Örnek akışta kullanıcı demo sayfasında mikrofonu açar, kısa bir soru kaydeder ve kaydı gönderir. Sunucu sesi işler ve metni döndürür. Arayüz metni kullanıcıya göstermeli, gerektiğinde düzenleme fırsatı vermeli ve ancak onaydan sonra normal demo mesaj uç noktasına iletmelidir. Böylece hatalı tanıma doğrudan chatbot sorusu hâline gelmez. Parolalar, gizli bilgiler veya gerçek müşteri kayıtları demo ses alanına okunmamalıdır. Ses dosyaları ve dönen metinler herkese açık loglarda saklanmamalıdır. Bu uç nokta SIP telefonisini yönetmez, arama başlatmaz ve tenant telefon numaralarına erişmez. SIP voicebot ayrı, izole bir altyapıda çalışır ve Master Admin tarafından etkinleştirilir. Transkripsiyon sonucu dil ve özel adlar açısından hatalı olabilir. Arayüz, dönen metni düzenlenebilir biçimde göstermeli ve kullanıcının onayını almalıdır. Özellikle ürün adları, e-posta adresleri veya sayılar ses tanımada yanlış çıkabilir. Onay adımı, yanlış metnin chatbot iş akışını tetiklemesini önler. İstemci, kaydın gerçekten durdurulduğunu doğrulamadan dosyayı göndermemelidir. Sessiz veya çok kısa kayıtlar için kullanıcıdan yeniden deneme istenebilir. Ağ bağlantısı kesilirse aynı dosya otomatik olarak tekrar tekrar yüklenmemeli; kullanıcı kontrollü bir yeniden gönderim seçeneği görmelidir. Dönen metin boşsa veya belirgin biçimde eksikse mesaj uç noktasına gönderilmemelidir. Kullanıcıya yeniden kayıt, manuel düzeltme veya normal metin girişi seçenekleri sunulmalıdır. Bu, hatalı transkripsiyonun sonraki iş akışlarını tetiklemesini engeller.

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