POST/api/global-chatbot/demo/voice-transcribe

Chuyển đổi bản ghi âm giọng nói từ trang Demo thành văn bản (Speech-to-Text) nếu giọng nói đã được kích hoạt. Đây là phiên bản Demo tương ứng với widget.voice_transcribe, được gắn cố định với trang Marketing Zentor thay vì gắn với widget của Tenant.

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

Không cần xác thực

Kiểm tra nguồn gốc cố định https://zentor-app.de / https://www.zentor-app.de (không cấu hình được, thay thế cho Widget-Token trên đường dẫn Demo).

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

Tham số

visitor_id(body, string, bắt buộc)— Phải là một UUID hợp lệ
audio(body, file, bắt buộc)— File âm thanh multipart/form-data

Response mẫu

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id phải là một UUID hợp lệ."}}

Mã lỗi

400 INVALID_VISITOR_ID — visitor_id bị thiếu hoặc không phải là UUID hợp lệ.
403 ORIGIN_DENIED — Origin của yêu cầu không phải zentor-app.de.
413 AUDIO_TOO_LARGE — File âm thanh vượt quá giới hạn.
415 AUDIO_TYPE_UNSUPPORTED — Định dạng âm thanh không được hỗ trợ.

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

Các trường hợp lỗi (400 INVALID_VISITOR_ID với Origin-Header chính xác, 403 ORIGIN_DENIED) đã được xác minh trực tuyến. Trường hợp thành công (phiên âm thực tế) không thể kích hoạt bên ngoài miền sản xuất, vì kiểm tra Origin được cố định mã hóa tại zentor-app.de — tương tự như tài liệu ghi nhận trong widget.voice_transcribe.

← Chatbot mẫu và SSO