POST/api/public/widget/message
Nagpapadala ito ng mensahe mula sa bisita patungo sa chatbot at nagbibigay ng sagot nito — ito ang pangunahing endpoint ng widget ng 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)— Client-side na nabubuong, permanenteng ID ng bisita.session_id(body, string)— Null kapag unang ginagamit ang isang bagong pag-uusap.Beispiel-Request
{"widget_code":"...","message":"Kumusta, ano ang mga kayang gawin ng 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 — Ang header na "X-Widget-Token" ay nawawala.401 WIDGET_TOKEN_INVALID — Ang token ay hindi wasto o ang pinanggalingan ay hindi nasa listahan ng mga pinahihintulutang pinagmulan ng widget.400 VISITOR_ID_REQUIRED — Ang `visitor_id` ay nawawala.Live-Test-Nachweis
Na-verify na sa aktwal na paggamit ang mga sumusunod: (200 na matagumpay na tugon mula sa chatbot, at ilang negatibong kaso tulad ng nawawalang/invalid na token, o nawawalang visitor_id).