POST/api/public/widget/voice-transcribe

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

ส่ง `widget_code` และข้อมูลเสียงในช่อง `audio` แบบ `multipart/form-data` การตอบกลับจะมีข้อความที่รู้จำได้ ซึ่งคุณจะส่งต่อไปผ่าน `POST /api/public/widget/message` ว่าฟังก์ชันเสียงทำงานอยู่หรือไม่แสดงด้วย `voice_enabled` ในการตั้งค่าวิดเจ็ต หาก `widget_code` หายไป เซิร์ฟเวอร์จะตอบกลับด้วย 400 `WIDGET_CODE_REQUIRED` หากฟังก์ชันเสียงไม่ได้เปิดใช้งานหรือไม่พร้อมใช้งานในขณะนี้ จะได้รับ 503 `VOICE_UNAVAILABLE` Zentor เป็นผู้ตั้งค่าฟังก์ชันเสียงให้กับวิดเจ็ตของคุณ

ภาพรวม

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

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

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

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

พารามิเตอร์

widget_code(body, string, จำเป็น)— โค้ดวิดเจ็ตจากโค้ดฝังของคุณ
audio(body, binary, จำเป็น)— ไฟล์เสียงที่บันทึก (`multipart/form-data`)

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

{"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-speakแปลงข้อความเป็นเสียงพูด (การส่งออกด้วยเสียงในวิดเจ็ต) หากเปิดใช้งานฟังก์ชันเสียงแล้ว

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

← แชทวิดเจ็ต