POST/api/public/widget/message

Odošle chatovú správu návštevníka chatbotovi a vráti jeho odpoveď — centrálny koncový bod chatového widgetu.

Autentifikácia a zabezpečenie

Embed token widgetu (hlavička X-Widget-Token) + zoznam povolených pôvodov (Origin)

Idempotentné: Nie

Parametre

widget_code(body, string, povinné)
message(body, string, povinné)
visitor_id(body, string, povinné)— ID návštevníka generované na strane klienta, perzistentné
session_id(body, string)— null pri prvom volaní novej konverzácie

Príklad požiadavky

{"widget_code":"...","message":"Ahoj, čo dokáže Zentor App?","visitor_id":"<UUID alebo ID vygenerované klientom>"}

Príklad odpovede

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

Chybové kódy

401 WIDGET_TOKEN_MISSING — Chýba hlavička X-Widget-Token.
401 WIDGET_TOKEN_INVALID — Token je neplatný alebo pôvod nie je v povolenom zozname widgetu.
400 VISITOR_ID_REQUIRED — Chýba visitor_id.

Dôkaz živého testu

Úspech (200, skutočná generovaná odpoveď chatbota) a viacero negatívnych prípadov (chýbajúci/neplatný token, chýbajúca visitor_id) overené v živom režime.

← Chat widget