POST`/api/public/widget/message`

Verstuurt een chatbericht van de bezoeker naar de chatbot en levert het antwoord — het centrale eindpunt van het chat-widget.

Auth & beveiliging

Widget-embed-token (header X-Widget-Token) + origin-toestemmingslijst

Idempotent: Nee

widget_code(body, string, vereist)

message(body, string, vereist)

visitor_id(body, string, vereist)— Aan clientzijde gegenereerde, persistente bezoeker-ID

session_id(body, string)— null bij de eerste aanroep van een nieuwe conversatie

{"widget_code":"...","message":"Hoi, wat kan Zentor App?","visitor_id":"<UUID of door de client gegenereerde ID>"}

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

401 WIDGET_TOKEN_MISSING — X-Widget-Token-header ontbreekt.

401 WIDGET_TOKEN_INVALID — Token ongeldig of Origin niet op de vrijgavelijst van de widget.

400 VISITOR_ID_REQUIRED — visitor_id ontbreekt.

Succes (200, echt gegenereerd chatbotantwoord) en meerdere negatieve gevallen (ontbrekend/ongeldig token, ontbrekende visitor_id) live geverifieerd.