POST/api/public/widget/message

Menghantar mesej sembang pengunjung kepada bot sembang dan memberikan jawapan mereka titik akhir pusat widget sembang.

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 pelawat berterusan yang dihasilkan oleh pelanggan
session_id(body, string)— 0 pada panggilan pertama perbualan baru

Beispiel-Request

{"widget_code":"...","message":"Hello, apa yang boleh Zentor App?","visitor_id":"<UUID atau ID yang dihasilkan oleh pelanggan>"}

Beispiel-Response

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

Fehlercodes

401 WIDGET_TOKEN_MISSING — Header token widget X hilang.
401 WIDGET_TOKEN_INVALID — Token tidak sah atau asal tidak dalam senarai perkongsian widget.
400 VISITOR_ID_REQUIRED — ID pelawat hilang.

Live-Test-Nachweis

Kejayaan (200, jawapan chatbot yang dihasilkan secara sebenar) dan beberapa kes negatif (kenalan yang hilang/tidak sah, visitor_id yang hilang) disahkan secara langsung.

← Widget sembang