POST/api/public/widget/message
Seolann sé teachtaireacht chat ó úinéir an suíomha chuig an chatbot agus tugann sé freagra an chatbot – is é sin an príomhphointe deiridh de widget chat.
Auth & Absicherung
Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste
Idempotent: Nein
Parameter
widget_code(body, string, erforderlich)message(body, string, erforderlich)visitor_id(body, string, erforderlich)— ID úinéir a ginte ar an gcomhshóisear, agus a chaifeadh a choinneáil.session_id(body, string)— null nuair a fheidhmeadh tú comhrá nua den chéad uair.Beispiel-Request
{"widget_code":"...","message":"Dia duit, cad is féidir le Zentor App?","visitor_id":"<UUID oder client-generierte ID>"}Beispiel-Response
{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}Fehlercodes
401 WIDGET_TOKEN_MISSING — Tá ceannbriú X-Widget-Token-Header caillte.401 WIDGET_TOKEN_INVALID — Tá an tochán seo neamhbhreithniúil nó níl an t-úrscéala san liosta ceadúnas don widget.400 VISITOR_ID_REQUIRED — Tá an ríomhidir úinéara (visitor_id) caillte.Live-Test-Nachweis
Craiceann (200, freagra chatbot a ghintear go díreach) agus roinnt cásanna dian (tocsán fuadh, nó neamhbhailí; teideal úinéir "visitor_id" fuadh). Tá na ceannacháin seo deartha go léir.