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,必填)— 示範對話嘅工作階段 IDvisitor_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":"Ich kann dir zeigen, wie das für deinen Anwendungsfall aussehen würde — ohne Verpflichtung.","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)。