POST/api/public/widget/message

Sender en chatmelding fra besøkeren til chatboten og returnerer botens svar — det sentrale endepunktet for chat-widgetet.

Autentisering og sikring

Widget-embed-token (header X-Widget-Token) + godkjenningsliste for origins

Idempotent: Nei

Parametere

widget_code(body, string, påkrevd)
message(body, string, påkrevd)
visitor_id(body, string, påkrevd)— Klientgenerert, vedvarende besøks-ID
session_id(body, string)— null ved første kall i en ny samtale

Eksempel på forespørsel

{"widget_code":"...","message":"Hei, hva kan Zentor App?","visitor_id":"<UUID eller klientgenerert ID>"}

Eksempel på svar

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

Feilkoder

401 WIDGET_TOKEN_MISSING — X-Widget-Token-header mangler.
401 WIDGET_TOKEN_INVALID — Token er ugyldig eller opprinnelsen er ikke på widgetens godkjenningsliste.
400 VISITOR_ID_REQUIRED — visitor_id mangler.

Live-testbevis

Suksess (200, ekte generert chatbot-svar) og flere negativtilfeller (manglende/ugyldig token, manglende visitor_id) verifisert live.

← Chat-widget