POST/api/public/widget/message
यह चैट विजेट का केंद्रीय एंडपॉइंट है, जो विज़िटर की चैट संदेश को चैटबॉट को भेजता है और उसके उत्तर को लौटाता है।
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)— क्लाइंट-साइड पर उत्पन्न, स्थायी विज़िटर आईडीsession_id(body, string)— पहली बार नई बातचीत शुरू करने परBeispiel-Request
{"widget_code":"...","message":"नमस्ते, Zentor App क्या कर सकती है?","visitor_id":"<UUID या क्लाइंट-जनरेट 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 अनुपस्थित है।401 WIDGET_TOKEN_INVALID — टोकन अमान्य है या ओरिजिन विजेट की अनुमति सूची में नहीं है।400 VISITOR_ID_REQUIRED — visitor_id अनुपलब्ध है।Live-Test-Nachweis
सफलता (200, वास्तविक जनरेटेड चैटबॉट प्रतिक्रिया) और कई नकारात्मक मामले (गुम/अमान्य टोकन, गैर-मौजूद visitor_id) लाइव सत्यापित किए गए।