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Перетворює текст на вимовлену мову (голосовий вивід у віджеті), якщо голосову функцію активовано.