POST/api/public/widget/message

Ithumela umlayezo wengxoxo wesivakatshi ku-chatbot futhi ibuyisa impendulo yayo — i-endpoint eyinhloko ye-chat widget.

Ukuqinisekisa ubuwena lokuvikeleka

I-Embed-Token ye-widget (i-header X-Widget-Token) + uhlu lwama-Origin avunyelweyo

I-idempotent: Hatshi

Amapharamitha

widget_code(body, string, kuyadingeka)
message(body, string, kuyadingeka)
visitor_id(body, string, kuyadingeka)— I-ID yesivakatshi eqhubekayo ekhiqizwe ohlangothini lwe-client
session_id(body, string)— null ekubizweni kokuqala kwengxoxo entsha

Isibonelo sesicelo (request)

{"widget_code":"...","message":"Sawubona, iZentor App ingenzani?","visitor_id":"<UUID kumbe i-ID eyenziwe ngumthengi>"}

Isibonelo sempendulo (response)

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

Amakhodi amaphutha

401 WIDGET_TOKEN_MISSING — I-X-Widget-Token-Header ayikho.
401 WIDGET_TOKEN_INVALID — I-token ayivumelekile kumbe i-origin ayisohlwini lwezivumelwano lwe-widget.
400 VISITOR_ID_REQUIRED — visitor_id ayiphele.

Ubufakazi bokuhlola okuphilayo

Impumelelo (200, impendulo yangempela ekhiqizwe yi-chatbot) lamacala amanengi angaphumelelanga (i-token engekho/engavumelekile, visitor_id engekho) aqinisekiswe bukhoma.

← I-chat widget