POST/api/global-chatbot/demo/poll
Henter nye, asynkront mottatte meldinger i en demo-chat-sesjon (f.eks. når en menneskelig agent har tatt over i Master-admin) – kalles periodisk av widgetet.
`POST /api/global-chatbot/demo/poll` henter nye meldinger eller statusendringer for en eksisterende demosessjon. Bodyen inneholder `session_id` og `visitor_id`. Begge verdier må stamme fra samme offentlige demosamtale. Mangler en av parametrene, svarer serveren med `400 PARAMS_REQUIRED`. Ruten krever ikke brukerauthentisering og leser den nåværende tilstanden for demosessjonen. Den brukes når et svar ikke kommer tilbake umiddelbart etter den forrige forespørselen, eller når grensesnittet skal vise meldinger som har kommet senere. Polling er ikke en erstatning for å sende en melding; den skaper selv ingen ny besøkerforespørsel. Klienten må holde en passende pause mellom oppringningene. En tett uendelig løkke øker belastningen og kan utløse ratebegrensninger uten å generere et svar raskere. Hvis sessjonen avsluttes, ugyldiggjøres eller ikke lenger finnes, skal polling stoppes og grensesnittet tilby en ny start. Avbrutte sider eller skjulte faner må ikke etterlate seg varig aktive bakgrunnsforespørsler. `session_id` og `visitor_id` er ikke generelle tilgangsdata for andre samtaler. De må ikke deles mellom besøkende eller sendes sammen med meldinger til offentlige analyseredskaper. Demoen forblir skilt fra tenant-samtaler og produktive innboksdata. Et korrekt testscenario starter en demosessjon, sender en melding og kaller deretter på Poll med de samme identifikatorne. I tillegg testes en forespørsel uten `visitor_id`. Den dokumenterte negative testen er en feilbevis, ikke et bevis på at en fullstendig produktiv samtale har blitt avsluttet vellykket.
Autentisering og sikring
Ingen autentisering påkrevd
Idempotent: Ja
Parametere
session_id(body, string, påkrevd)visitor_id(body, string, påkrevd)Eksempel på forespørsel
{"session_id":"<UUID>","visitor_id":"<UUID>"}Eksempel på svar
{"ok":true,"data":{"messages":[]}}Feilkoder
400 PARAMS_REQUIRED — session_id og/eller visitor_id mangler.Live-testbevis
Suksess (200, tom liste fordi det ikke har kommet nye asynkrone meldinger siden demo.chat) og negativtilfelle (400) verifisert live.