POST/api/global-chatbot/demo/voice-speak
แปลงข้อความเป็นเสียงพูด (Text-to-Speech) สำหรับการออกเสียงบนหน้าเว็บสาธิต หากเปิดใช้งาน
`POST /api/global-chatbot/demo/voice-speak` แปลงข้อความให้เป็นเสียงพูด หากเปิดใช้งานฟังก์ชันเสียงสำหรับสาธิต จุดปลายทางนี้ถูกใช้โดยหน้าสาธิตสาธารณะและไม่ได้มีไว้เป็น API แปลงข้อความเป็นเสียงทั่วไปที่ใช้งานได้อย่างอิสระ ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์แบบแดชบอร์ด แต่จะใช้การตรวจสอบ Origin แบบคงที่สำหรับ `https://zentor-app.de` และ `https://www.zentor-app.de` คำขอประกอบด้วยข้อความที่ต้องการแสดงออกและตัวเลือกภาษาตามที่ระบุในเอกสารโครงสร้างข้อมูล ผู้ใช้ควรส่งเฉพาะข้อความที่จะพูดจริงในบทสนทนาสาธิตเท่านั้น การป้อนค่าว่าง รูปแบบไม่ถูกต้อง หรือฟังก์ชันเสียงที่ไม่ได้เปิดใช้งาน ต้องจัดการเป็นข้อผิดพลาด การเปลี่ยนแปลง Origin แบบท้องถิ่นหรือการเรียกจากโดเมนอื่นไม่สามารถหลีกเลี่ยงการตรวจสอบฝั่งเซิร์ฟเวอร์ได้ การดำเนินการนี้สร้างไฟล์เสียง จึงไม่นับเป็นการดำเนินการอ่านแบบ idempotent การส่งข้อความเดียวกันซ้ำๆ อาจกระตุ้นกระบวนการประมวลผลหลายครั้ง หน้าเว็บสาธิตควรปิดปุ่มส่งออกขณะกำลังประมวลผล และหยุดการเล่นเสียงที่กำลังทำงานอยู่อย่างถูกต้องก่อนเริ่มใหม่ ลำดับเหตุการณ์ที่สมจริงเริ่มต้นด้วยคำตอบจากบอทในสาธิต ผู้ใช้เปิดใช้งานเสียงพูด หน้าเว็บส่งข้อความคำตอบไปยัง `voice-speak` รับข้อมูลเสียงหรือคำตอบเสียงตามที่ระบุในเอกสาร แล้วเล่นเสียงในเบราว์เซอร์ หากคำขอล้มเหลวเนื่องจาก Origin ที่ไม่ได้รับอนุญาต หน้าเว็บไม่ควรเรียกบริการทดแทนใดๆ แต่ควรแสดงว่าฟังก์ชันเสียงไม่สามารถใช้งานได้ รหัสผ่าน โทเค็น หรือข้อมูลลับ ไม่ควรอยู่ในคำขอ ช่องทางสาธิตเป็นสาธารณะและไม่ได้ใช้สำหรับข้อมูลลับขององค์กร แม้คำตอบเสียงก็ไม่ควรบันทึกถาวรในบันทึกสาธารณะ จุดปลายทางนี้แยกออกจาก Voicebot SIP ทางเทคนิค การโทรศัพท์ทำงานในอินสแตนซ์ SIP ที่แยกกันตามลูกค้า และเปิดใช้งานเฉพาะโดย Master Admin เท่านั้น `voice-speak` ไม่ควบคุมหมายเลขโทรศัพท์และไม่เริ่มการโทร เพื่อความสะดวกในการเข้าถึง ผู้ใช้ควรแสดงข้อความเต็มควบคู่กับเสียงพูดเสมอในสาธิต เสียงพูดไม่ควรประกอบด้วยข้อมูลที่ขาดหายไปทางสายตา เบราว์เซอร์อาจบล็อกการเล่นเสียงจนกว่าจะมีปฏิสัมพันธ์จากผู้ใช้ ดังนั้นการเริ่มต้นควรกระตุ้นโดยคลิก การยกเลิกและการเล่นซ้ำต้องสามารถควบคุมได้
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
การตรวจสอบ Origin ถูกกำหนดตายตัวที่ https://zentor-app.de / https://www.zentor-app.de (กำหนดค่าไม่ได้ ใช้แทน Widget-Token บนเส้นทางเดโม)
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ใช่
พารามิเตอร์
visitor_id(body, string, จำเป็น)— ต้องเป็น UUID ที่ถูกต้องtext(body, string, จำเป็น)— ข้อความที่จะแปลงเป็นเสียงพูดตัวอย่างการตอบกลับ
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"ฟังก์ชันเสียงพูดไม่พร้อมใช้งานในขณะนี้"}}รหัสข้อผิดพลาด
400 INVALID_VISITOR_ID — visitor_id หายไปหรือไม่ใช่ UUID ที่ถูกต้อง403 ORIGIN_DENIED — แหล่งที่มาของคำขอไม่ใช่ zentor-app.de503 VOICE_UNAVAILABLE — ฟังก์ชันเสียงพูดไม่พร้อมใช้งานในขณะนี้หลักฐานการทดสอบแบบสด
ตรวจสอบสดแล้วกรณีล้มเหลว (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, แต่ละกรณีมี Origin-Header ที่ถูกต้อง) มีรูปแบบ GET ของเส้นทางเดียวกันนี้เช่นกัน (การสตรีม <audio src> ในตัว พฤติกรรมเหมือนกัน) เป็นคู่เดโมของ widget.voice_speak