POST/api/public/widget/message

Trimite un mesaj de chat al vizitatorului către chatbot și returnează răspunsul acestuia — punctul final central al widget-ului de chat.

Autentificare și securitate

Token de embed pentru widget (header X-Widget-Token) + listă de origini permise

Idempotent: Nu

Parametri

widget_code(body, string, obligatoriu)
message(body, string, obligatoriu)
visitor_id(body, string, obligatoriu)— ID de vizitator persistent generată de client
session_id(body, string)— null la primul apel al unei conversații noi

Exemplu de cerere

{"widget_code":"...","message":"Bună, ce poate face Zentor App?","visitor_id":"<UUID sau ID generat de client>"}

Exemplu de răspuns

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

Coduri de eroare

401 WIDGET_TOKEN_MISSING — Lipsește antetul X-Widget-Token.
401 WIDGET_TOKEN_INVALID — Tokenul este invalid sau Origin nu se află în lista de aprobare a widget-ului.
400 VISITOR_ID_REQUIRED — lipsește visitor_id.

Dovadă test live

Succes (200, răspuns generat real de chatbot) și mai multe cazuri negative (token lipsă/nevalid, visitor_id lipsă) verificate live.

← Widget de chat