POST/api/global-chatbot/demo/poll

Lấy các tin nhắn mới đến không đồng bộ của phiên chat Demo (ví dụ: khi một nhân viên đã tiếp quản trong Master-Admin) — widget gọi định kỳ.

`POST /api/global-chatbot/demo/poll` lấy thông tin tin nhắn mới hoặc thay đổi trạng thái cho một phiên demo hiện có. Phần thân chứa `session_id` và `visitor_id`. Cả hai giá trị đều phải đến từ cùng một cuộc hội thoại demo công khai. Nếu thiếu một trong các tham số, máy chủ sẽ trả về `400 PARAMS_REQUIRED`. Tuyến này không yêu cầu đăng nhập người dùng và đọc trạng thái hiện tại của phiên demo. Nó được sử dụng khi phản hồi không trở về ngay lập tức sau yêu cầu trước đó hoặc khi giao diện cần hiển thị các tin nhắn đến muộn hơn. Việc kiểm tra định kỳ không thay thế cho việc gửi tin nhắn; nó không tự tạo ra yêu cầu mới từ khách truy cập. Client phải tuân thủ khoảng thời gian nghỉ hợp lý giữa các lần gọi. Vòng lặp vô tận với tần suất cao sẽ làm tăng tải và có thể kích hoạt giới hạn tốc độ, mà không giúp nhận được phản hồi nhanh hơn. Nếu phiên kết thúc, bị vô hiệu hóa hoặc không thể tìm thấy, hãy dừng việc kiểm tra định kỳ và cung cấp cho giao diện tùy chọn khởi động lại. Các trang bị hủy hoặc tab ẩn không được để lại các yêu cầu nền chạy liên tục. `session_id` và `visitor_id` không phải là thông tin đăng nhập chung cho các cuộc trò chuyện khác. Chúng không được chia sẻ giữa các khách truy cập hoặc gửi kèm theo tin nhắn đến các công cụ phân tích công khai. Phiên bản thử nghiệm được tách biệt khỏi các cuộc trò chuyện của Tenant và dữ liệu hộp thư đến sản xuất. Một bài kiểm tra chính xác sẽ khởi tạo phiên thử nghiệm, gửi tin nhắn và sau đó gọi Poll với cùng các định danh. Ngoài ra, một yêu cầu không có `visitor_id` được kiểm tra. Bài kiểm tra tiêu cực được tài liệu hóa nhằm xác minh lỗi, không phải là bằng chứng cho thấy một cuộc hội thoại sản xuất hoàn chỉnh đã thành công.

Xác thực & bảo mật

Không cần xác thực

Lũy đẳng (idempotent): Có

Tham số

session_id(body, string, bắt buộc)
visitor_id(body, string, bắt buộc)

Request mẫu

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

Response mẫu

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

Mã lỗi

400 PARAMS_REQUIRED — session_id và/hoặc visitor_id bị thiếu.

Bằng chứng kiểm thử trực tiếp

Thành công (200, danh sách rỗng vì không có tin nhắn không đồng bộ mới kể từ demo.chat) và trường hợp tiêu cực (400) đã được xác minh trực tiếp.

← Chatbot mẫu và SSO