POST`/api/public/widget/message`

שולח הודעת צ'אט מהמבקר לבוט הצ'אט ומחזיר את התשובה שלו — נקודת הקצה המרכזית של וידג'ט הצ'אט.

Auth & Absicherung

Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste

Idempotent: Nein

widget_code(body, string, erforderlich)

message(body, string, erforderlich)

visitor_id(body, string, erforderlich)— מזהה מבקר קבוע שנוצר בצד הלקוח

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 חסר) אומתו בשידור חי.