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 yokufaka
session_id(query, string, kuyadingeka)— I-ID yeseshini yengxoxo evela empendulweni ye-`message`
visitor_id(query, string, kuyadingeka)— I-ID yesivakatshi edalwa yiwijethi njalo igciniwe ebhrawuzeni

Isibonelo 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.

Izihloko ezihlobene

← Iwijethi yengxoxo