POST/api/public/widget/voice-transcribe

Перетворює голосовий запис відвідувача в текст (голосове введення), якщо для віджета активовано голосову функцію.

Надішліть `widget_code` і аудіодані в полі `audio` як `multipart/form-data`. Відповідь містить розпізнаний текст, який ви потім надсилаєте через `POST /api/public/widget/message`. Чи активна голосова функція, показує `voice_enabled` у конфігурації віджета. Якщо `widget_code` відсутній, сервер відповідає кодом 400 `WIDGET_CODE_REQUIRED`; якщо голосова функція не активована або тимчасово недоступна — кодом 503 `VOICE_UNAVAILABLE`. Голосову функцію для вашого віджета налаштовує Zentor.

Огляд

Виклик: POST /api/public/widget/voice-transcribe. Цей ендпоінт належить до групи «Чат-віджет» API Zentor App. Потрібен дійсний embed-токен віджета. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: widget_code (тіло), audio (тіло). Задокументовані випадки помилок: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.

Автентифікація та захист

Widget-Embed-Token (заголовок X-Widget-Token) + список дозволених Origin

Ідемпотентний: Ні

Параметри

widget_code(body, string, обов'язково)— Код віджета з вашого коду вбудовування
audio(body, binary, обов'язково)— Аудіозапис як файл (`multipart/form-data`)

Приклад відповіді

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Функція мови наразі недоступна."}}

Коди помилок

400 WIDGET_CODE_REQUIRED — Відсутнє поле `widget_code`.
503 VOICE_UNAVAILABLE — Голосову функцію не активовано для цього віджета або вона тимчасово недоступна.

Перевірена поведінка

Відсутній `widget_code` повертає 400 `WIDGET_CODE_REQUIRED`, віджет без голосової функції — 503 `VOICE_UNAVAILABLE`. Успішний випадок передбачає віджет з активованою голосовою функцією.

Чат-віджет

GET /api/public/widget/healthПроста перевірка доступності сервісу віджета.GET /api/public/widget/config/:widget_codeПовертає публічну конфігурацію віджета (ім’я для показу, текст привітання, дизайн, мову, голосову функцію) для ініціалізації в браузері.POST /api/public/widget/messageНадсилає повідомлення відвідувача чат-боту і повертає його відповідь — центральний кінцевий пункт чат-віджета.GET /api/public/widget/historyЗавантажує попередню історію повідомлень конверсації віджета, наприклад після перезавантаження сторінки.POST /api/public/widget/pollЗапитує повідомлення, що надійшли після певного моменту часу — наприклад, відповідь співробітника, який прийняв розмову.POST /api/public/widget/ratingЗберігає оцінку відвідувача для розмови (корисно або некорисно).POST /api/public/widget/trackФіксує анонімну подію використання віджета (наприклад, «віджет відкрито») для аналізу в панелі керування.POST /api/public/widget/voice-speakПеретворює текст на вимовлену мову (голосовий вивід у віджеті), якщо голосову функцію активовано.

Споріднені статті

← Чат-віджет