POST/api/public/widget/voice-transcribe

Zamienia nagranie głosowe odwiedzającego na tekst (wprowadzanie głosowe), jeśli funkcja głosowa jest aktywowana dla widżetu.

Wyślijcie `widget_code` i dane audio w polu `audio` jako `multipart/form-data`. Odpowiedź zawiera rozpoznany tekst, który następnie wysyłacie przez `POST /api/public/widget/message`. Czy funkcja głosowa jest aktywna, wskazuje `voice_enabled` w konfiguracji widżetu. Jeśli brakuje `widget_code`, serwer odpowiada 400 `WIDGET_CODE_REQUIRED`; jeśli funkcja głosowa nie jest aktywowana lub jest aktualnie niedostępna, 503 `VOICE_UNAVAILABLE`. Funkcję głosową dla Waszego widżetu konfiguruje Zentor.

Przegląd

Wywołanie: POST /api/public/widget/voice-transcribe. Ten endpoint należy do grupy „Widżet czatu” API Zentor App. Wymaga ważnego tokenu osadzania widżetu. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: widget_code (body), audio (body). Udokumentowane przypadki błędów: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.

Uwierzytelnianie i zabezpieczenia

Token osadzenia widżetu (nagłówek X-Widget-Token) + lista dozwolonych originów

Idempotentny: Nie

Parametry

widget_code(body, string, wymagane)— Kod widżetu z Waszego kodu osadzania
audio(body, binary, wymagane)— Nagranie audio jako plik (`multipart/form-data`)

Przykładowa odpowiedź

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funkcja mowy jest obecnie niedostępna."}}

Kody błędów

400 WIDGET_CODE_REQUIRED — Brakuje pola `widget_code`.
503 VOICE_UNAVAILABLE — Funkcja głosowa nie jest aktywowana dla tego widżetu lub jest aktualnie niedostępna.

Zweryfikowane zachowanie

Brakujący `widget_code` zwraca 400 `WIDGET_CODE_REQUIRED`, widżet bez funkcji głosowej 503 `VOICE_UNAVAILABLE`. Przypadek sukcesu wymaga widżetu z aktywowaną funkcją głosową.

Widżet czatu

GET /api/public/widget/healthProste sprawdzenie dostępności usługi widżetu.GET /api/public/widget/config/:widget_codeZwraca publiczną konfigurację widżetu (nazwa wyświetlana, powitanie, wygląd, język, funkcja głosowa) do inicjalizacji w przeglądarce.POST /api/public/widget/messageWysyła wiadomość odwiedzającego do chatbota i zwraca jego odpowiedź — centralny punkt końcowy widżetu czatu.GET /api/public/widget/historyWczytuje wcześniejszą historię wiadomości rozmowy widżetu, na przykład po ponownym wczytaniu strony.POST /api/public/widget/pollPobiera wiadomości otrzymane po określonym momencie — na przykład odpowiedź pracownika, który przejął rozmowę.POST /api/public/widget/ratingZapisuje ocenę odwiedzającego dotyczącą rozmowy (pomocna lub niepomocna).POST /api/public/widget/trackRejestruje anonimowe zdarzenie użycia widżetu (np. „widżet otwarty”) na potrzeby analiz w panelu.POST /api/public/widget/voice-speakZamienia tekst na mowę (wyjście głosowe w widżecie), jeśli funkcja głosowa jest aktywowana.

Powiązane artykuły

← Widżet czatu