GET/api/public/widget/history
Načíta predchádzajúcu históriu správ konverzácie widgetu, napríklad po opätovnom načítaní stránky.
Odovzdajte `widget_code`, `session_id` a `visitor_id` ako parametre dopytu. Odpoveď obsahuje v objekte `data` zoznam `messages` s `role` (`user` alebo `assistant`), `text` a `created_at` v poradí konverzácie. Volanie je iba na čítanie a idempotentné. Hlavička `X-Widget-Token` s vkladacím tokenom a `widget_code` sú povinné. Ak token chýba, server odpovie 401 `WIDGET_TOKEN_MISSING`, ak je neplatný, 401 `WIDGET_TOKEN_INVALID`; volania z nepovolených domén dostanú 403 `WIDGET_ORIGIN_DENIED`, deaktivovaný widget 404 `WIDGET_DISABLED`. Chýba-li `session_id` alebo `visitor_id`, server odpovie 400 `PARAMS_REQUIRED`. Ak relácia už nie je známa, začnite novú konverzáciu.
Prehľad
Volanie: GET /api/public/widget/history. Tento endpoint patrí do skupiny „Chatový widget“ API aplikácie Zentor App. Vyžaduje platný token na vloženie widgetu. Volanie je idempotentné: Opakované volania s rovnakými údajmi vracajú rovnaký výsledok. Povinné parametre: widget_code (query), session_id (query), visitor_id (query). Zdokumentované chybové prípady: 400 PARAMS_REQUIRED. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.
Autentifikácia a zabezpečenie
Embed token widgetu (hlavička X-Widget-Token) + zoznam povolených pôvodov (Origin)
Idempotentné: Áno
Parametre
widget_code(query, string, povinné)— Kód widgetu z vášho vkladacieho kódusession_id(query, string, povinné)— ID relácie konverzácie z odpovede `message`visitor_id(query, string, povinné)— ID návštevníka vygenerované widgetom a uložené v prehliadačiPríklad odpovede
{"ok":true,"data":{"messages":[{"role":"user","text":"Ahoj...","created_at":"..."},{"role":"assistant","text":"...","created_at":"..."}]}}Chybové kódy
400 PARAMS_REQUIRED — Chýba `session_id` alebo `visitor_id`.Overené správanie
Existujúca relácia vráti 200 s históriou správ; chýbajúce parametre vrátia 400 `PARAMS_REQUIRED`.
Chatový widget
GET /api/public/widget/healthJednoduchá kontrola dostupnosti služby widgetu.GET /api/public/widget/config/:widget_codeVracia verejnú konfiguráciu widgetu (zobrazovaný názov, uvítací text, dizajn, jazyk, hlasová funkcia) na inicializáciu v prehliadači.POST /api/public/widget/messageOdošle správu návštevníka chatbotovi a vráti jeho odpoveď – centrálny endpoint chatovacieho widgetu.POST /api/public/widget/pollZíska správy prijaté po určitom okamihu – napríklad odpoveď pracovníka, ktorý prevzal konverzáciu.POST /api/public/widget/ratingUloží hodnotenie návštevníka konverzácie (užitočné alebo neužitočné).POST /api/public/widget/trackZaznamená anonymnú udalosť využitia widgetu (napr. „widget otvorený“) pre analýzy v dashboarde.POST /api/public/widget/voice-transcribePrevedie hlasovú nahrávku návštevníka na text (hlasový vstup), ak je pre widget aktivovaná hlasová funkcia.POST /api/public/widget/voice-speakPrevedie text na hovorené slovo (hlasový výstup v widgete), ak je hlasová funkcia aktivovaná.