GET/api/global-chatbot/demo/history

โหลดประวัติข้อความก่อนหน้าของการสนทนาสาธิต เพื่อให้คงอยู่เมื่อเปิดการสาธิตใหม่

ส่ง `session_id` และ `visitor_id` เป็นพารามิเตอร์คำค้นหา ทั้งสองต้องมาจากการสนทนาสาธิตเดียวกัน การตอบกลับจะมีรายการ `messages` ในออบเจ็กต์ `data` ซึ่งรวมถึง `id`, `role`, `text`, และ `created_at` การเรียกนี้เป็นแบบอ่านอย่างเดียวและเป็น idempotent หากพารามิเตอร์ตัวใดตัวหนึ่งหายไป เซิร์ฟเวอร์จะตอบกลับด้วย 400 `PARAMS_REQUIRED` หากไม่รู้จักเซสชันนั้นแล้ว ให้เริ่มการสนทนาสาธิตใหม่

ภาพรวม

การเรียกใช้: GET /api/global-chatbot/demo/history เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทบอทสาธิตและ SSO” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้เป็นแบบ idempotent: การเรียกซ้ำด้วยข้อมูลเดิมจะได้ผลลัพธ์เดิม พารามิเตอร์ที่จำเป็น: session_id (query), visitor_id (query) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 PARAMS_REQUIRED ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON

การยืนยันตัวตนและความปลอดภัย

ไม่ต้องยืนยันตัวตน

Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ใช่

พารามิเตอร์

session_id(query, string, จำเป็น)— Session ID ของการสนทนาสาธิต
visitor_id(query, string, จำเป็น)— Visitor 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บันทึกเหตุการณ์การใช้งานแบบไม่ระบุตัวตนของหน้าสาธิตสำหรับสถิติผู้เยี่ยมชมของ ZentorPOST /api/global-chatbot/demo/voice-transcribeแปลงการบันทึกเสียงบนหน้าสาธิตเป็นข้อความ (การรับข้อมูลเสียง) หากเปิดใช้งานฟังก์ชันเสียงของการสาธิตPOST /api/global-chatbot/demo/voice-speakแปลงข้อความเป็นเสียงพูด (การส่งออกข้อมูลเสียงบนหน้าสาธิต) หากเปิดใช้งานฟังก์ชันเสียงของการสาธิตGET /api/sso/:tenantSlug/statusตรวจสอบว่ามีการตั้งค่า Single Sign-On (SAML หรือ OIDC) สำหรับบัญชีหรือไม่ หน้าเข้าสู่ระบบจะใช้ผลลัพธ์นี้เพื่อเสนอการเข้าสู่ระบบด้วย SSOGET /api/sso/:tenantSlug/oidc/startเริ่มการเข้าสู่ระบบผ่าน OpenID Connect และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้GET /api/sso/:tenantSlug/oidc/callbackรับการเปลี่ยนเส้นทางของ Identity Provider หลังจากเข้าสู่ระบบด้วย OIDC และเปลี่ยนเส้นทางเบราว์เซอร์กลับไปยัง Zentor AppGET /api/sso/:tenantSlug/saml/startเริ่มการเข้าสู่ระบบผ่าน SAML และเปลี่ยนเส้นทางเบราว์เซอร์ไปยัง Identity Provider ที่ตั้งค่าไว้POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): รับการตอบกลับ SAML ที่ลงนามโดย Identity Provider ผ่านฟอร์ม POSTGET /api/sso/:tenantSlug/saml/metadataส่งคืนข้อมูลเมตา SAML ของ Zentor App (XML) สำหรับนำเข้าสู่ Identity Provider ของคุณ

บทความที่เกี่ยวข้อง

← แชทบอทสาธิตและ SSO