POST/api/global-chatbot/demo/poll
Interroga nuovi messaggi arrivati in modo asincrono in una Session Demo Chat (ad es. se un agente umano ha preso in carico dal Master Admin) — viene chiamato periodicamente dal widget.
`POST /api/global-chatbot/demo/poll` interroga nuovi messaggi o cambi di stato per una Session Demo esistente. Il body contiene `session_id` e `visitor_id`. Entrambi i valori devono provenire dalla stessa conversazione Demo pubblica. Se manca uno dei parametri, il server risponde con `400 PARAMS_REQUIRED`. La route non richiede login utente e legge lo stato attuale della Session Demo. Viene usata quando una risposta non torna direttamente con il request precedente oppure quando l'interfaccia deve mostrare messaggi arrivati successivamente. Il polling non sostituisce l'invio di un messaggio e non crea da solo una nuova richiesta visitatore. Il client deve rispettare una pausa adeguata tra le chiamate. Un loop stretto infinito aumenta il carico e può attivare Rate Limit senza produrre più rapidamente una risposta. Se la Session è terminata, non valida o non più trovabile, il polling deve fermarsi e l'interfaccia offrire un nuovo avvio. Pagine abbandonate o tab nascosti non devono lasciare richieste background permanenti. `session_id` e `visitor_id` non sono credenziali generali per altre conversazioni. Non devono essere condivisi tra visitatori né inviati insieme ai messaggi a strumenti pubblici di analisi. La Demo resta separata dalle conversazioni Tenant e dai dati produttivi dell'Inbox. Un test corretto avvia una Session Demo, invia un messaggio e poi chiama Poll con gli stessi identificatori. Inoltre viene testato un request senza `visitor_id`. Il test negativo documentato dimostra un errore, non che una conversazione produttiva completa si sia conclusa con successo.
Autenticazione e sicurezza
Nessuna autenticazione richiesta
Idempotente: Sì
Parametri
session_id(body, string, obbligatorio)visitor_id(body, string, obbligatorio)Richiesta di esempio
{"session_id":"<UUID>","visitor_id":"<UUID>"}Risposta di esempio
{"ok":true,"data":{"messages":[]}}Codici di errore
400 PARAMS_REQUIRED — session_id e/o visitor_id mancanti.Prova del test live
Successo (200, lista vuota perché nessun nuovo messaggio asincrono da demo.chat) e caso negativo (400) verificati live.