POST/api/public/widget/voice-transcribe

將訪客嘅語音錄音轉為文字(語音轉文字),前提係小工具已啟用語音功能。

身份驗證同安全保障

Widget 嵌入權杖(Header X-Widget-Token)+ 來源(Origin)允許清單

冪等: 唔係

參數

widget_code(body, string,必填)
audio(body, binary,必填)— 用於轉錄嘅音頻資料

回應範例

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

錯誤代碼

400 WIDGET_CODE_REQUIRED — 缺少 widget_code。
503 VOICE_UNAVAILABLE — 呢個小工具未啟用語音功能。

即時測試證明

負例(400 欄位缺失、503 語音功能未啟用)已實時驗證。成功個案需要一個已啟用嘅語音小工具、真實音頻,以及已設定嘅語音識別供應商——未有重現。

← 聊天小工具