POST/api/public/widget/voice-transcribe

Chuyển đổi bản ghi âm giọng nói của người dùng thành văn bản (Speech-to-Text), nếu chức năng giọng nói đã được kích hoạt cho widget.

Xác thực & bảo mật

Widget-Embed-Token (Header X-Widget-Token) + danh sách Origin được cho phép

Lũy đẳng (idempotent): Không

Tham số

widget_code(body, string, bắt buộc)
audio(body, binary, bắt buộc)— Dữ liệu âm thanh để chuyển văn bản

Response mẫu

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Chức năng giọng nói hiện không khả dụng."}}

Mã lỗi

400 WIDGET_CODE_REQUIRED — widget_code còn thiếu.
503 VOICE_UNAVAILABLE — Chức năng giọng nói chưa được kích hoạt cho widget này.

Bằng chứng kiểm thử trực tiếp

Các trường hợp âm tính (400 trường thiếu trường, 503 chức năng ngôn ngữ chưa được kích hoạt) đã được xác minh trực tiếp. Một trường hợp thành công sẽ yêu cầu một tiện ích giọng nói được kích hoạt với âm thanh thật và một nhà cung cấp nhận diện giọng nói đã được cấu hình — không được mô phỏng.

← Widget trò chuyện