POST/api/public/widget/voice-transcribe
訪問者の音声録音をテキストに変換します(Speech-to-Text)。ただし、ウィジェットで音声機能が有効になっている場合に限ります。
Auth & Absicherung
Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste
Idempotent: Nein
Parameter
widget_code(body, string, erforderlich)audio(body, binary, erforderlich)— トランスクリプション用のオーディオデータBeispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"音声機能は現在利用できません。"}}Fehlercodes
400 WIDGET_CODE_REQUIRED — widget_code が不足しています。503 VOICE_UNAVAILABLE — このウィジェットでは言語機能は有効化されていません。Live-Test-Nachweis
ネガティブケース(400:フィールド不足、503:音声機能が有効化されていない)を実環境で検証済み。成功ケースは、実際の音声と設定された音声認識プロバイダを備えた有効化された音声ウィジェットが必要であり、シミュレーションでは不十分です。