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)已實時驗證。

← 示範聊天機器人同 SSO