POST/api/public/widget/message

Schéckt eng Chat-Noriicht vum Visiteur un de Chatbot a gëtt seng Äntwert den zentrale Endpunkt vum Chat-Widget.

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)— Client-Säit generéiert persistent Visiteur ID
session_id(body, string)— null beim éischte Rappel vun enger neier Konversatioun

Beispiel-Request

{"widget_code":"...","message":"Hallo, wat kann Zentor App?","visitor_id":"<UUID oder Client-generéiert 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 ass net do.
401 WIDGET_TOKEN_INVALID — Token net valid oder Origin net an der Widget-Lëscht.
400 VISITOR_ID_REQUIRED — Visitor_id ass net do.

Live-Test-Nachweis

Erfolleg (200, real generéiert Chatbot Äntwert) a verschidde negativ Fäll (mangel/ongëlteg Token, fehlend visitor_id) live verifizéiert.

← Chat Widget