POST/api/global-chatbot/demo/voice-transcribe
แปลงบันทึกเสียงพูดจากหน้าเดโมเป็นข้อความ (Speech-to-Text) หากเปิดใช้งานเสียงพูดแล้ว เป็นคู่เดโมของ widget.voice_transcribe โดยผูกกับหน้าการตลาดของ Zentor แทนที่จะผูกกับวิดเจ็ตของผู้เช่า
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
การตรวจสอบ Origin ถูกกำหนดตายตัวที่ https://zentor-app.de / https://www.zentor-app.de (กำหนดค่าไม่ได้ ใช้แทน Widget-Token บนเส้นทางเดโม)
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
visitor_id(body, string, จำเป็น)— ต้องเป็น 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 — รูปแบบไฟล์เสียงไม่รองรับหลักฐานการทดสอบแบบสด
ตรวจสอบสดแล้วกรณีล้มเหลว (400 INVALID_VISITOR_ID พร้อม Origin-Header ที่ถูกต้อง, 403 ORIGIN_DENIED) กรณีสำเร็จ (การถอดเสียงจริง) ไม่สามารถทริกเกอร์ได้นอกโดเมน Production เนื่องจากการตรวจสอบ Origin ถูกเขียนตายตัวไว้ที่ zentor-app.de — บันทึกไว้ในลักษณะเดียวกับ widget.voice_transcribe