POST/api/public/widget/message

Stuur 'n besoekerboodskap na die Chatbot en gee sy antwoord terug — sentrale endpoint van die Chat Widget.

Verifikasie en sekuriteit

Widget-inbedtoken (X-Widget-Token-header) + lys van toegelate origins

Idempotent: Nee

Parameters

widget_code(body, string, vereis)
message(body, string, vereis)
visitor_id(body, string, vereis)— Persistente visitor-ID wat client-side gegenereer word
session_id(body, string)— null by die eerste request van 'n nuwe gesprek

Voorbeeldversoek

{"widget_code":"...","message":"Hallo, wat kan Zentor App doen?","visitor_id":"<UUID of kliëntgegenereerde ID>"}

Voorbeeldrespons

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

Foutkodes

401 WIDGET_TOKEN_MISSING — Header X-Widget-Token ontbreek.
401 WIDGET_TOKEN_INVALID — Token ongeldig of Origin nie in die Widget se Allowlist nie.
400 VISITOR_ID_REQUIRED — visitor_id ontbreek.

Bewys van live-toets

Sukses (200, werklike Chatbot-respons) en meerdere negatiewe gevalle met ontbrekende/ongeldige Token of visitor_id live geverifieer.

← Chat Widget