POST/api/global-chatbot/demo/voice-speak

若演示的语音功能已启用,将文本转换为语音(演示页面上的语音输出)。

发送 `visitor_id`(UUID)以及要朗读的文本 `text`。响应包含用于播放的音频数据;对于 `<audio>` 元素,同一路径也可通过 GET 使用。此端点对应 `POST /api/public/widget/voice-speak`,但仅限用于 zentor-app.de 的演示,并非旨在作为通用的文本转语音接口。 错误情况:400 `INVALID_VISITOR_ID`(UUID 缺失或无效)、403 `ORIGIN_DENIED`(调用不是来自 zentor-app.de)以及 503 `VOICE_UNAVAILABLE`(语音功能当前不可用)。

概览

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

身份验证与安全

无需身份验证

仅接受来自 https://zentor-app.de 和 https://www.zentor-app.de 的调用;演示不需要嵌入令牌。

幂等: 是

参数

visitor_id(body, string,必填)— 访客 ID,必须是有效的 UUID
text(body, string,必填)— 要朗读的文本

响应示例

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

错误代码

400 INVALID_VISITOR_ID — `visitor_id` 缺失或不是有效的 UUID。
403 ORIGIN_DENIED — 该调用不是来自 zentor-app.de。
503 VOICE_UNAVAILABLE — 语音功能目前不可用。

已验证的行为

无效的 `visitor_id` 返回 400 `INVALID_VISITOR_ID`,语音功能不可用返回 503 `VOICE_UNAVAILABLE`。成功情况只能从 zentor-app.de 发起。

演示聊天机器人与 SSO

POST /api/global-chatbot/demo向 zentor-app.de/demo 上的公开演示聊天机器人发送消息并返回其回复。演示可在浏览器中无需注册即可体验。GET /api/global-chatbot/demo/history加载演示对话之前的消息历史,以便在重新打开演示时予以保留。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若演示的语音功能已启用,将演示页面上的语音录音转换为文本(语音输入)。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