GET/api/global-chatbot/demo/history

加载演示对话之前的消息历史,以便在重新打开演示时予以保留。

将 `session_id` 和 `visitor_id` 作为查询参数传递;两者必须来自同一个演示对话。响应在 `data` 对象中包含 `messages` 列表,其中包括 `id`、`role`、`text` 和 `created_at`。此调用为只读且幂等。 若缺少任一参数,服务器以 400 `PARAMS_REQUIRED` 响应。若会话已不再可识别,请开始新的演示对话。

概览

调用:GET /api/global-chatbot/demo/history。该端点属于 Zentor App API 的“演示聊天机器人与 SSO”分组。 该端点可公开访问,无需身份验证。 该调用是幂等的:使用相同输入重复调用将返回相同结果。 必填参数:session_id (查询), visitor_id (查询)。 已记录的错误情况:400 PARAMS_REQUIRED。 下方的示例响应展示了 JSON 格式的成功响应结构。

身份验证与安全

无需身份验证

幂等: 是

参数

session_id(query, string,必填)— 演示对话的会话 ID
visitor_id(query, string,必填)— 由演示页面生成的访客 ID(UUID)

响应示例

{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"你好,Zentor 多少钱?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"我可以为您展示在您的使用场景中会是什么样子——没有任何义务。","created_at":"2026-07-20T17:07:02.329Z"}]}}

错误代码

400 PARAMS_REQUIRED — `session_id` 或 `visitor_id` 缺失。

已验证的行为

现有演示会话返回 200 并附带历史记录;缺失参数返回 400 `PARAMS_REQUIRED`。

演示聊天机器人与 SSO

POST /api/global-chatbot/demo向 zentor-app.de/demo 上的公开演示聊天机器人发送消息并返回其回复。演示可在浏览器中无需注册即可体验。POST /api/global-chatbot/demo/poll获取演示对话的新消息,例如当 Zentor 团队成员接管了对话时。演示页面会定期调用该端点。POST /api/global-chatbot/demo/rating保存演示对话的评价(有帮助或没有帮助),可带可选评论。POST /api/global-chatbot/demo/track为 Zentor 的访客统计记录演示页面上的匿名使用事件。POST /api/global-chatbot/demo/voice-transcribe若演示的语音功能已启用,将演示页面上的语音录音转换为文本(语音输入)。POST /api/global-chatbot/demo/voice-speak若演示的语音功能已启用,将文本转换为语音(演示页面上的语音输出)。GET /api/sso/:tenantSlug/status检查某个账户是否已配置单一登录(SAML 或 OIDC)。登录页面会使用该结果来提供 SSO 登录选项。GET /api/sso/:tenantSlug/oidc/start启动通过 OpenID Connect 的登录,并将浏览器重定向到已配置的身份提供商。GET /api/sso/:tenantSlug/oidc/callback接收 OIDC 登录后身份提供商的重定向,并将浏览器重定向回 Zentor App。GET /api/sso/:tenantSlug/saml/start启动通过 SAML 的登录,并将浏览器重定向到已配置的身份提供商。POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service(ACS):通过表单 POST 接收身份提供商已签名的 SAML 响应。GET /api/sso/:tenantSlug/saml/metadata返回用于导入您身份提供商的 Zentor App SAML 元数据(XML)。

相关文章

← 演示聊天机器人与 SSO