POST/api/global-chatbot/demo/poll

데모 채팅 세션에서 비동기적으로 도착한 새 메시지를 조회합니다(예: 인간 에이전트가 마스터 관리자로 전환된 경우) — 위젯에서 주기적으로 호출됩니다.

`POST /api/global-chatbot/demo/poll`은 기존 데모 세션에 대한 새 메시지 또는 상태 변경 사항을 폴링합니다. 본문에는 `session_id`와 `visitor_id`가 포함됩니다. 두 값 모두 동일한 공개 데모 대화에서 가져온 것이어야 합니다. 매개변수 중 하나가 누락된 경우 서버는 `400 PARAMS_REQUIRED`로 응답합니다. 이 라우트는 사용자 로그인이 필요하지 않으며 데모 세션의 현재 상태를 읽습니다. 이전 요청에 대한 응답이 즉시 반환되지 않거나, 나중에 도착한 메시지를 인터페이스에서 표시해야 할 때 사용됩니다. 폴링은 메시지 전송을 대체할 수 없으며, 자체적으로 새로운 방문자 요청을 생성하지 않습니다. 클라이언트는 호출 간에 적절한 대기 시간을 유지해야 합니다. 빈번한 무한 루프는 부하를 증가시키고 응답 속도를 높이지 못한 채로 속도 제한을 유발할 수 있습니다. 세션이 종료되거나 무효화되거나 더 이상 찾을 수 없는 경우 폴링을 중지하고 인터페이스에서 새 시작을 제공해야 합니다. 닫힌 페이지나 숨겨진 탭은 영구적인 백그라운드 요청을 남기지 않아야 합니다. `session_id`와 `visitor_id`는 다른 대화에 대한 일반적인 자격 증명이 아닙니다. 방문자 간에 공유되어서는 안 되며, 메시지를 공개 분석 도구와 함께 전송해서는 안 됩니다. 데모는 테넌트 대화 및 프로덕션 인박스 데이터와 분리되어 유지됩니다. 올바른 테스트는 데모 세션을 시작하고, 메시지를 전송한 후, 동일한 식별자를 사용하여 폴링을 호출합니다. 추가로 `visitor_id` 없이 요청을 보내는 테스트도 수행합니다. 문서화된 음수 테스트는 오류를 입증하는 것이지, 완전한 프로덕션 대화가 성공적으로 완료되었음을 증명하는 것이 아닙니다.

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

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