GET/api/public/widget/history
Ilayisha umlando wemiyalezo eyisekhona wengxoxo yewijethi, isibonelo ngemva kokulayishwa kabusha kwekhasi.
Dlulisani `widget_code`, `session_id` ne-`visitor_id` njengama-parameter wenqwabu. Impendulo iqukethe kwisakhiwo `data` uhlu `messages` olune-`role` (`user` noma `assistant`), `text` ne-`created_at` ngokulandelana kwengxoxo. Isicelo sifunda kuphela futhi silingananisa. I-header `X-Widget-Token` enethokheni yokufaka ne-`widget_code` kudingekile. Uma ithokheni ingekho, iseva isabela ngo-401 `WIDGET_TOKEN_MISSING`, uma ingavumeleki ngo-401 `WIDGET_TOKEN_INVALID`; izicelo ezivela ezizindeni ezingavuliwe zithola 403 `WIDGET_ORIGIN_DENIED`, iwijethi evalwe 404 `WIDGET_DISABLED`. Uma `session_id` noma `visitor_id` ingekho, iseva isabela ngo-400 `PARAMS_REQUIRED`. Uma iseshini ingasaziwa, qalani ingxoxo entsha.
Ukubuka konke
Ukubiza: GET /api/public/widget/history. Le endpoint ingeyeqembu elithi “Iwijethi yengxoxo” le-API ye-Zentor App. Idinga i-widget embed token evumelekile. Ukubiza kuyi-idempotent: ukubiza kaningi ngemininingwane efanayo kubuyisa umphumela ofanayo. Amapharamitha ayimpoqo: widget_code (query), session_id (query), visitor_id (query). Izimo zamaphutha ezibhaliwe: 400 PARAMS_REQUIRED. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubunikazi nokuvikeleka
I-widget embed token (i-header X-Widget-Token) + uhlu lwama-origin avunyelwe
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 yesivakashi edalwa yewijethi futhi igcinwe ebhrawuzeniIsibonelo se-response
{"ok":true,"data":{"messages":[{"role":"user","text":"Sawubona...","created_at":"..."},{"role":"assistant","text":"...","created_at":"..."}]}}Amakhodi amaphutha
400 PARAMS_REQUIRED — `session_id` noma `visitor_id` ayikho.Ukuziphatha okuhlolwe
Iseshini ekhona inikeza 200 nomlando wemiyalezo; 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 (igama lokubonisa, umbhalo wokubingelela, idizayini, ulimi, umsebenzi wezwi) wokuqaliswa kwebhrawuza.POST /api/public/widget/messageIthumela umlayezo wesivakashi ku-chatbot futhi inikeze impendulo yayo – isiphetho esimaphakathi sewijethi yengxoxo.POST /api/public/widget/pollIlanda imiyalezo eyamukelwe ngemva kwesikhathi esithile – isibonelo impendulo yesisebenzi esithatha ingxoxo.POST /api/public/widget/ratingIgcina ukulinganiswa kwesivakashi mayelana nengxoxo (kusiza noma akusizi).POST /api/public/widget/trackIrekhoda isenzakalo esingaziwa sokusetshenziswa kwewijethi (isib. „iwijethi ivuliwe“) sokuhlaziywa kwedashboard.POST /api/public/widget/voice-transcribeIguqula ukuqoshwa kwezwi kwesivakashi kube umbhalo (ukufakwa kwezwi), uma umsebenzi wezwi wewijethi uvuliwe.POST /api/public/widget/voice-speakIguqula umbhalo kube ulimi olukhulunywayo (ukukhiphwa kwezwi ewijethini), uma umsebenzi wezwi uvuliwe.