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 เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทบอทสาธิตและ SSO” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้เป็นแบบ idempotent: การเรียกซ้ำด้วยข้อมูลเดิมจะได้ผลลัพธ์เดิม พารามิเตอร์ที่จำเป็น: visitor_id (body), text (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON

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

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

รับเฉพาะคำขอจาก https://zentor-app.de และ https://www.zentor-app.de เท่านั้น การสาธิตไม่จำเป็นต้องใช้ Embed Token

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

พารามิเตอร์

visitor_id(body, string, จำเป็น)— Visitor ID ต้องเป็น UUID ที่ถูกต้อง
text(body, string, จำเป็น)— ข้อความที่ต้องการอ่านออกเสียง

ตัวอย่างการตอบกลับ

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"ฟังก์ชันเสียงพูดไม่พร้อมใช้งานในขณะนี้"}}

รหัสข้อผิดพลาด

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บันทึกเหตุการณ์การใช้งานแบบไม่ระบุตัวตนของหน้าสาธิตสำหรับสถิติผู้เยี่ยมชมของ ZentorPOST /api/global-chatbot/demo/voice-transcribeแปลงการบันทึกเสียงบนหน้าสาธิตเป็นข้อความ (การรับข้อมูลเสียง) หากเปิดใช้งานฟังก์ชันเสียงของการสาธิต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