POST/api/global-chatbot/demo/poll

Merr mesazhet e reja, të arritura asinkronisht, të një sesioni chat demo (p.sh., kur një agjent njerëzor ka marrë kontrollin në Master Admin) — funksioni thirret periodikisht nga widget-i.

`POST /api/global-chatbot/demo/poll` kërkon mesazhe të reja ose ndryshime statusi për një sesion demo të ekzistues. Trupi përmban `session_id` dhe `visitor_id`. Të dy vlerat duhet të vijnë nga e njëjta bisedë demo publike. Nëse mungon njëri nga parametrat, serveri përgjigjet me `400 PARAMS_REQUIRED`. Ruta nuk kërkon autentifikim përdoruesi dhe lexon gjendjen aktuale të sesionit demo. Ajo përdoret kur një përgjigje nuk kthehet menjëherë me kërkesën e mëparshme ose kur interfejsi duhet të shfaqë mesazhe që kanë mbërritur më vonë. Polling-ja nuk është zëvendësues për dërgimin e një mesazhi; ajo nuk krijon vetë një kërkesë të re vizituesi. Klienti duhet të respektojë një pushim të arsyeshëm midis thirrjeve. Një cikël i mbyllur i ngushtë rrit ngarkesën dhe mund të shkaktojë kufizime të shpejtësisë (rate-limits), pa krijuar më shpejt një përgjigje. Nëse sesioni përfundon, bëhet i pavlefshëm ose nuk gjetet, polling-ja duhet të ndalet dhe interfejsi duhet të ofrojë një fillim të ri. Faqet e ndërprera ose tabat e fshehura nuk duhet të lënë pas kërkesa të pasakta në sfond. `session_id` dhe `visitor_id` nuk janë kredenciale përgjithëse për biseda të tjera. Ato nuk duhet të ndahen midis vizituesve ose të dërgohen bashkë me mesazhe në mjetet publike të analizës. Demoja mbetet e ndarë nga bisedat e Tenant-it dhe të dhënat e Inbox-it produktive. Një test i saktë fillon një sesion demo, dërgon një mesazh dhe më pas therr Poll me të njëjtat identifikues. Përveç kësaj, kontrollohet një kërkesë pa `visitor_id`. Testi negativ i dokumentuar është një provë gabimi, jo një dëshmi se një bisedë produktive e plotë është përfunduar me sukses.

{"session_id":"<UUID>","visitor_id":"<UUID>"}

{"ok":true,"data":{"messages":[]}}