POST/api/public/widget/message

Küldi a látogató csevegésüzenetét a chatbotnak, és visszaadja annak válaszát – a chat widget központi végpontja.

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)Kliensoldali generált, állandó látogatói azonosító
session_id(body, string)null az első új beszélgetés hívásakor

Beispiel-Request

{"widget_code":"...","message":"Hello, what can Zentor App?","visitor_id":"<UUID or client-generated ID>"}

Beispiel-Response

{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}

Fehlercodes

401 WIDGET_TOKEN_MISSINGHiányzik az X-Widget-Token-Header.
401 WIDGET_TOKEN_INVALIDA token érvénytelen, vagy az Origin nincs a widget engedélyezési listáján.
400 VISITOR_ID_REQUIREDvisitor_id hiányzik.

Live-Test-Nachweis

Sikeres (200, valós generált chatbot-válasz) és több negatív eset (hiányzó/érvénytelen token, hiányzó visitor_id) élő ellenőrzése.

Chat-modul