POST/api/global-chatbot/demo/poll

Poizveduje o novih, asinhrono prispelih sporočilih seje predstavitvenega klepeta (npr. če je pogovor prevzel človeški agent v Master Admin) — gradnik ga periodično kliče.

`POST /api/global-chatbot/demo/poll` poizveduje o novih sporočilih ali spremembah stanja za obstoječo predstavitveno sejo. Telo vsebuje `session_id` in `visitor_id`. Obe vrednosti morata izhajati iz istega javnega predstavitvenega pogovora. Če manjka eden od parametrov, strežnik odgovori s `400 PARAMS_REQUIRED`. Pot ne zahteva prijave uporabnika in bere trenutno stanje predstavitvene seje. Uporablja se, kadar odgovor ne prispe neposredno ob prejšnji zahtevi ali kadar naj vmesnik prikaže kasneje prispela sporočila. Polling ni nadomestilo za pošiljanje sporočila; sam ne ustvari novega povpraševanja obiskovalca. Odjemalec mora med klici upoštevati primeren premor. Ozka neskončna zanka poveča obremenitev in lahko sproži omejitve hitrosti (Rate-Limits), ne da bi hitreje prišel odgovor. Če se seja konča, postane neveljavna ali je ni več mogoče najti, naj se polling ustavi, vmesnik pa naj ponudi nov začetek. Opuščene strani ali skriti zavihki ne smejo za seboj pustiti trajno delujočih zahtev v ozadju. `session_id` in `visitor_id` nista splošna dostopna podatka za druge pogovore. Ne smeta se deliti med obiskovalci niti pošiljati skupaj s sporočili v javna orodja za analitiko. Predstavitev ostaja ločena od pogovorov najemnikov in produktivnih podatkov nabiralnika. Pravilen test zažene predstavitveno sejo, pošlje sporočilo in nato pokliče poll z istimi identifikatorji. Dodatno se preveri zahteva brez `visitor_id`. Dokumentirani negativni test je dokaz napake, ne dokaz, da je bil popoln produktivni pogovor uspešno zaključen.

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

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