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

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

Надішліть `visitor_id` (UUID) і аудіофайл у полі `audio` як `multipart/form-data`. Відповідь містить розпізнаний текст. Кінцевий пункт відповідає `POST /api/public/widget/voice-transcribe`, але прив’язаний до демо на zentor-app.de. Випадки помилок: 400 `INVALID_VISITOR_ID` (відсутній або недійсний UUID), 403 `ORIGIN_DENIED` (виклик не з zentor-app.de), 413 `AUDIO_TOO_LARGE` (файл занадто великий) і 415 `AUDIO_TYPE_UNSUPPORTED` (формат не підтримується).

Огляд

Виклик: POST /api/global-chatbot/demo/voice-transcribe. Цей ендпоінт належить до групи «Демо-чат-бот і SSO» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: visitor_id (тіло), audio (тіло). Задокументовані випадки помилок: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.

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

Автентифікація не потрібна

Приймає лише виклики з https://zentor-app.de та https://www.zentor-app.de; embed-токен для демо не потрібен.

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

Параметри

visitor_id(body, string, обов'язково)— ID відвідувача, має бути дійсним UUID
audio(body, file, обов'язково)— Аудіофайл (`multipart/form-data`)

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

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id має бути дійсною UUID."}}

Коди помилок

400 INVALID_VISITOR_ID — `visitor_id` відсутній або не є дійсним UUID.
403 ORIGIN_DENIED — Виклик не надходить з zentor-app.de.
413 AUDIO_TOO_LARGE — Аудіофайл перевищує допустимий розмір.
415 AUDIO_TYPE_UNSUPPORTED — Аудіоформат не підтримується.

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

Недійсний `visitor_id` повертає 400 `INVALID_VISITOR_ID`, виклик з іншого домену — 403 `ORIGIN_DENIED`. Успішний випадок можливий лише з zentor-app.de.

Демо-чат-бот і SSO

POST /api/global-chatbot/demoНадсилає повідомлення публічному демо-чат-боту на zentor-app.de/demo і повертає його відповідь. Демо можна спробувати в браузері без реєстрації.GET /api/global-chatbot/demo/historyЗавантажує попередню історію повідомлень демо-розмови, щоб вона збереглася при повторному відкритті демо.POST /api/global-chatbot/demo/pollОтримує нові повідомлення демо-розмови, наприклад коли співробітник Zentor перейняв розмову. Сторінка демо викликає кінцевий пункт з інтервалами.POST /api/global-chatbot/demo/ratingЗберігає оцінку демо-розмови (корисно чи некорисно) з опціональним коментарем.POST /api/global-chatbot/demo/trackФіксує анонімні події використання сторінки демо для статистики відвідувачів Zentor.POST /api/global-chatbot/demo/voice-speakПеретворює текст у мовлення (голосовий вивід на сторінці демо), якщо голосова функція демо активована.GET /api/sso/:tenantSlug/statusПеревіряє, чи налаштовано для акаунта єдиний вхід (SAML або OIDC). Сторінка входу використовує результат, щоб запропонувати вхід через SSO.GET /api/sso/:tenantSlug/oidc/startЗапускає вхід через OpenID Connect і переспрямовує браузер до налаштованого провайдера ідентифікації.GET /api/sso/:tenantSlug/oidc/callbackПриймає переспрямування від провайдера ідентифікації після входу через OIDC і переспрямовує браузер назад до Zentor App.GET /api/sso/:tenantSlug/saml/startЗапускає вхід через SAML і переспрямовує браузер до налаштованого провайдера ідентифікації.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): приймає підписану SAML-відповідь провайдера ідентифікації через форму POST.GET /api/sso/:tenantSlug/saml/metadataПовертає SAML-метадані Zentor App (XML) для імпорту у вашого провайдера ідентифікації.

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

← Демо-чат-бот і SSO