POST/api/public/widget/message
پیام چت بازدیدکننده را به چتبات میفرستد و پاسخ آن را برمیگرداند — نقطه پایانی مرکزی ویجت چت.
Auth & Absicherung
Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste
Idempotent: Nein
Parameter
widget_code(body, string, erforderlich)message(body, string, erforderlich)visitor_id(body, string, erforderlich)— شناسه بازدیدکننده پایدار تولیدشده در سمت کلاینتsession_id(body, string)— null در اولین فراخوانی یک مکالمه جدیدBeispiel-Request
{"widget_code":"...","message":"سلام، Zentor App چه کاری میتواند انجام دهد؟","visitor_id":"<UUID oder client-generierte ID>"}Beispiel-Response
{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}Fehlercodes
401 WIDGET_TOKEN_MISSING — X-Widget-Token-Header وجود ندارد.401 WIDGET_TOKEN_INVALID — توکن نامعتبر است یا مبدأ در فهرست مجاز ویجت قرار ندارد.400 VISITOR_ID_REQUIRED — visitor_id وجود ندارد.Live-Test-Nachweis
موفقیت (200، پاسخ واقعی تولیدشده چتبات) و چندین مورد منفی (توکن مفقود/نامعتبر، visitor_id مفقود) بهصورت زنده تأیید شد.