POST/api/public/widget/message

Ithumela umlayezo wengxoxo wesivakashi ku-chatbot futhi ibuyise impendulo yayo — i-endpoint eyinhloko ye-widget yengxoxo.

Ukuqinisekisa ubunikazi nokuvikeleka

I-widget embed token (i-header X-Widget-Token) + uhlu lwama-origin avunyelwe

I-idempotent: Cha

Amapharamitha

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

Isibonelo se-request

{"widget_code":"...","message":"Sawubona, i-Zentor App ingenzani?","visitor_id":"<UUID noma i-ID eyenziwe yiklayenti>"}

Isibonelo se-response

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

Amakhodi amaphutha

401 WIDGET_TOKEN_MISSING — I-header ye-X-Widget-Token ayikho.
401 WIDGET_TOKEN_INVALID — I-Token ayivumelekile noma i-Origin ayikho ohlwini lwemvume lwe-widget.
400 VISITOR_ID_REQUIRED — visitor_id ayikho.

Ubufakazi bokuhlolwa bukhoma

Impumelelo (200, impendulo yangempela ekhiqizwe yi-chatbot) namacala amaningana angemihle (i-token engekho/engavumelekile, visitor_id engekho) kuqinisekiswe bukhoma.

← I-widget yengxoxo