POST/api/public/widget/message
Lähettää käyttäjän chat-viestin chatbotille ja toimittaa tämän vastauksen – chat-widgetin keskeinen päätepiste.
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)— Asiakkaan puolella luotu, pysyvä vierailijatunnus.session_id(body, string)— Null kun uusi keskustelu avataan ensimmäisen kerran.Beispiel-Request
{"widget_code":"...","message":"Hei, mitä voit tehdä Zentor App?","visitor_id":"<UUID tai asiakkaan luoma 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-otsake puuttuu.401 WIDGET_TOKEN_INVALID — Token on virheellinen tai alkuperä ei ole widgetin käyttöoikeusluettelossa.400 VISITOR_ID_REQUIRED — visitor_id-tunnus puuttuu.Live-Test-Nachweis
Menestys (200, todellisia, generoituja chatbot-vastauksia) ja useita negatiivisia tapauksia (puuttuva/virheellinen token, puuttuva visitor_id) on todettu toimivassa järjestelmässä.