POST/api/public/widget/poll

查询自上次获取以来的新消息——例如当员工通过人工交接接管对话、客户需要在小部件中看到回复时会用到。

身份验证与安全

组件嵌入令牌(请求头 X-Widget-Token)+ 来源(Origin)许可列表

幂等: 是

参数

widget_code(body, string,必填)
session_id(body, string,必填)
visitor_id(body, string,必填)

请求示例

{"widget_code":"...","session_id":"...","visitor_id":"..."}

响应示例

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

错误代码

400 PARAMS_REQUIRED — visitor_id 和/或 session_id 缺失。

实时测试证明

成功(200)和失败场景(400)已实时验证。

← 聊天小部件