POST/api/global-chatbot/demo/poll

Consulta novas mensagens que chegaram de forma assíncrona numa Demo Chat Session (por ex., quando um agente humano assumiu no Master Admin) — é chamado periodicamente pelo widget.

`POST /api/global-chatbot/demo/poll` consulta novas mensagens ou alterações de estado para uma Demo Session existente. O body contém `session_id` e `visitor_id`. Ambos têm de vir da mesma conversa Demo pública. Se faltar um parâmetro, o servidor responde com `400 PARAMS_REQUIRED`. A rota não exige login de utilizador e lê o estado atual da Demo Session. É utilizada quando uma resposta não chega imediatamente com o pedido anterior ou quando a interface precisa mostrar mensagens que chegaram mais tarde. Polling não substitui o envio de mensagem; por si só não cria um novo pedido do visitante. O cliente deve manter uma pausa adequada entre chamadas. Uma loop infinita apertada aumenta a carga e pode acionar Rate Limits sem produzir resposta mais rapidamente. Se a Session terminar, ficar inválida ou deixar de ser encontrada, o polling deve parar e a interface deve oferecer um novo início. Páginas abandonadas ou tabs ocultos não devem manter pedidos em background indefinidamente. `session_id` e `visitor_id` não são credenciais gerais para outras conversas. Não devem ser partilhados entre visitantes nem enviados juntamente com mensagens para ferramentas públicas de analytics. A Demo permanece separada de conversas de tenant e dados produtivos da Inbox. Um teste correto inicia uma Demo Session, envia uma mensagem e chama depois Poll com os mesmos identificadores. Adicionalmente é testado um pedido sem `visitor_id`. O teste negativo documentado prova o erro, não que uma conversa produtiva completa tenha sido concluída com sucesso.

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

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