POST/api/public/widget/message

பார்வையாளரின் சாட் செய்தியைச் சாட்பாட்டுக்கு அனுப்பி, அதன் பதிலை வழங்குகிறது — சாட் Widget-இன் மைய முனைப்புள்ளி.

அங்கீகாரம் & பாதுகாப்பு

Widget-Embed-Token (Header X-Widget-Token) + Origin அனுமதிப் பட்டியல்

Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை

அளவுருக்கள்

widget_code(body, string, கட்டாயம்)
message(body, string, கட்டாயம்)
visitor_id(body, string, கட்டாயம்)— Client பக்கத்தில் உருவாக்கப்பட்ட, நிலையான பார்வையாளர் ID
session_id(body, string)— புதிய உரையாடலை முதன்முதலில் அழைக்கும்போது null

எடுத்துக்காட்டுக் கோரிக்கை

{"widget_code":"...","message":"வணக்கம், Zentor App என்ன செய்ய முடியும்?","visitor_id":"<UUID அல்லது கிளையன்ட் பக்கத்தில் உருவாக்கப்பட்ட ID>"}

எடுத்துக்காட்டுப் பதில்

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

பிழைக் குறியீடுகள்

401 WIDGET_TOKEN_MISSING — X-Widget-Token-Header இல்லை.
401 WIDGET_TOKEN_INVALID — டோக்கன் செல்லாதது அல்லது Origin Widget-இன் அனுமதிப் பட்டியலில் இல்லை.
400 VISITOR_ID_REQUIRED — visitor_id காணவில்லை.

நேரலைச் சோதனைச் சான்று

வெற்றி (200, உண்மையாக உருவாக்கப்பட்ட சாட்பாட் பதில்) மற்றும் பல எதிர்மறை நிலைகள் (Token இல்லை/செல்லாதது, visitor_id இல்லை) நேரடியாகச் சரிபார்க்கப்பட்டன.

← சாட் விட்ஜெட்