POST/api/global-chatbot/demo/poll

Dotazuje se na nové, asynchronně doručené zprávy demo chatové relace (např. když lidský agent převzal v master adminu) — je periodicky voláno widgetem.

`POST /api/global-chatbot/demo/poll` se dotazuje na nové zprávy nebo změny stavu pro existující demo relaci. Tělo obsahuje `session_id` a `visitor_id`. Obě hodnoty musí pocházet ze stejné veřejné demo konverzace. Pokud některý z parametrů chybí, server odpoví `400 PARAMS_REQUIRED`. Tato trasa nevyžaduje přihlášení uživatele a čte aktuální stav demo relace. Používá se, když odpověď nepřijde okamžitě s předchozím požadavkem, nebo když má rozhraní zobrazit zprávy, které dorazily později. Polling není náhradou za odeslání zprávy; sám nevytváří nový požadavek návštěvníka. Klient musí mezi voláními dodržovat přiměřenou pauzu. Těsná nekonečná smyčka zvyšuje zátěž a může spustit rate-limity, aniž by rychleji vytvořila odpověď. Pokud je relace ukončena, neplatná nebo již nenalezitelná, má se polling zastavit a rozhraní nabídnout nový start. Zrušené stránky nebo skryté karty nesmí zanechávat trvale běžící požadavky na pozadí. `session_id` a `visitor_id` nejsou obecné přístupové údaje pro jiné konverzace. Nesmí být sdíleny mezi návštěvníky ani odesílány společně se zprávami do veřejných analytických nástrojů. Demo zůstává oddělené od konverzací tenantů a produkčních dat inboxu. Správný test spustí demo relaci, odešle zprávu a poté zavolá Poll se stejnými identifikátory. Dodatečně je zkontrolován požadavek bez `visitor_id`. Dokumentovaný negativní test je důkazem chyby, nikoli dokladem toho, že úplná produktivní konverzace byla úspěšně dokonč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_REQUIREDsession_id a/nebo visitor_id chybí.

Live-Test-Nachweis

Úspěch (200, prázdný seznam, protože od demo.chat nejsou žádné nové asynchronní zprávy) a negativní případ (400) ověřen naživo.

Demo chatbot a SSO