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(body, string,必填)visitor_id(body, string,必填)請求範例
{"session_id":"<UUID>","visitor_id":"<UUID>"}回應範例
{"ok":true,"data":{"messages":[]}}錯誤代碼
400 PARAMS_REQUIRED — session_id 同 visitor_id 少咗。即時測試證明
成功(200,因自 demo.chat 以來無新異步訊息故為空列表)及負例(400)已實時驗證。