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ásakorBeispiel-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_MISSING — Hiányzik az X-Widget-Token-Header.401 WIDGET_TOKEN_INVALID — A token érvénytelen, vagy az Origin nincs a widget engedélyezési listáján.400 VISITOR_ID_REQUIRED — visitor_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.