POST/api/global-chatbot/demo/poll
Ibuza imilayezo emisha efike ngokungavumelanisiwe yeseshini yengxoxo ye-demo (isib. uma i-ejenti engumuntu ithathe ku-Master-Admin) — ibizwa njalo yi-widget.
`POST /api/global-chatbot/demo/poll` ibuza imilayezo emisha noma izinguquko zesimo zeseshini ye-demo ekhona. I-body iqukethe `session_id` ne-`visitor_id`. Womabili la manani kufanele avele engxoxweni efanayo ye-demo yomphakathi. Uma enye yamapharamitha ingekho, iseva iphendula ngo-`400 PARAMS_REQUIRED`. Lo mzila awudingi ukungena komsebenzisi futhi ufunda isimo samanje seseshini ye-demo. Usetshenziswa uma impendulo ingabuyi ngokushesha ne-request edlule noma uma isixhumi esibonakalayo kufanele sibonise imilayezo efike kamuva. I-polling ayithathi indawo yokuthumela umlayezo; ayidali isicelo esisha sesivakashi. I-client kufanele igcine ikhefu elifanele phakathi kwezingcingo. I-loop engapheli eqinile ikhulisa umthwalo futhi ingaqalisa ama-rate limit, ngaphandle kokukhiqiza impendulo ngokushesha. Uma iseshini iphela, ingasebenzi noma ingasatholakali, i-polling kufanele iyeke futhi isixhumi esibonakalayo sinikeze ukuqala kabusha. Amakhasi ayekiwe noma amathebhu afihliwe akufanele ashiye izicelo zangemuva ezisebenza njalo. `session_id` ne-`visitor_id` akuyona imininingwane yokungena ejwayelekile yezinye izingxoxo. Akufanele kwabelwane ngakho phakathi kwezivakashi noma kuthunyelwe kanye nemilayezo kumathuluzi okuhlaziya omphakathi. I-demo ihlala ihlukile ezingxoxweni ze-tenant nakudatha ye-inbox yokukhiqiza. Ukuhlola okulungile kuqala iseshini ye-demo, kuthumele umlayezo bese kubiza i-poll ngezihlonzi ezifanayo. Ngaphezu kwalokho, kuhlolwa i-request engenayo i-`visitor_id`. Ukuhlola okungalungile okubhaliwe kungubufakazi bephutha, hhayi ubufakazi bokuthi ingxoxo ephelele yokukhiqiza iqedwe ngempumelelo.
Ukuqinisekisa ubunikazi nokuvikeleka
Akudingeki ukuqinisekisa ubunikazi
I-idempotent: Yebo
Amapharamitha
session_id(body, string, kuyadingeka)visitor_id(body, string, kuyadingeka)Isibonelo se-request
{"session_id":"<UUID>","visitor_id":"<UUID>"}Isibonelo se-response
{"ok":true,"data":{"messages":[]}}Amakhodi amaphutha
400 PARAMS_REQUIRED — session_id kanye/noma visitor_id azikho.Ubufakazi bokuhlolwa bukhoma
Impumelelo (200, uhlu olungenalutho ngoba ayikho imilayezo emisha engavumelanisiwe kusukela ku-demo.chat) nesimo esibi (400) kuqinisekiswe bukhoma.