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

Zamienia nagranie audio wypowiedzi ze strony demo na tekst (speech-to-text), o ile funkcja mowy jest włączona. Odpowiednik widget.voice_transcribe dla demo, na stałe powiązany ze stroną marketingową Zentor zamiast z widgetem tenanta.

Uwierzytelnianie i zabezpieczenia

Uwierzytelnianie nie jest wymagane

Weryfikacja Origin na stałe ustawiona na https://zentor-app.de / https://www.zentor-app.de (niekonfigurowalna, zastępuje token widżetu na ścieżce demo).

Idempotentny: Nie

Parametry

visitor_id(body, string, wymagane)— Musi być prawidłowym UUID
audio(body, file, wymagane)— plik audio multipart/form-data

Przykładowa odpowiedź

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id musi być prawidłowym UUID."}}

Kody błędów

400 INVALID_VISITOR_ID — Brak visitor_id lub nie jest to poprawny UUID.
403 ORIGIN_DENIED — Origin żądania nie jest zentor-app.de.
413 AUDIO_TOO_LARGE — Plik audio przekracza limit.
415 AUDIO_TYPE_UNSUPPORTED — Nieobsługiwany format audio.

Dowód z testu na żywo

Przypadki negatywne (400 INVALID_VISITOR_ID z poprawnym nagłówkiem Origin, 403 ORIGIN_DENIED) zweryfikowano na żywo. Przypadku udanego (rzeczywista transkrypcja) nie da się wywołać poza domeną produkcyjną, ponieważ weryfikacja Origin jest zakodowana na stałe na zentor-app.de — udokumentowano analogicznie do widget.voice_transcribe.

← Demo-chatbot i SSO