POST/api/public/widget/message

將訪客嘅聊天訊息傳送畀聊天機器人並返回其回覆——係聊天小工具嘅核心端點。

身份驗證同安全保障

Widget 嵌入權杖（Header X-Widget-Token）+ 來源（Origin）允許清單

冪等: 唔係

參數

widget_code(body, string，必填)
message(body, string，必填)
visitor_id(body, string，必填)— 喺用戶端生成、持久保存嘅訪客 ID
session_id(body, string)— 新對話首次呼叫時為 null

請求範例

{"widget_code":"...","message":"你好，Zentor App 可以做啲咩？","visitor_id":"<UUID 或者客戶端產生嘅 ID>"}

回應範例

{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}

錯誤代碼

401 WIDGET_TOKEN_MISSING — 缺少 X-Widget-Token-Header。
401 WIDGET_TOKEN_INVALID — Token 無效，或 Origin 唔喺小工具嘅允許清單內。
400 VISITOR_ID_REQUIRED — 缺少 visitor_id。

即時測試證明

成功（200，真實生成嘅聊天機器人回覆）及多個負例（缺少／無效 Token、缺少 visitor_id）已實時驗證。

← 聊天小工具