POST/api/global-chatbot/demo/poll

Hämtar nya, asynkront inkomna meddelanden för en demo-chatt-session (t.ex. om en mänsklig agent har övertagit i Master-Admin) — anropas periodiskt av widgetet.

`POST /api/global-chatbot/demo/poll` hämtar nya meddelanden eller statusändringar för en befintlig demosession. Bodyn innehåller `session_id` och `visitor_id`. Båda värdena måste komma från samma offentliga demokonversation. Om någon av parametrarna saknas svarar servern med `400 PARAMS_REQUIRED`. Routen kräver ingen användarinloggning och läser demosessionens aktuella tillstånd. Den används när ett svar inte kommer tillbaka direkt med den föregående begäran eller när gränssnittet ska visa meddelanden som kommit in senare. Polling ersätter inte att skicka ett meddelande; den skapar i sig ingen ny besökarförfrågan. Klienten måste hålla en lämplig paus mellan anropen. En tät oändlig loop ökar belastningen och kan utlösa rate limits utan att ge ett snabbare svar. Om sessionen avslutas, blir ogiltig eller inte längre går att hitta ska pollingen stoppas och gränssnittet erbjuda en ny start. Avbrutna sidor eller dolda flikar får inte lämna kvar bakgrundsförfrågningar som körs permanent. `session_id` och `visitor_id` är inga allmänna åtkomstuppgifter för andra samtal. De får inte delas mellan besökare eller skickas tillsammans med meddelanden till offentliga analysverktyg. Demon hålls åtskild från tenantkonversationer och produktiva inbox-data. Ett korrekt test startar en demosession, skickar ett meddelande och anropar därefter poll med samma identifierare. Dessutom kontrolleras en begäran utan `visitor_id`. Det dokumenterade negativa testet är ett felbevis, inte ett belägg för att en fullständig produktiv konversation har slutförts framgångsrikt.

Autentisering & säkerhet

Ingen autentisering krävs

Idempotent: Ja

Parametrar

session_id(body, string, obligatorisk)
visitor_id(body, string, obligatorisk)

Exempel på request

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

Exempel på response

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

Felkoder

400 PARAMS_REQUIRED — session_id och/eller visitor_id saknas.

Bevis från livetest

Framgång (200, tom lista eftersom det inte finns några nya asynkrona meddelanden sedan demo.chat) och negativt fall (400) verifierade live.

← Demo-chattbot och SSO