POST/api/public/widget/message

Sender en chatbesked fra den besøgende til chatboten og leverer dens svar — det centrale endepunkt for chat-widgetten.

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)— Klient-side genereret, vedvarende besøgs-ID
session_id(body, string)— null ved første kald af en ny samtale

Beispiel-Request

{"widget_code":"...","message":"Hej, hvad kan Zentor App?","visitor_id":"<UUID eller klientgenereret 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 mangler.
401 WIDGET_TOKEN_INVALID — Token ugyldig eller Origin ikke på widget'ens tilladelsesliste.
400 VISITOR_ID_REQUIRED — visitor_id mangler.

Live-Test-Nachweis

Succes (200, ægte genereret chatbot-svar) og flere negative tilfælde (manglende/ugyldig token, manglende visitor_id) live verificeret.

← Chat-widget