POST/api/public/widget/message
ส่งข้อความแชทของผู้เยี่ยมชมไปยังแชทบอท และส่งคำตอบกลับ — เป็นจุดปลายทางหลักของ Widget แชท
การยืนยันตัวตนและความปลอดภัย
Widget-Embed-Token (Header X-Widget-Token) + รายการ Origin ที่อนุญาต
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
widget_code(body, string, จำเป็น)message(body, string, จำเป็น)visitor_id(body, string, จำเป็น)— ID ผู้เยี่ยมชมแบบถาวรที่สร้างฝั่งไคลเอนต์session_id(body, string)— ค่า null ในครั้งแรกของการเรียกใช้บทสนทนาใหม่ตัวอย่างคำขอ
{"widget_code":"...","message":"สวัสดี Zentor App ทำอะไรได้บ้าง?","visitor_id":"<UUID หรือ ID ที่สร้างโดยไคลเอนต์>"}ตัวอย่างการตอบกลับ
{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}รหัสข้อผิดพลาด
401 WIDGET_TOKEN_MISSING — ขาดส่วนหัวของโทเค็น X-Widget-Token401 WIDGET_TOKEN_INVALID — โทเค็นไม่ถูกต้อง หรือ Origin ไม่อยู่ในรายการที่อนุญาตของ Widget400 VISITOR_ID_REQUIRED — visitor_id หายไปหลักฐานการทดสอบแบบสด
ตรวจสอบสดแล้ว: กรณีสำเร็จ (200, คำตอบแชทบอทที่สร้างขึ้นจริง) และกรณีล้มเหลวหลายกรณี (โทเค็นขาด/ไม่ถูกต้อง, ไม่มี visitor_id)