POST`/api/public/widget/message`

يرسل رسالة دردشة من الزائر إلى روبوت الدردشة ويُرجع رده — نقطة النهاية المركزية لـ Widget الدردشة.

المصادقة والأمان

رمز تضمين الودجت (ترويسة X-Widget-Token) + قائمة النطاقات المسموح بها

متطابق القوة: لا

widget_code(body, string، إلزامي)

message(body, string، إلزامي)

visitor_id(body, string، إلزامي)— معرّف زائر دائم يُنشأ من جهة العميل

session_id(body, string)— null عند أول استدعاء لمحادثة جديدة

{"widget_code":"...","message":"مرحبا، ما الذي يمكن أن يقدمه Zentor App؟","visitor_id":"<UUID أو معرّف يُنشأ من جهة العميل>"}

{"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 — Token غير صالح أو المصدر (origin) غير موجود في قائمة السماح الخاصة بـ Widget.

400 VISITOR_ID_REQUIRED — visitor_id مفقود.

تم التحقق مباشرة من النجاح (200، رد فعلي تم توليده من روبوت الدردشة) ومن عدة حالات سلبية (token مفقود/غير صالح، visitor_id مفقود).