POST/api/public/widget/message
Pošalje chat poruku posjetitelja chatbotu i vraća njegov odgovor — središnja točka chat widgeta.
Auth & Absicherung
Token za ugradnju widgeta (zaglavlje X-Widget-Token) + popis dopuštenih izvora (Origin)
Idempotent: Nein
Parameter
widget_code(body, string, erforderlich)message(body, string, erforderlich)visitor_id(body, string, erforderlich)— Identifikacijski broj posjetitelja, generiran na strani klijenta i koji se pohranjuje trajno.session_id(body, string)— null prilikom prvog pokretanja nove razgovora.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":"idle","products":[]}}Fehlercodes
401 WIDGET_TOKEN_MISSING — Nedostaje zaglavlje X-Widget-Token.401 WIDGET_TOKEN_INVALID — Token je nevažeći ili Origin nije na popisu widgeta koji su odobreni za korištenje.400 VISITOR_ID_REQUIRED — visitor_id nedostaje.Live-Test-Nachweis
Uspeh (200, stvarna generirana odgovora chatbota) i više negativnih slučajeva (nedostajući/nevažeći token, nedostajuća visitor_id) potvrđeno u stvarnom vremenu.