POST/api/global-chatbot/demo/poll
Ibuza imilayezo emitsha efike ngokungahambelani lesikhathi yeseshini ye-chat yedemo (isib. nxa i-ejenti engumuntu ithathe ingxoxo ku-Master-Admin) — ibizwa yi-widget ngezikhathi ezithile.
I-`POST /api/global-chatbot/demo/poll` ibuza imilayezo emitsha kumbe ukuntshintsha kwesimo kweseshini yedemo ekhona. I-body iqukethe `session_id` le-`visitor_id`. Womabili amanani kumele avele engxoxweni yedemo yomphakathi efanayo. Nxa elinye lama-parameter lingekho, iseva iphendula nge-`400 PARAMS_REQUIRED`. Umzila kawudingi ukungena komsebenzisi njalo ufunda isimo samanje seseshini yedemo. Usetshenziswa nxa impendulo ingabuyi masinyane lesicelo sangaphambili kumbe nxa isikhangiso sifuna ukutshengisa imilayezo efike ngemva. I-polling kayithathi indawo yokuthumela umlayezo; kayenzi isicelo esitsha somvakatshi. I-client kumele igcine ikhefu elifaneleyo phakathi kokubiza. Iluphu engapheliyo esondeleneyo yengeza umthwalo njalo ingabangela imikhawulo ye-rate, ngaphandle kokwenza impendulo ngokuphangisa. Nxa iseshini iphelile, ingasasebenzi kumbe ingasatholakali, i-polling kumele ime njalo isikhangiso sinikeze ukuqala kutsha. Amakhasi avaliweyo kumbe amathebhu afihliweyo akumelanga atshiye izicelo zangemuva eziqhubeka zingapheli. I-`session_id` le-`visitor_id` kayisiyo imininingwane yokungena ejwayelekileyo yezinye izingxoxo. Akumelanga yabelwane phakathi kwabavakatshi kumbe ithunyelwe ndawonye lemilayezo kumathuluzi okuhlaziya omphakathi. Idemo ihlala yehlukene lezingxoxo zabaqashi ledatha ye-Inbox yokusebenza. Ukuhlola okuqondileyo kuqala iseshini yedemo, kuthumele umlayezo, bese kubiza i-Poll ngezihlonzi ezifanayo. Ngaphezu kwalokho kuhlolwa isicelo esingelayo i-`visitor_id`. Ukuhlola okubi okubhaliweyo kuyibufakazi bephutha, hatshi ubufakazi bokuthi ingxoxo yokusebenza epheleleyo iphethwe ngempumelelo.
Ukuqinisekisa ubuwena lokuvikeleka
Kakudingeki ukuqinisekisa ubuwena
I-idempotent: Yebo
Amapharamitha
session_id(body, string, kuyadingeka)visitor_id(body, string, kuyadingeka)Isibonelo sesicelo (request)
{"session_id":"<UUID>","visitor_id":"<UUID>"}Isibonelo sempendulo (response)
{"ok":true,"data":{"messages":[]}}Amakhodi amaphutha
400 PARAMS_REQUIRED — session_id le/kumbe visitor_id akukho.Ubufakazi bokuhlola okuphilayo
Impumelelo (200, uhlu olungelalutho ngoba kakulamilayezo emitsha engahambelani lesikhathi selokhu kwaba le-demo.chat) lesimo esibi (400) kuhlolwe bukhoma.