POST/api/global-chatbot/demo/poll

Haeu demo-chatin uusimmat, asynkronisesti saapuvat viestit (esimerkiksi silloin, kun ihmisagentti on ottanut ohjat master-admin-tilissä) – widget kutsuu tätä toimintoa säännöllisesti.

`POST /api/global-chatbot/demo/poll` kysyy uusia viestejä tai tilanmuutoksia olemassa olevalle demo-istunnolle. Runko sisältää `session_id` ja `visitor_id`. Molempien arvojen on oltava samasta julkisesta demo-keskustelusta. Jos jokin parametri puuttuu, palvelin vastaa `400 PARAMS_REQUIRED`-virheellä. Reitti ei vaadi käyttäjätunnistautumista, ja se lukee demo-istunnon nykyisen tilan. Sitä käytetään, kun vastausta ei saada välittömästi edellisen pyynnön yhteydessä tai kun käyttöliittymä haluaa näyttää myöhemmin saapuneita viestejä. Pollaus ei korvaa viestin lähettämistä; se ei myöskään luo uutta vieraskyselyä. Asiakkaan on pidettävä kohtuullinen tauko kutsujen välillä. Tiukka, jatkuva silmukka lisää kuormitusta ja voi aiheuttaa nopeusrajoituksia ilman, että se tuottaa nopeampaa vastausta. Jos istunto päättyy, on virheellinen tai sitä ei enää löydetä, pollaus on lopetettava, ja käyttöliittymän on tarjottava uusi aloitus. Suljetut sivut tai piilotetut välilehdet eivät saa jättää jälkeensä jatkuvasti käynnissä olevia taustakyselyitä. `session_id` ja `visitor_id` eivät ole yleisiä tunnistetietoja muihin keskusteluihin. Niitä ei saa jakaa käyttäjien välillä tai lähettää julkisille analysointityökaluille viestien mukana. Demo on erillään vuokralaisen keskusteluista ja tuotannon sähköpostitiedoista. Oikea testaus käynnistää demo-istunnon, lähettää viestin ja kutsuu sitten pollaus samaan tunnisteeseen. Lisäksi tarkistetaan pyyntö ilman `visitor_id`. Dokumentoitu negatiivinen testi on todiste virheestä, ei todiste siitä, että täydellinen, tuotannollinen keskustelu on onnistunut.

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

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