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_REQUIRED — session_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.