POST/api/public/widget/message

Odešle chatovou zprávu návštěvníka chatbotu a vrátí jeho odpověď — centrální koncový bod chatového widgetu.

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)— Perzistentní ID návštěvníka generované na straně klienta
session_id(body, string)— null při prvním volání nové konverzace

Beispiel-Request

{"widget_code":"...","message":"Hello, what can Zentor App?","visitor_id":"<UUID or client-generated ID>"}

Beispiel-Response

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

Fehlercodes

401 WIDGET_TOKEN_MISSING — X-Widget-Token-Header chybí.
401 WIDGET_TOKEN_INVALID — Token neplatný nebo Origin není v seznamu povolených widgetu.
400 VISITOR_ID_REQUIRED — visitor_id chybí.

Live-Test-Nachweis

Úspěch (200, skutečná generovaná odpověď chatbota) a několik negativních případů (chybějící/neplatný token, chybějící visitor_id) živě ověřeno.

← Chat-widget