POST/api/public/widget/voice-transcribe

訪問者の音声録音をテキストに変換します(Speech-to-Text)。ただし、ウィジェットで音声機能が有効になっている場合に限ります。

Auth & Absicherung

ウィジェット埋め込みトークン(X-Widget-Token ヘッダー) + オリジン許可リスト

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:音声機能が有効化されていない)を実環境で検証済み。成功ケースは、実際の音声と設定された音声認識プロバイダを備えた有効化された音声ウィジェットが必要であり、シミュレーションでは不十分です。

← チャットウィジェット