POST/api/public/widget/voice-speak

Chuyển văn bản thành giọng nói (Text-to-Speech) cho giọng đọc trong widget, nếu đã kích hoạt.

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): Có

Tham số

widget_code(body, string, bắt buộc)
text(body, string, bắt buộc)— Văn bản cần chuyển đổi sang giọng nói

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 (400, 503) cho POST đã được xác minh trên môi trường live. Biến thể GET của cùng một đường dẫn cũng tồn tại (hành vi giống nhau theo Tự động trích xuất), không cần kiểm tra lại riêng biệt.

← Widget trò chuyện