POST/api/global-chatbot/demo/poll

Získava nové asynchrónne doručené správy demo chatovej relácie (napr. keď prevzal ľudský agent v Master-Admini) — widget túto operáciu volá periodicky.

`POST /api/global-chatbot/demo/poll` vyžiada nové správy alebo zmeny stavu pre existujúcu demo reláciu. Telo požiadavky obsahuje `session_id` a `visitor_id`. Obe hodnoty musia pochádzať z tej istej verejnej demo konverzácie. Ak jeden z parametrov chýba, server odpovie `400 PARAMS_REQUIRED`. Trasa nevyžaduje prihlásenie používateľa a číta aktuálny stav demo relácie. Používa sa, keď odpoveď nepríde okamžite s predchádzajúcou požiadavkou alebo keď má rozhranie zobraziť neskôr doručené správy. Polling nenahrádza odoslanie správy; sám nevytvára nový dopyt návštevníka. Klient musí medzi volaniami dodržiavať primeranú pauzu. Tesná nekonečná slučka zvyšuje záťaž a môže spustiť rate limity, bez toho, aby sa odpoveď vytvorila rýchlejšie. Ak sa relácia ukončí, stane sa neplatnou alebo sa už nedá nájsť, polling sa má zastaviť a rozhranie má ponúknuť nový štart. Zatvorené stránky alebo skryté karty nesmú zanechať trvalo bežiace požiadavky na pozadí. `session_id` a `visitor_id` nie sú všeobecné prístupové údaje k iným konverzáciám. Nesmú sa zdieľať medzi návštevníkmi ani posielať spolu so správami do verejných analytických nástrojov. Demo zostáva oddelené od konverzácií tenantov a produkčných údajov schránky. Správny test spustí demo reláciu, odošle správu a následne zavolá poll s rovnakými identifikátormi. Dodatočne sa overí požiadavka bez `visitor_id`. Zdokumentovaný negatívny test je dôkaz chyby, nie dôkaz toho, že sa úspešne skončila kompletná produkčná konverzácia.

Autentifikácia a zabezpečenie

Nevyžaduje sa žiadna autentifikácia

Idempotentné: Áno

Parametre

session_id(body, string, povinné)
visitor_id(body, string, povinné)

Príklad požiadavky

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

Príklad odpovede

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

Chybové kódy

400 PARAMS_REQUIRED — Chýbajú session_id a/alebo visitor_id.

Dôkaz živého testu

Úspech (200, prázdny zoznam, keďže od demo.chat neboli žiadne nové asynchrónne správy) a negatívny prípad (400) overené v živom režime.

← Demo chatbot a SSO