POST/api/global-chatbot/demo/voice-speak
將文字轉換為語音(文字轉語音),用於示範頁面的語音輸出(如已啟用)。
`POST /api/global-chatbot/demo/voice-speak` 在示範的語音功能已啟用時,將文字轉換為語音。此端點由公開示範頁面使用,並非供自由使用的通用文字轉語音 API。它不需要儀表板身份驗證,但會對 `https://zentor-app.de` 及 `https://www.zentor-app.de` 進行固定的來源檢查。 請求包含要輸出的文字,以及文件所列 Schema 中的語音選項。用戶端只應傳送實際需要在示範對話中讀出的文字。空白輸入、無效格式或未啟用的語音功能都必須當作錯誤處理。在本地修改 Origin 或從其他網域呼叫,都無法繞過伺服器端檢查。 此操作會產生音訊,因此不可視為冪等的純讀取操作。重複傳送同一段文字可能觸發多次處理。示範介面應在處理期間停用輸出按鈕,並在開始新播放前妥善結束正在播放的內容。 實際流程由示範中的機器人回覆開始。用戶啟用語音輸出後,頁面把回覆文字傳送至 `voice-speak`,收到音訊數據或文件所述的音訊回應,並在瀏覽器中播放。若請求因 Origin 不獲允許而失敗,介面不得呼叫任何替代服務,而應顯示語音功能不可用。 密碼、Token 或機密內容不應放入請求。示範渠道是公開的,並非用於機密企業數據。音訊回應亦不應長期儲存在公開日誌中。此端點在技術上與 SIP-Voicebot 分開。電話服務在每個租戶獨立的 SIP 實例中運行,並只由主管理員啟用;`voice-speak` 不會控制任何電話號碼,亦不會發起電話通話。 為確保無障礙,示範除輸出音訊外,應一直顯示完整文字。語音輸出不得包含畫面上沒有的資訊。在用戶未有互動前,瀏覽器可能會阻止播放;因此應刻意由點擊觸發播放。中止及重新播放都必須能夠受控地進行。
身份驗證同安全保障
唔需要身份驗證
來源檢查固定為 https://zentor-app.de / https://www.zentor-app.de(不可設定,在示範路徑上代替小工具 Token)。
冪等: 係
參數
visitor_id(body, string,必填)— 必須為有效的 UUIDtext(body, string,必填)— 要轉換成語音的文字回應範例
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}錯誤代碼
400 INVALID_VISITOR_ID — visitor_id 遺失或並非有效 UUID。403 ORIGIN_DENIED — 請求來源並非 zentor-app.de。503 VOICE_UNAVAILABLE — 語音功能暫時無法使用。即時測試證明
負面情況(400 INVALID_VISITOR_ID、503 VOICE_UNAVAILABLE,均附正確 Origin-Header)已實時驗證。同一路徑亦有 GET 版本(原生 <audio src> 串流,行為相同)。此為 widget.voice_speak 的示範對應版本。