POST/api/public/widget/voice-speak

แปลงข้อความเป็นเสียงพูด (การส่งออกด้วยเสียงในวิดเจ็ต) หากเปิดใช้งานฟังก์ชันเสียงแล้ว

ส่ง `widget_code` และข้อความที่ต้องการอ่านออกเสียงใน `text` การตอบกลับจะมีข้อมูลเสียงสำหรับเล่นในเบราว์เซอร์ สำหรับการเล่นโดยตรงผ่านอิลิเมนต์ `<audio>` พาธเดียวกันนี้ยังใช้งานได้ผ่าน GET อีกด้วย หาก `widget_code` หายไป เซิร์ฟเวอร์จะตอบกลับด้วย 400 `WIDGET_CODE_REQUIRED` หากฟังก์ชันเสียงไม่ได้เปิดใช้งานหรือไม่พร้อมใช้งานในขณะนี้ จะได้รับ 503 `VOICE_UNAVAILABLE` เริ่มการเล่นใหม่เมื่อการเล่นครั้งก่อนเสร็จสิ้นแล้วเท่านั้น

ภาพรวม

การเรียกใช้: POST /api/public/widget/voice-speak เอนด์พอยต์นี้อยู่ในกลุ่ม “แชทวิดเจ็ต” ของ API ของ Zentor App เอนด์พอยต์นี้ต้องใช้โทเค็นฝังวิดเจ็ต (widget embed token) ที่ถูกต้อง การเรียกใช้นี้เป็นแบบ idempotent: การเรียกซ้ำด้วยข้อมูลเดิมจะได้ผลลัพธ์เดิม พารามิเตอร์ที่จำเป็น: widget_code (body), text (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON

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

Widget-Embed-Token (Header X-Widget-Token) + รายการ Origin ที่อนุญาต

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

พารามิเตอร์

widget_code(body, string, จำเป็น)— โค้ดวิดเจ็ตจากโค้ดฝังของคุณ
text(body, string, จำเป็น)— ข้อความที่ต้องการอ่านออกเสียง

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

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

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

400 WIDGET_CODE_REQUIRED — ช่อง `widget_code` หายไป
503 VOICE_UNAVAILABLE — ฟังก์ชันเสียงไม่ได้เปิดใช้งานสำหรับวิดเจ็ตนี้ หรือไม่พร้อมใช้งานในขณะนี้

พฤติกรรมที่ตรวจสอบแล้ว

`widget_code` ที่หายไปจะได้รับ 400 `WIDGET_CODE_REQUIRED` วิดเจ็ตที่ไม่มีฟังก์ชันเสียงจะได้รับ 503 `VOICE_UNAVAILABLE` กรณีสำเร็จต้องมีวิดเจ็ตที่เปิดใช้งานฟังก์ชันเสียงแล้ว

แชทวิดเจ็ต

GET /api/public/widget/healthตรวจสอบความพร้อมใช้งานของบริการวิดเจ็ตแบบง่าย ๆGET /api/public/widget/config/:widget_codeส่งคืนการตั้งค่าสาธารณะของวิดเจ็ต (ชื่อที่แสดง ข้อความต้อนรับ ดีไซน์ ภาษา ฟังก์ชันเสียง) สำหรับการเริ่มต้นในเบราว์เซอร์POST /api/public/widget/messageส่งข้อความของผู้เยี่ยมชมไปยังแชทบอทและส่งคำตอบกลับมา – เอนด์พอยต์หลักของแชทวิดเจ็ตGET /api/public/widget/historyโหลดประวัติข้อความก่อนหน้าของการสนทนาในวิดเจ็ต เช่น หลังจากโหลดหน้าใหม่POST /api/public/widget/pollดึงข้อความที่มาถึงหลังจากเวลาที่ระบุ – เช่น คำตอบของพนักงานที่รับช่วงการสนทนาPOST /api/public/widget/ratingจัดเก็บคะแนนของผู้เยี่ยมชมสำหรับบทสนทนา (มีประโยชน์หรือไม่มีประโยชน์)POST /api/public/widget/trackบันทึกเหตุการณ์การใช้งานแบบไม่ระบุตัวตนของวิดเจ็ต (เช่น “วิดเจ็ตถูกเปิด”) สำหรับการวิเคราะห์ในแดชบอร์ดPOST /api/public/widget/voice-transcribeแปลงการบันทึกเสียงของผู้เยี่ยมชมเป็นข้อความ (การป้อนด้วยเสียง) หากเปิดใช้งานฟังก์ชันเสียงสำหรับวิดเจ็ต

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

← แชทวิดเจ็ต