POST/api/public/widget/message

Skickar ett chattmeddelande från besökaren till chattboten och returnerar dess svar — den centrala slutpunkten för chatt-widgeten.

Autentisering & säkerhet

Widget-embed-token (header X-Widget-Token) + lista över godkända origins

Idempotent: Nej

Parametrar

widget_code(body, string, obligatorisk)
message(body, string, obligatorisk)
visitor_id(body, string, obligatorisk)— Klientgenererat, beständigt besökar-ID
session_id(body, string)— null vid första anropet av en ny konversation

Exempel på request

{"widget_code":"...","message":"Hej, vad kan Zentor App göra?","visitor_id":"<UUID eller klientgenererat ID>"}

Exempel på response

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

Felkoder

401 WIDGET_TOKEN_MISSING — X-Widget-Token-header saknas.
401 WIDGET_TOKEN_INVALID — Token är ogiltigt eller origin finns inte i widgetens frisläppta lista.
400 VISITOR_ID_REQUIRED — visitor_id saknas.

Bevis från livetest

Framgång (200, verkligt genererat chattbotsvar) och flera negativa fall (saknad/ogiltig token, saknat visitor_id) verifierade live.

← Chat-widget