POST`/api/public/widget/message`

وزیٹر کا چیٹ پیغام چیٹ بوٹ کو بھیجتا ہے اور اس کا جواب واپس دیتا ہے — چیٹ ویجیٹ کا مرکزی اینڈ پوائنٹ۔

تصدیقِ شناخت اور تحفظ

ویجیٹ ایمبیڈ ٹوکن (ہیڈر 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-Header کی کمی ہے۔

401 WIDGET_TOKEN_INVALID — ٹوکن غیر معتبر ہے یا Origin ویجیٹ کی اجازت نامہ فہرست میں شامل نہیں۔

400 VISITOR_ID_REQUIRED — visitor_id گم ہے۔

کامیابی (200، حقیقی طور پر تیار کردہ چیٹ بوٹ جواب) اور متعدد منفی صورتیں (ٹوکن غائب/غلط، visitor_id غائب) لائیو تصدیق شدہ۔