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

Chuyển đổi một bản ghi âm trên trang demo thành văn bản (nhập giọng nói), nếu tính năng giọng nói của demo được bật.

Gửi `visitor_id` (UUID) và dữ liệu âm thanh trong trường `audio` dưới dạng `multipart/form-data`. Phản hồi chứa văn bản được nhận dạng. Endpoint này tương ứng với `POST /api/public/widget/voice-transcribe`, nhưng chỉ dành riêng cho demo trên zentor-app.de. Các trường hợp lỗi: 400 `INVALID_VISITOR_ID` (UUID bị thiếu hoặc không hợp lệ), 403 `ORIGIN_DENIED` (lệnh gọi không đến từ zentor-app.de), 413 `AUDIO_TOO_LARGE` (tệp quá lớn) và 415 `AUDIO_TYPE_UNSUPPORTED` (định dạng không được hỗ trợ).

Tổng quan

Lệnh gọi: POST /api/global-chatbot/demo/voice-transcribe. Endpoint này thuộc nhóm “Chatbot demo và SSO” trong API của Zentor App. Endpoint này được truy cập công khai và không yêu cầu xác thực. Lệnh gọi không có tính idempotent: mỗi lệnh gọi thành công đều kích hoạt lại hành động. Tham số bắt buộc: visitor_id (body), audio (body). Các trường hợp lỗi được tài liệu hóa: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Phản hồi mẫu bên dưới cho thấy cấu trúc của một phản hồi thành công ở định dạng JSON.

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

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

Chỉ chấp nhận các lệnh gọi từ https://zentor-app.de và https://www.zentor-app.de; demo không cần embed token.

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

Tham số

visitor_id(body, string, bắt buộc)— Visitor ID, phải là một UUID hợp lệ
audio(body, file, bắt buộc)— Tệp â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 — Lệnh gọi không đến từ zentor-app.de.
413 AUDIO_TOO_LARGE — Tệp âm thanh vượt quá kích thước cho phép.
415 AUDIO_TYPE_UNSUPPORTED — Định dạng âm thanh không được hỗ trợ.

Hành vi đã được xác minh

`visitor_id` không hợp lệ trả về 400 `INVALID_VISITOR_ID`, lệnh gọi từ miền khác trả về 403 `ORIGIN_DENIED`. Trường hợp thành công chỉ có thể xảy ra từ zentor-app.de.

Chatbot demo và SSO

POST /api/global-chatbot/demoGửi một tin nhắn đến chatbot demo công khai tại zentor-app.de/demo và trả về câu trả lời của nó. Có thể dùng thử demo trong trình duyệt mà không cần đăng ký.GET /api/global-chatbot/demo/historyTải lịch sử tin nhắn trước đó của một cuộc hội thoại demo để nó được giữ lại khi mở lại demo.POST /api/global-chatbot/demo/pollLấy các tin nhắn mới của một cuộc hội thoại demo, chẳng hạn khi một nhân viên Zentor đã tiếp nhận cuộc hội thoại. Trang demo gọi endpoint này theo khoảng thời gian.POST /api/global-chatbot/demo/ratingLưu đánh giá của một cuộc hội thoại demo (có ích hoặc không có ích) kèm bình luận không bắt buộc.POST /api/global-chatbot/demo/trackGhi lại các sự kiện sử dụng ẩn danh trên trang demo cho số liệu thống kê khách truy cập của Zentor.POST /api/global-chatbot/demo/voice-speakChuyển đổi văn bản thành giọng nói (xuất giọng nói trên trang demo), nếu tính năng giọng nói của demo được bật.GET /api/sso/:tenantSlug/statusKiểm tra liệu single sign-on (SAML hoặc OIDC) đã được thiết lập cho một tài khoản hay chưa. Trang đăng nhập sử dụng kết quả này để cung cấp tùy chọn đăng nhập SSO.GET /api/sso/:tenantSlug/oidc/startBắt đầu đăng nhập qua OpenID Connect và chuyển hướng trình duyệt đến identity provider đã được cấu hình.GET /api/sso/:tenantSlug/oidc/callbackNhận chuyển hướng của identity provider sau khi đăng nhập OIDC và chuyển hướng trình duyệt trở lại Zentor App.GET /api/sso/:tenantSlug/saml/startBắt đầu đăng nhập qua SAML và chuyển hướng trình duyệt đến identity provider đã được cấu hình.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): nhận phản hồi SAML đã ký của identity provider qua form POST.GET /api/sso/:tenantSlug/saml/metadataTrả về metadata SAML của Zentor App (XML) để nhập vào identity provider của bạn.

Bài viết liên quan

← Chatbot demo và SSO