POST/api/public/widget/message

Ziyarətçinin chat mesajını chatbot-a göndərir və onun cavabını çatdırır — chat vidjetinin mərkəzi son nöqtəsi.

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)— Müştəri tərəfindən yaradılan, davamlı ziyarətçi ID
session_id(body, string)— null yeni söhbətin ilk çağırışında

Beispiel-Request

{"widget_code":"...","message":"Salam, Zentor App nə edə bilər?","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 — X-Widget-Token-Header yoxdur.
401 WIDGET_TOKEN_INVALID — Token etibarsızdır və ya Origin vidcetin icazə siyahısında deyil.
400 VISITOR_ID_REQUIRED — visitor_id yoxdur.

Live-Test-Nachweis

Uğur (200, real yaradılmış chatbot cavabı) və bir neçə mənfi hal (çatışmayan/etibarsız token, çatışmayan visitor_id) canlı olaraq təsdiqləndi.

← Çat vidceti