GET/api/public/widget/history
Încarcă istoricul de mesaje anterior al unei conversații de widget, de exemplu după reîncărcarea paginii.
Transmiteți `widget_code`, `session_id` și `visitor_id` ca parametri de interogare. Răspunsul conține, în obiectul `data`, lista `messages` cu `role` (`user` sau `assistant`), `text` și `created_at` în ordinea conversației. Apelul este doar pentru citire și idempotent. Antetul `X-Widget-Token` cu tokenul de încorporare și `widget_code` sunt obligatorii. Dacă tokenul lipsește, serverul răspunde cu 401 `WIDGET_TOKEN_MISSING`; dacă este invalid, cu 401 `WIDGET_TOKEN_INVALID`; apelurile din domenii neaprobate primesc 403 `WIDGET_ORIGIN_DENIED`, iar un widget dezactivat 404 `WIDGET_DISABLED`. Dacă lipsesc `session_id` sau `visitor_id`, serverul răspunde cu 400 `PARAMS_REQUIRED`. Dacă sesiunea nu mai este cunoscută, începeți o conversație nouă.
Prezentare generală
Apel: GET /api/public/widget/history. Acest endpoint aparține grupului „Widget de chat” al API-ului Zentor App. Necesită un token valid de încorporare a widgetului. Apelul este idempotent: apelurile repetate cu aceleași date returnează același rezultat. Parametri obligatorii: widget_code (query), session_id (query), visitor_id (query). Cazuri de eroare documentate: 400 PARAMS_REQUIRED. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.
Autentificare și securitate
Token de embed pentru widget (header X-Widget-Token) + listă de origini permise
Idempotent: Da
Parametri
widget_code(query, string, obligatoriu)— Codul widgetului din codul dumneavoastră de încorporaresession_id(query, string, obligatoriu)— ID de sesiune al conversației din răspunsul de la `message`visitor_id(query, string, obligatoriu)— ID de vizitator generat de widget și stocat în browserExemplu de răspuns
{"ok":true,"data":{"messages":[{"role":"user","text":"Salut...","created_at":"..."},{"role":"assistant","text":"...","created_at":"..."}]}}Coduri de eroare
400 PARAMS_REQUIRED — `session_id` sau `visitor_id` lipsește.Comportament verificat
O sesiune existentă returnează 200 cu istoricul mesajelor; parametrii lipsă returnează 400 `PARAMS_REQUIRED`.
Widget de chat
GET /api/public/widget/healthVerificare simplă a disponibilității serviciului de widget.GET /api/public/widget/config/:widget_codeOferă configurația publică a unui widget (nume afișat, mesaj de bun venit, design, limbă, funcție vocală) pentru inițializarea în browser.POST /api/public/widget/messageTrimite un mesaj al vizitatorului către chatbot și returnează răspunsul acestuia — endpointul central al widgetului de chat.POST /api/public/widget/pollObține mesajele primite după un anumit moment — de exemplu răspunsul unui angajat care a preluat conversația.POST /api/public/widget/ratingSalvează evaluarea vizitatorului despre o conversație (utilă sau neutilă).POST /api/public/widget/trackÎnregistrează un eveniment anonim de utilizare a widgetului (de ex. „widget deschis”) pentru analizele din panoul de control.POST /api/public/widget/voice-transcribeConvertește o înregistrare vocală a vizitatorului în text (intrare vocală), dacă funcția vocală este activată pentru widget.POST /api/public/widget/voice-speakConvertește text în vorbire (ieșire vocală în widget), dacă funcția vocală este activată.