GET/api/public/widget/history
Ilayitsha umlando wemilayezo esekhona wengxoxo yewijethi, isibonelo ngemva kokuphindwa kulayishwe ikhasi.
Dlulisani `widget_code`, `session_id` le-`visitor_id` njengama-parameter wombuzo. Impendulo ilomunqulo `data` uhlu `messages` olule-`role` (`user` kumbe `assistant`), `text` lo-`created_at` ngokulandelana kwengxoxo. Isicelo sifunda kuphela njalo silingananisa. I-header `X-Widget-Token` elethokheni yokufaka le-`widget_code` kuyadingakala. Nxa ithokheni kayikho, iseva iphendula ngo-401 `WIDGET_TOKEN_MISSING`, nxa kayivumelekile ngo-401 `WIDGET_TOKEN_INVALID`; izicelo ezivela ezizindeni ezingavuliweyo zithola 403 `WIDGET_ORIGIN_DENIED`, iwijethi evalwe 404 `WIDGET_DISABLED`. Nxa `session_id` kumbe `visitor_id` kayikho, iseva iphendula ngo-400 `PARAMS_REQUIRED`. Nxa iseshini kayisaziwa, qalisani ingxoxo entsha.
Isifinyezo
Ukubiza: GET /api/public/widget/history. Le endpoint ingeyeqembu elithi “Iwijethi yengxoxo” le-API ye-Zentor App. Idinga i-widget embed token esebenzayo. Ukubiza kuyi-idempotent: ukubiza kanengi ngemininingwane efananayo kubuyisela umphumela ofananayo. Amapharamitha adingekayo: widget_code (query), session_id (query), visitor_id (query). Izimo zamaphutha ezibhaliweyo: 400 PARAMS_REQUIRED. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubuwena lokuvikeleka
I-Embed-Token ye-widget (i-header X-Widget-Token) + uhlu lwama-Origin avunyelweyo
I-idempotent: Yebo
Amapharamitha
widget_code(query, string, kuyadingeka)— Ikhodi yewijethi evela ekhodini yakho yokufakasession_id(query, string, kuyadingeka)— I-ID yeseshini yengxoxo evela empendulweni ye-`message`visitor_id(query, string, kuyadingeka)— I-ID yesivakatshi edalwa yiwijethi njalo igciniwe ebhrawuzeniIsibonelo sempendulo (response)
{"ok":true,"data":{"messages":[{"role":"user","text":"Sawubona...","created_at":"..."},{"role":"assistant","text":"...","created_at":"..."}]}}Amakhodi amaphutha
400 PARAMS_REQUIRED — `session_id` kumbe `visitor_id` kayikho.Ukuziphatha okuhlolwe
Iseshini ekhona inikeza 200 lomlando wemilayezo; ama-parameter angekho anikeza 400 `PARAMS_REQUIRED`.
Iwijethi yengxoxo
GET /api/public/widget/healthUkuhlolwa okulula kokutholakala kwesevisi yewijethi.GET /api/public/widget/config/:widget_codeInikeza ukuhlelwa komphakathi kwewijethi (ibizo elibonakalayo, umbhalo wokwamukela, idizayini, ulimi, umsebenzi wezwi) wokuqaliswa kubhrawuza.POST /api/public/widget/messageIthumela umlayezo wesivakatshi ku-chatbot njalo inikeze impendulo yayo – isiphetho esimaphakathi sewijethi yengxoxo.POST /api/public/widget/pollIthatha imilayezo etholwe ngemva kwesikhathi esithile – isibonelo impendulo yesisebenzi esithatha ingxoxo.POST /api/public/widget/ratingIgcina isilinganiso sesivakatshi ngengxoxo (kuyasiza kumbe kakusizi).POST /api/public/widget/trackIbhala izenzakalo yokusetshenziswa engaziwa yewijethi (isib. „iwijethi ivuliwe“) yokuhlaziywa kwedashboard.POST /api/public/widget/voice-transcribeIguqula ukuqoshwa kwezwi kwesivakatshi kube umbhalo (ukufakwa kwezwi), nxa umsebenzi wezwi wewijethi uvuliwe.POST /api/public/widget/voice-speakIguqula umbhalo kube ulimi olukhulunywayo (ukukhishwa kwezwi ewijethini), nxa umsebenzi wezwi uvuliwe.