POST/api/global-chatbot/demo/voice-transcribe
แปลงการบันทึกเสียงบนหน้าสาธิตเป็นข้อความ (การรับข้อมูลเสียง) หากเปิดใช้งานฟังก์ชันเสียงของการสาธิต
ส่ง `visitor_id` (UUID) และข้อมูลเสียงในช่อง `audio` เป็น `multipart/form-data` การตอบกลับจะมีข้อความที่รู้จำได้ เอนด์พอยต์นี้สอดคล้องกับ `POST /api/public/widget/voice-transcribe` แต่ผูกกับการสาธิตบน zentor-app.de เท่านั้น กรณีข้อผิดพลาด: 400 `INVALID_VISITOR_ID` (UUID หายไปหรือไม่ถูกต้อง), 403 `ORIGIN_DENIED` (คำขอไม่ได้มาจาก zentor-app.de), 413 `AUDIO_TOO_LARGE` (ไฟล์ใหญ่เกินไป) และ 415 `AUDIO_TYPE_UNSUPPORTED` (ไม่สนับสนุนรูปแบบไฟล์)
ภาพรวม
การเรียกใช้: POST /api/global-chatbot/demo/voice-transcribe เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทบอทสาธิตและ SSO” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: visitor_id (body), audio (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 413 AUDIO_TOO_LARGE, 415 AUDIO_TYPE_UNSUPPORTED ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
รับเฉพาะคำขอจาก https://zentor-app.de และ https://www.zentor-app.de เท่านั้น การสาธิตไม่จำเป็นต้องใช้ Embed Token
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
visitor_id(body, string, จำเป็น)— Visitor ID ต้องเป็น UUID ที่ถูกต้องaudio(body, file, จำเป็น)— ไฟล์เสียง (`multipart/form-data`)ตัวอย่างการตอบกลับ
{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id ต้องเป็น UUID ที่ถูกต้อง"}}รหัสข้อผิดพลาด
400 INVALID_VISITOR_ID — `visitor_id` หายไปหรือไม่ใช่ UUID ที่ถูกต้อง403 ORIGIN_DENIED — คำขอไม่ได้มาจาก zentor-app.de413 AUDIO_TOO_LARGE — ไฟล์เสียงมีขนาดเกินกว่าที่อนุญาต415 AUDIO_TYPE_UNSUPPORTED — ไม่สนับสนุนรูปแบบไฟล์เสียงนี้พฤติกรรมที่ตรวจสอบแล้ว
`visitor_id` ที่ไม่ถูกต้องจะได้รับ 400 `INVALID_VISITOR_ID` คำขอจากโดเมนอื่นจะได้รับ 403 `ORIGIN_DENIED` กรณีสำเร็จเป็นไปได้เฉพาะจาก 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บันทึกเหตุการณ์การใช้งานแบบไม่ระบุตัวตนของหน้าสาธิตสำหรับสถิติผู้เยี่ยมชมของ ZentorPOST /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 ของคุณ