POST/api/public/widget/message

Pošlje sporočilo obiskovalca chatbotu in vrne njegov odgovor — osrednja končna točka klepetalnega gradnika.

Avtentikacija in zaščita

Žeton za vdelavo gradnika (glava X-Widget-Token) + seznam dovoljenih izvorov

Idempotentno: Ne

Parametri

widget_code(body, string, obvezno)
message(body, string, obvezno)
visitor_id(body, string, obvezno)— Na strani odjemalca ustvarjen, trajen ID obiskovalca
session_id(body, string)— null ob prvem klicu nove seje pogovora

Primer zahteve

{"widget_code":"...","message":"Pozdravljeni, kaj zmore Zentor App?","visitor_id":"<UUID ali ID, ustvarjen na odjemalcu>"}

Primer odgovora

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

Kode napak

401 WIDGET_TOKEN_MISSING — Manjka glava X-Widget-Token.
401 WIDGET_TOKEN_INVALID — Token ni veljaven ali izvor (Origin) ni na seznamu odobritev gradnika.
400 VISITOR_ID_REQUIRED — visitor_id manjka.

Dokaz testa v živo

Uspeh (200, dejansko ustvarjen odgovor chatbota) in več negativnih primerov (manjkajoč/neveljaven token, manjkajoči visitor_id) je preverjenih v živo.

← Gradnik za klepet