POST/api/public/widget/message

Mengirimkan pesan chat dari pengunjung ke chatbot dan memberikan responsnya — titik akhir utama dari 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 pengunjung persisten yang dihasilkan di sisi klien
session_id(body, string)— null saat pertama kali membuka percakapan baru

Beispiel-Request

{"widget_code":"...","message":"Halo, apa yang bisa Zentor App?","visitor_id":"<UUID atau ID yang dihasilkan klien>"}

Beispiel-Response

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

Fehlercodes

401 WIDGET_TOKEN_MISSING — Header X-Widget-Token tidak ditemukan.
401 WIDGET_TOKEN_INVALID — Token tidak valid atau Origin tidak ada dalam daftar izin widget.
400 VISITOR_ID_REQUIRED — visitor_id tidak ada.

Live-Test-Nachweis

Keberhasilan (200, respons chatbot yang dihasilkan secara nyata) dan beberapa kasus negatif (token hilang/tidak valid, visitor_id hilang) telah diverifikasi secara langsung.

← Widget Chat