POST/api/global-chatbot/demo/poll

Upit za nove, asinkrono pristigle poruke demo chat sesije (npr. kada je ljudski agent preuzeo kontrolu u Master Adminu) — widget povremeno poziva ovu funkciju.

`POST /api/global-chatbot/demo/poll` upituje nove poruke ili promjene statusa za postojeću demo sesiju. Tijelo sadrži `session_id` i `visitor_id`. Obje vrijednosti moraju potjecati iz iste javne demo konverzacije. Ako nedostaje jedan od parametara, poslužitelj odgovara s `400 PARAMS_REQUIRED`. Ova ruta ne zahtijeva prijavu korisnika i čita trenutno stanje demo sesije. Koristi se kada odgovor ne stigne odmah kao odgovor na prethodni zahtjev ili kada sučelje treba prikazati poruke koje su stigle kasnije. Polling nije zamjena za slanje poruke; sam po sebi ne stvara novi zahtjev posjetitelja. Klijent mora održavati odgovarajuću pauzu između poziva. Uska beskonačna petlja povećava opterećenje i može aktivirati ograničenja brzine (rate limits), a da pritom ne rezultira bržim dobivanjem odgovora. Kada se sesija završi, postane nevažećom ili više nije pronađiva, polling treba prestati, a sučelje treba ponuditi novi početak. Prekinute stranice ili skrivene kartice ne smiju ostaviti trajne zahtjeve u pozadini. `session_id` i `visitor_id` nisu opći pristupni podaci za druge razgovore. Ne smiju se dijeliti između posjetitelja niti slati zajedno s porukama javnim alatima za analitiku. Demo je odvojen od konverzacija klijenata (tenant) i produkcijskih podataka pošte. Ispravan test pokreće demo sesiju, šalje poruku, a zatim poziva polling s istim identifikatorima. Dodatno se provjerava zahtjev bez `visitor_id`. Dokumentirani negativni test je dokaz greške, a ne dokaz da je potpuna produkcijska konverzacija uspješno završena.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Ja

Parameter

session_id(body, string, erforderlich)
visitor_id(body, string, erforderlich)

Beispiel-Request

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

Beispiel-Response

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

Fehlercodes

400 PARAMS_REQUIREDNedostaje ID sesije i/ili ID posjetitelja.

Live-Test-Nachweis

Uspjeh (200, prazna lista jer nema novih asinkronih poruka od demo.chat) i negativni slučaj (400) potvrđeni u stvarnom vremenu.

Demo-chatbot i SSO