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-Token
401 WIDGET_TOKEN_INVALID — โทเค็นไม่ถูกต้อง หรือ Origin ไม่อยู่ในรายการที่อนุญาตของ Widget
400 VISITOR_ID_REQUIRED — visitor_id หายไป

หลักฐานการทดสอบแบบสด

ตรวจสอบสดแล้ว: กรณีสำเร็จ (200, คำตอบแชทบอทที่สร้างขึ้นจริง) และกรณีล้มเหลวหลายกรณี (โทเค็นขาด/ไม่ถูกต้อง, ไม่มี visitor_id)

← วิดเจ็ตแชท