POST/api/public/widget/message

Ithumela umyalezo wencoko womndwendwe kwi-chatbot kwaye ibuyisa impendulo yayo — yindawo yokugqibela ephambili ye-widget yencoko.

Ukuqinisekiswa nokhuseleko

Widget embed token (header X-Widget-Token) + uluhlu lwee-origin ezivunyiweyo

Idempotent: Hayi

Iiparamitha

widget_code(body, string, kuyafuneka)
message(body, string, kuyafuneka)
visitor_id(body, string, kuyafuneka)— I-ID yendwendwe eqhubekayo, eveliswe ngasecaleni kwe-client
session_id(body, string)— null ekubizweni kokuqala kwencoko entsha

Umzekelo we-request

{"widget_code":"...","message":"Molo, i-Zentor App ingenza ntoni?","visitor_id":"<UUID okanye i-ID eyenziwe ngumthengi>"}

Umzekelo we-response

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

Iikhowudi zeempazamo

401 WIDGET_TOKEN_MISSING — Intloko ye-X-Widget-Token ayikho.
401 WIDGET_TOKEN_INVALID — Itokheni ayivumelekanga okanye i-Origin ayikho kuluhlu lwabavunyelweyo lwe-widget.
400 VISITOR_ID_REQUIRED — visitor_id ayikho.

Ubungqina bovavanyo oluphilayo

Impumelelo (200, impendulo yokwenene eyenziweyo ye-chatbot) kunye neemeko ezininzi ezingaphumelelanga (itokheni engekho/engavumelekanga, visitor_id engekho) ziqinisekisiwe ngqo.

← Iwijethi yencoko